AreaLight(Light)

base classes — bpy_struct, ID, Light

class bpy.types.AreaLight(Light)

Directional area Light

constant_coefficient

Constant distance attenuation coefficient

Type:float in [0, inf], default 0.0
contact_shadow_bias

Bias to avoid self shadowing

Type:float in [0.001, 9999], default 0.03
contact_shadow_distance

World space distance in which to search for screen space occluder

Type:float in [0, 9999], default 0.2
contact_shadow_soft_size

Control how soft the contact shadows will be

Type:float in [0, 9999], default 0.2
contact_shadow_thickness

Pixel thickness used to detect occlusion

Type:float in [0, 9999], default 0.2
energy

Amount of light emitted

Type:float in [-inf, inf], default 10.0
falloff_curve

Custom light falloff curve

Type:CurveMapping, (readonly)
falloff_type

Intensity Decay with distance

Type:enum in [‘CONSTANT’, ‘INVERSE_LINEAR’, ‘INVERSE_SQUARE’, ‘INVERSE_COEFFICIENTS’, ‘CUSTOM_CURVE’, ‘LINEAR_QUADRATIC_WEIGHTED’], default ‘CONSTANT’
linear_attenuation

Linear distance attenuation

Type:float in [0, 1], default 0.0
linear_coefficient

Linear distance attenuation coefficient

Type:float in [0, inf], default 0.0
quadratic_attenuation

Quadratic distance attenuation

Type:float in [0, 1], default 0.0
quadratic_coefficient

Quadratic distance attenuation coefficient

Type:float in [0, inf], default 0.0
shadow_buffer_bias

Bias for reducing self shadowing

Type:float in [0.001, 9999], default 1.0
shadow_buffer_bleed_bias

Bias for reducing light-bleed on variance shadow maps

Type:float in [0, 1], default 0.0
shadow_buffer_clip_end

Shadow map clip end, beyond which objects will not generate shadows

Type:float in [1e-06, inf], default 40.0
shadow_buffer_clip_start

Shadow map clip start, below which objects will not generate shadows

Type:float in [1e-06, inf], default 0.05
shadow_buffer_exp

Bias for reducing light-bleed on exponential shadow maps

Type:float in [1, 9999], default 2.5
shadow_buffer_samples

Number of shadow buffer samples

Type:int in [1, 16], default 0
shadow_buffer_size

Resolution of the shadow buffer, higher values give crisper shadows but use more memory

Type:int in [128, 10240], default 0
shadow_buffer_soft

Size of shadow buffer sampling area

Type:float in [0, 100], default 3.0
shadow_color

Color of shadows cast by the light

Type:float array of 3 items in [0, inf], default (0.0, 0.0, 0.0)
shadow_soft_size

Light size for ray shadow sampling (Raytraced shadows)

Type:float in [0, inf], default 0.25
shape

Shape of the area Light

Type:enum in [‘SQUARE’, ‘RECTANGLE’, ‘DISK’, ‘ELLIPSE’], default ‘SQUARE’
size

Size of the area of the area light, X direction size for rectangle shapes

Type:float in [0, inf], default 0.25
size_y

Size of the area of the area light in the Y direction for rectangle shapes

Type:float in [0, inf], default 0.25
use_contact_shadow

Use screen space raytracing to have correct shadowing near occluder, or for small features that does not appear in shadow maps

Type:boolean, default False
use_shadow
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