Light(ID)

base classes — bpy_struct, ID

subclasses — AreaLight, PointLight, SpotLight, SunLight

class bpy.types.Light(ID)

Light data-block for lighting a scene

animation_data

Animation data for this data-block

Type

AnimData, (readonly)

color

Light color

Type

float array of 3 items in [0, inf], default (1.0, 1.0, 1.0)

cutoff_distance

Distance at which the light influence will be set to 0

Type

float in [0, inf], default 40.0

cycles

Cycles light settings

Type

CyclesLightSettings, (readonly)

distance

Falloff distance - the light is at half the original intensity at this point

Type

float in [0, inf], default 25.0

node_tree

Node tree for node based lights

Type

NodeTree, (readonly)

specular_factor

Specular reflection multiplier

Type

float in [0, 9999], default 1.0

type

Type of light

  • POINT Point, Omnidirectional point light source.

  • SUN Sun, Constant direction parallel ray light source.

  • SPOT Spot, Directional cone light source.

  • AREA Area, Directional area light source.

Type

enum in [‘POINT’, ‘SUN’, ‘SPOT’, ‘AREA’], default ‘POINT’

use_custom_distance

Use custom attenuation distance instead of global light threshold

Type

boolean, default False

use_nodes

Use shader nodes to render the light

Type

boolean, default False

classmethod bl_rna_get_subclass(id, default=None)
Parameters

id (string) – The RNA type identifier.

Returns

The RNA type or default when not found.

Return type

bpy.types.Struct subclass

classmethod bl_rna_get_subclass_py(id, default=None)
Parameters

id (string) – The RNA type identifier.

Returns

The class or default when not found.

Return type

type

Inherited Properties

Inherited Functions

References