Property Reference
==================

Properties registered on ``bpy.types.Object.reactive_surface_fx_display`` (type ``DisplayTargetSettings``).

Activation & Surface
--------------------

.. list-table::
   :header-rows: 1
   :widths: 30 20 50

   * - 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
-------------------------

.. list-table::
   :header-rows: 1
   :widths: 30 20 50

   * - 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
------------------

.. list-table::
   :header-rows: 1
   :widths: 30 20 50

   * - 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
-----------------------

.. list-table::
   :header-rows: 1
   :widths: 30 20 50

   * - 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
------------------------

.. list-table::
   :header-rows: 1
   :widths: 30 20 50

   * - 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.