Property Reference

Properties registered on bpy.types.Object.light_control_display (type DisplayTargetSettings).

Activation & Surface

Property	Type	Description
enabled	Boolean	Master enable/disable toggle for instant with/without simulation comparisons.
evaluation_engine	Enum	Spatial compute device: HYBRID_SPEEDUP (GPU Compute hardware acceleration) or LEGACY_CPU (CPU only fallback).
surface_mode	Enum	Calculation mode: FACES (Faceted Pixels), SMOOTH_VERTICES, or TEXTURE_CANVAS.
canvas_resolution	Enum	Dynamic texture canvas resolution: 512, 1024, 2048, or 4096.
connect_strokes	Boolean	Connect consecutive driver contact points with smooth interpolated brush stamps when using Dynamic Texture Canvas.
gap_size	Float	Procedural pixel gap margin between adjacent faces (0.0 – 0.5).
fill_pixel_gap	Boolean	Fill procedural gaps with physical bezel polygons.
gap_material	Pointer (Material)	Material assigned to filled bezel gaps.
subdivision_level	Integer	Procedural non-destructive subdivision level (0 – 5).
subdivision_method	Enum	Subdivision algorithm: CATMULL_CLARK or SIMPLE.
auto_shade_smooth	Boolean	Automatically applies smooth normals across the display surface.

Drivers & Raycast Sensing

Property	Type	Description
driver_source_type	Enum	How drivers are specified: CHILDREN, COLLECTION, or OBJECT_LIST.
driver_collection	Pointer (Collection)	Target collection when using COLLECTION driver source.
include_hidden_viewport	Boolean	Keeps drivers active when hidden in the 3D Viewport.
include_hidden_render	Boolean	Keeps drivers active during render even when hidden from camera.
raycast_origin	Enum	TARGET_TO_DRIVER or DRIVER_TO_TARGET.
raycast_direction_mode	Enum	FACE_NORMAL, FACE_NORMAL_INVERTED, Fixed axes (+Z, -Z, etc.), TOWARD_DRIVER_CENTER, or CUSTOM_VECTOR.
proximity_radius	Float (Length)	Maximum sensing distance from driver in meters.
falloff_type	Enum	Attenuation curve: SMOOTH, LINEAR, INVERSE_SQUARE, PENETRATION_THICKNESS, STEP, or CUSTOM_CURVE.

Illumination & PBR

Property	Type	Description
emission_strength	Float	Peak emission light intensity of activated contact faces.
unlit_intensity	Float	Standby emission strength of dormant unlit faces.
lit_color_mode	Enum	Color origin: DRIVER, CUSTOM, or TARGET.
lit_material	Pointer (Material)	Custom material used when lit_color_mode is CUSTOM.
inherit_driver_material	Boolean	Transfers Metallic, Roughness, and Base Color from driver.
enable_texture_sampling	Boolean	Enables UV texture color sampling.
texture_source	Enum	PROXIMITY_OBJECT (3D rubber stamp) or DISPLAY_OBJECT (UV reveal).

Physical Transformation

Property	Type	Description
transform_mode	Enum	NONE, CONFORM_DRIVER, PUSH_NORMAL, ROLL_AXIS, SCALE, WAVE_RIPPLE, TURBULENT_NOISE, or CUSTOM_NODES.
conform_blend	Float	Snapping blend factor (0.0 to 1.0) in Conform mode.
max_displacement	Float (Length)	Maximum normal offset in Push mode.
roll_axis	Enum	Rotation axis: X, Y, or Z in Roll mode.
max_rotation_degrees	Float	Maximum rotation angle in degrees.
scale_factor	Float	Scale multiplier upon activation in Scale/Iris mode.
wave_amplitude	Float (Length)	Peak displacement amplitude of wave ripples.
wave_speed	Float	Outward wave propagation speed in m/s.
instance_object	Pointer (Object)	Mesh object used to replace faces.
instance_scale_mode	Enum	UNIFORM, FIT_DIMENSIONS, or FIXED.
instance_only_lit	Boolean	Only displays instanced objects on lit faces.

Persistence & Bake Cache

Property	Type	Description
persistence_mode	Enum	OFF, PHOSPHOR_DECAY, FIXED_TIME, or PERMANENT (Permanent Accumulation).
decay_rate	Float	Exponential fade rate per frame (0.01 – 1.0).
hold_frames	Integer	Fixed duration hold in animation frames.
subframe_samples	Integer	Temporal supersampling steps per frame (1 – 64).
subframe_mode	Enum	AUTO, PEAK, or ACCUMULATE.
cache_directory	String (Path)	Custom directory for on-disk simulation cache.
is_baked	Boolean	Indicates whether simulation data is loaded from disk cache.