Local UI Control Panel Component

Central control system for VRSL quality settings, intensity, and rendering modes

The VRSL_LocalUIControlPanel component is the central management system for VR Stage Lighting. It provides user-accessible controls for quality modes, intensity levels, DMX/AudioLink configuration, and rendering settings for all fixtures in the scene.

Overview

This component acts as the hub for VRSL configuration, managing:

• Quality modes for volumetric, projection, disco ball, and lens flare effects
• Intensity sliders for different fixture types
• DMX grid mode selection (Horizontal/Vertical/Legacy)
• AudioLink enable/disable
• Global strobe control
• Video sampling texture assignment
• Material property synchronization

Inspector Properties

Quality Modes

volumetricQuality · VolumetricQualityModes · default: "High"

Quality mode for volumetric cone effects:

• High: Transparent blending, highest quality
• Medium: Transparent with optimized sampling
• Low: Alpha cutout, best performance

lockVolumetricQualityMode · bool · default: "false"

Prevents users from changing volumetric quality. Useful for world optimization.

blinderProjectionQuality · DefaultQualityModes · default: "High"

Quality mode for blinder projection effects:

• High: Transparent blending
• Low: Alpha cutout

lockBlinderProjectionQualityMode · bool · default: "false"

Prevents users from changing blinder projection quality.

parProjectionQuality · DefaultQualityModes · default: "High"

Quality mode for PAR light projection effects:

• High: Transparent blending
• Low: Alpha cutout

lockParProjectionQualityMode · bool · default: "false"

Prevents users from changing PAR projection quality.

otherProjectionQuality · DefaultQualityModes · default: "High"

Quality mode for other projection effects (moving heads, spots):

• High: Transparent blending
• Low: Alpha cutout

lockOtherProjectionQualityMode · bool · default: "false"

Prevents users from changing other projection quality.

discoballQuality · DefaultQualityModes · default: "High"

Quality mode for disco ball reflection effects:

• High: Transparent blending
• Low: Alpha cutout

lockDiscoballQualityMode · bool · default: "false"

Prevents users from changing disco ball quality.

lensFlareQuality · DefaultQualityModes · default: "High"

Quality mode for lens flare effects:

• High: Transparent blending
• Low: Alpha cutout

lockLensFlareQualityMode · bool · default: "false"

Prevents users from changing lens flare quality.

Video Sampling

videoSampleTargetTexture · Texture

Optional texture for video sampling. When assigned, fixtures can sample colors from this texture for video-reactive effects.

Materials

fixtureMaterials · Material[]

Array of all fixture materials in the scene. Used for intensity and property updates.

volumetricMaterials · Material[]

Array of all volumetric cone materials. Used for quality mode and intensity updates.

projectionMaterials · Material[]

Array of all projection materials. Used for quality mode and intensity updates.

discoBallMaterials · Material[]

Array of all disco ball materials. Used for quality mode and intensity updates.

laserMaterials · Material[]

Array of all laser materials. Used for intensity updates.

Post Processing

bloomAnimator · Animator

Optional reference to bloom post-processing animator for bloom intensity control.

UI Sliders

masterSlider · UnityEngine.UI.Slider

Master intensity slider. Controls maximum intensity for all fixture types.

fixtureSlider · UnityEngine.UI.Slider

Fixture intensity slider. Controls brightness of fixture body meshes.

volumetricSlider · UnityEngine.UI.Slider

Volumetric intensity slider. Controls brightness of volumetric cone effects.

projectionSlider · UnityEngine.UI.Slider

Projection intensity slider. Controls brightness of light projections.

discoBallSlider · UnityEngine.UI.Slider

Disco ball intensity slider. Controls brightness of disco ball reflections.

laserSlider · UnityEngine.UI.Slider

Laser intensity slider. Controls brightness of laser effects.

bloomSlider · UnityEngine.UI.Slider

Bloom intensity slider. Controls post-processing bloom effect strength.

[type]SliderText · UnityEngine.UI.Text

Text components for displaying slider percentages. One for each slider type.

fixtureIntensityMax · float · default: "1.0"

Maximum intensity value for fixture meshes. Set by master slider.

volumetricIntensityMax · float · default: "1.0"

Maximum intensity value for volumetric effects. Set by master slider.

projectionIntensityMax · float · default: "1.0"

Maximum intensity value for projections. Set by master slider.

discoballIntensityMax · float · default: "1.0"

Maximum intensity value for disco balls. Set by master slider.

laserIntensityMax · float · default: "1.0"

Maximum intensity value for lasers. Set by master slider.

UI Toggles and Buttons

volumetricNoiseToggle · UnityEngine.UI.Toggle

Toggle for volumetric noise effect. Disable for better performance on low-end systems.

volumetricHighButton · UnityEngine.UI.Button

Button to set volumetric quality to High mode.

volumetricMedButton · UnityEngine.UI.Button

Button to set volumetric quality to Medium mode.

volumetricLowButton · UnityEngine.UI.Button

Button to set volumetric quality to Low mode.

globalStrobeToggleButton · UnityEngine.UI.Button

Button to globally enable/disable strobe effects. Useful for photosensitivity.

DMX Configuration

isUsingDMX · bool · default: "true"

Enable DMX fixture control. Set to false if only using AudioLink.

isUsingAudioLink · bool · default: "true"

Enable AudioLink fixture control. Set to false if only using DMX.

DMXMode · int · default: "0"

DMX grid mode selection:

• 0: Horizontal Mode (~1560 channels, 3 universes)
• 1: Vertical Mode (~871 channels, 1.7 universes)
• 2: Legacy Mode (original sector-based)

useExtendedUniverses · bool · default: "false"

Enable 9-universe RGB mode for expanded color control.

delayStrobeForGI · bool · default: "true"

Delays strobe output for global illumination baking. Recommended to keep enabled.

DMX_CRTS_Horizontal · CustomRenderTexture[]

Array of Custom Render Textures for horizontal DMX mode. Auto-populated by VRSL setup.

DMX_CRTS_Vertical · CustomRenderTexture[]

Array of Custom Render Textures for vertical DMX mode. Auto-populated by VRSL setup.

DMX_CRTS_Legacy · CustomRenderTexture[]

Array of Custom Render Textures for legacy DMX mode. Auto-populated by VRSL setup.

AudioLink_CRTs · CustomRenderTexture[]

Array of Custom Render Textures for AudioLink mode. Auto-populated by VRSL setup.

Advanced Settings

sperateInGameInterpolationSpeed · bool · default: "true"

Reduces interpolation speed in-game for more responsive DMX control.

inGameInterpolationModifier · float · default: "1.55"

Multiplier for in-game interpolation reduction when sperateInGameInterpolationSpeed is enabled.

outputDebugLogs · bool · default: "false"

Enables debug logging to console. Useful for troubleshooting.

VolumetricNoise · bool · default: "true"

Property for controlling volumetric noise effect. Automatically disabled on mobile platforms.

RequireDepthLight · bool · default: "true"

Requires depth-based lighting for volumetric effects. Automatically disabled on mobile platforms.

GlobalDisableStrobe · bool · default: "false"

Property for globally disabling strobe effects. Useful for photosensitive users.

Configuration Steps

Initial Setup

1. Add VRSL_LocalUIControlPanel component to a persistent GameObject
2. Populate material arrays:
   • Drag all fixture materials to fixtureMaterials
   • Drag all volumetric materials to volumetricMaterials
   • Drag all projection materials to projectionMaterials
   • Drag all disco ball materials to discoBallMaterials
   • Drag all laser materials to laserMaterials
3. Assign DMX Custom Render Texture arrays (auto-populated by VRSL prefab)
4. Assign AudioLink Custom Render Texture array (auto-populated by VRSL prefab)

UI Connection

1. Create Canvas with UI sliders and buttons
2. Assign slider components to corresponding fields
3. Assign text components for percentage display
4. Configure slider OnValueChanged events:
   • Master Slider → _SetFinalIntensity()
   • Fixture Slider → _SetFixtureIntensity()
   • Volumetric Slider → _SetVolumetricIntensity()
   • Projection Slider → _SetProjectionIntensity()
   • Disco Ball Slider → _SetDiscoBallIntensity()
   • Laser Slider → _SetLaserIntensity()
   • Bloom Slider → _SetBloomIntensity()
5. Configure button OnClick events:
   • Volumetric High → _SetVolumetricHigh()
   • Volumetric Med → _SetVolumetricMed()
   • Volumetric Low → _SetVolumetricLow()
   • Global Strobe Toggle → _ToggleGlobalStrobe()

Quality Mode Lock Setup

To prevent users from changing quality settings:

1. Set desired quality modes
2. Enable corresponding lock booleans:
   • lockVolumetricQualityMode
   • lockBlinderProjectionQualityMode
   • lockParProjectionQualityMode
   • lockOtherProjectionQualityMode
   • lockDiscoballQualityMode
   • lockLensFlareQualityMode
3. Buttons will be visually disabled and non-interactive

Public Methods

Quality Mode Methods

_SetVolumetricHigh() · void

Sets volumetric quality to High mode (if not locked).

_SetVolumetricMed() · void

Sets volumetric quality to Medium mode (if not locked).

_SetVolumetricLow() · void

Sets volumetric quality to Low mode (if not locked).

_SetProjectionBlindersHigh() · void

Sets blinder projection quality to High.

_SetProjectionBlindersLow() · void

Sets blinder projection quality to Low.

_SetProjectionParsHigh() · void

Sets PAR projection quality to High.

_SetProjectionParsLow() · void

Sets PAR projection quality to Low.

_SetProjectionOtherHigh() · void

Sets other projection quality to High.

_SetProjectionOtherLow() · void

Sets other projection quality to Low.

_SetDiscoballHigh() · void

Sets disco ball quality to High.

_SetDiscoballLow() · void

Sets disco ball quality to Low.

_SetLensFlareHigh() · void

Sets lens flare quality to High.

_SetLensFlareLow() · void

Sets lens flare quality to Low.

_UpdateAllQualityModes() · void

Forces update of all quality modes. Useful after loading settings.

Intensity Methods

_SetFinalIntensity() · void

Sets master intensity for all fixture types. Called by master slider.

_SetFixtureIntensity() · void

Sets intensity for fixture body meshes. Updates _UniversalIntensity shader property.

_SetVolumetricIntensity() · void

Sets intensity for volumetric cone effects.

_SetProjectionIntensity() · void

Sets intensity for light projections.

_SetDiscoBallIntensity() · void

Sets intensity for disco ball reflections.

_SetLaserIntensity() · void

Sets intensity for laser effects.

_SetBloomIntensity() · void

Sets bloom post-processing intensity via animator (if assigned).

DMX Control Methods

_CheckDMX() · void

Updates DMX Custom Render Texture state based on current mode. Enables active mode CRTs and disables others.

_SetDMXHorizontal() · void

Switches to Horizontal DMX mode (if DMX is enabled).

_SetDMXVertical() · void

Switches to Vertical DMX mode (if DMX is enabled).

_SetDMXLegacy() · void

Switches to Legacy DMX mode (if DMX is enabled).

_CheckAudioLink() · void

Enables or disables AudioLink Custom Render Textures based on isUsingAudioLink.

_CheckkExtendedUniverses() · void

Updates 9-universe mode setting on all DMX CRT materials.

Other Methods

_ToggleGlobalStrobe() · void

Toggles global strobe disable on/off. Updates all DMX strobe textures.

_ForceUpdateVideoSampleTexture() · void

Updates _SamplingTexture property on all materials with videoSampleTargetTexture.

_CheckDepthLightStatus() · void

Updates depth light and volumetric noise settings on all materials.

Example Setup

Basic Control Panel

Quality Modes:
  volumetricQuality: High
  blinderProjectionQuality: High
  parProjectionQuality: Medium
  otherProjectionQuality: High
  discoballQuality: Medium
  
DMX Configuration:
  isUsingDMX: true
  isUsingAudioLink: true
  DMXMode: 1 (Vertical)
  useExtendedUniverses: false

Performance-Optimized Setup

Quality Modes:
  volumetricQuality: Low
  lockVolumetricQualityMode: true
  blinderProjectionQuality: Low
  lockBlinderProjectionQualityMode: true
  parProjectionQuality: Low  
  lockParProjectionQualityMode: true
  otherProjectionQuality: Low
  lockOtherProjectionQualityMode: true
  discoballQuality: Low
  lockDiscoballQualityMode: true
  
Advanced:
  VolumetricNoise: false
  RequireDepthLight: false

Quest-Optimized Setup

Quality Modes:
  All quality modes: Low
  All lock modes: true
  
Advanced:
  VolumetricNoise: false (auto-disabled on Quest)
  RequireDepthLight: false (auto-disabled on Quest)
  
DMX:
  useExtendedUniverses: false
  DMXMode: 1 (Vertical, fewer channels)

Integration with Other Components

DMX Fixtures

The Control Panel manages DMX rendering for all VRStageLighting_DMX_Static components:

• Enables/disables DMX Custom Render Textures
• Switches between Horizontal/Vertical/Legacy grid modes
• Controls global strobe disable
• Sets material intensity properties

AudioLink Fixtures

Manages AudioLink for all VRStageLighting_AudioLink_Static components:

• Enables/disables AudioLink Custom Render Textures
• Sets material intensity properties
• Manages quality modes for AudioLink effects

Grid Reader

The active DMX mode determines which grid textures are used:

• DMXMode = 0: Uses DMX_CRTS_Horizontal textures
• DMXMode = 1: Uses DMX_CRTS_Vertical textures
• DMXMode = 2: Uses DMX_CRTS_Legacy textures

Grid Reader populates these textures with OSC data.

Performance Optimization

Quality Mode Impact

High Quality (Transparent):

• Best visual quality
• Requires alpha blending
• Higher fill rate cost
• Recommended for PC

Low Quality (Alpha Cutout):

• Good visual quality
• Uses alpha testing
• Better performance
• Recommended for Quest

Material Arrays

The component updates materials in batches:

• Iterates through material arrays
• Sets shader properties via Material.SetFloat/SetInt/SetTexture
• Occurs only when settings change
• No per-frame overhead

Custom Render Textures

Disabled CRTs stop updating:

• Inactive DMX modes: UpdateMode = OnDemand
• Active DMX mode: UpdateMode = Realtime
• Saves significant GPU time
• Only one grid mode active at once

Mobile Platform Handling

On Android and iOS (Quest):

• VolumetricNoise automatically disabled
• RequireDepthLight automatically disabled
• Quality modes should be set to Low
• Use lock booleans to prevent user changes

See Also

• DMX Static Component - DMX fixture control
• AudioLink Static Component - AudioLink fixture control
• Grid Reader - OSC data reception