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:

mathutils.Color 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)

diffuse_factor#

Diffuse reflection multiplier

Type:

float in [0, inf], default 1.0

node_tree#

Node tree for node based lights

Type:

NodeTree, (readonly)

specular_factor#

Specular reflection multiplier

Type:

float in [0, inf], default 1.0

transmission_factor#

Transmission light multiplier

Type:

float in [0, inf], default 1.0

type#

Type of light

Type:

enum in Light Type Items, 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

use_shadow#
Type:

boolean, default True

volume_factor#

Volume light multiplier

Type:

float in [0, inf], default 1.0

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#