SpotLight(Light)

base classes — bpy_struct, ID, Light

class bpy.types.SpotLight(Light)

Directional cone Light

energy

The energy this light would emit over its entire area if it wasn’t limited by the spot angle, in units of radiant power (W) (in [-inf, inf], default 10.0)

Type:

float

shadow_buffer_clip_start

Shadow map clip start, below which objects will not generate shadows (in [1e-06, inf], default 0.05)

Type:

float

shadow_filter_radius

Blur shadow aliasing using Percentage Closer Filtering (in [0, inf], default 1.0)

Type:

float

shadow_jitter_overblur

Apply shadow tracing to each jittered sample to reduce under-sampling artifacts (in [0, 100], default 10.0)

Type:

float

shadow_maximum_resolution

Minimum size of a shadow map pixel. Higher values use less memory at the cost of shadow quality. (in [0, inf], default 0.001)

Type:

float

shadow_soft_size

Light size for ray shadow sampling (Raytraced shadows) (in [0, inf], default 0.0)

Type:

float

show_cone

Display transparent cone in 3D view to visualize which objects are contained in it (default False)

Type:

bool

spot_blend

The softness of the spotlight edge (in [0, 1], default 0.15)

Type:

float

spot_size

Angular diameter of the spotlight beam (in [0.0174533, 3.14159], default 0.785398)

Type:

float

use_absolute_resolution

Limit the resolution at 1 unit from the light origin instead of relative to the shadowed pixel (default False)

Type:

bool

use_shadow_jitter

Enable jittered soft shadows to increase shadow precision (disabled in viewport unless enabled in the render settings). Has a high performance impact. (default False)

Type:

bool

use_soft_falloff

Apply falloff to avoid sharp edges when the light geometry intersects with other objects (default True)

Type:

bool

use_square

Cast a square spot light shape (default False)

Type:

bool

inline_shader_nodes()

Get the inlined shader nodes of this light. This preprocesses the node tree to remove nested groups, repeat zones and more.

Returns:

The inlined shader nodes.

Return type:

bpy.types.InlineShaderNodes

classmethod bl_rna_get_subclass(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (bpy.types.Struct | None) – The value to return when not found.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct

classmethod bl_rna_get_subclass_py(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (type | None) – The value to return when not found.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties

Inherited Functions