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)

Type

float in [-inf, inf], default 10.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_filter_radius

Blur shadow aliasing using Percentage Closer Filtering

Type

float in [0, inf], default 1.0

shadow_jitter_overblur

Apply shadow tracing to each jittered sample to reduce under-sampling artifacts

Type

float in [0, 100], default 10.0

shadow_maximum_resolution

Minimum size of a shadow map pixel. Higher values use less memory at the cost of shadow quality.

Type

float in [0, inf], default 0.001

shadow_soft_size

Light size for ray shadow sampling (Raytraced shadows)

Type

float in [0, inf], default 0.0

show_cone

Display transparent cone in 3D view to visualize which objects are contained in it

Type

boolean, default False

spot_blend

The softness of the spotlight edge

Type

float in [0, 1], default 0.15

spot_size

Angle of the spotlight beam

Type

float in [0.0174533, 3.14159], default 0.785398

use_absolute_resolution

Limit the resolution at 1 unit from the light origin instead of relative to the shadowed pixel

Type

boolean, default False

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.

Type

boolean, default False

use_soft_falloff

Apply falloff to avoid sharp edges when the light geometry intersects with other objects

Type

boolean, default True

use_square

Cast a square spot light shape

Type

boolean, default False

classmethod bl_rna_get_subclass(id, default=None, /)

Parameters

id (str) – 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 (str) – The RNA type identifier.

Returns

The class or default when not found.

Return type

type

Inherited Properties

bpy_struct.id_data ID.name ID.name_full ID.id_type ID.session_uid ID.is_evaluated ID.original ID.users ID.use_fake_user ID.use_extra_user ID.is_embedded_data ID.is_missing ID.is_runtime_data ID.is_editable ID.tag ID.is_library_indirect ID.library ID.library_weak_reference ID.asset_data ID.override_library

ID.preview Light.type Light.use_temperature Light.color Light.temperature Light.temperature_color Light.specular_factor Light.diffuse_factor Light.transmission_factor Light.volume_factor Light.use_custom_distance Light.cutoff_distance Light.use_shadow Light.exposure Light.normalize Light.node_tree Light.use_nodes Light.animation_data Light.cycles

Inherited Functions

bpy_struct.as_pointer bpy_struct.driver_add bpy_struct.driver_remove bpy_struct.get bpy_struct.id_properties_clear bpy_struct.id_properties_ensure bpy_struct.id_properties_ui bpy_struct.is_property_hidden bpy_struct.is_property_overridable_library bpy_struct.is_property_readonly bpy_struct.is_property_set bpy_struct.items bpy_struct.keyframe_delete bpy_struct.keyframe_insert bpy_struct.keys bpy_struct.path_from_id bpy_struct.path_resolve bpy_struct.pop bpy_struct.property_overridable_library_set bpy_struct.property_unset bpy_struct.rna_ancestors bpy_struct.type_recast bpy_struct.values

ID.bl_system_properties_get ID.rename ID.evaluated_get ID.copy ID.asset_mark ID.asset_clear ID.asset_generate_preview ID.override_create ID.override_hierarchy_create ID.user_clear ID.user_remap ID.make_local ID.user_of_id ID.animation_data_create ID.animation_data_clear ID.update_tag ID.preview_ensure ID.bl_rna_get_subclass ID.bl_rna_get_subclass_py Light.area Light.bl_rna_get_subclass Light.bl_rna_get_subclass_py