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