Skip to content

VRSL GI (DMX): The GI Manager Script

AcChosen edited this page May 21, 2024 · 4 revisions

The VRSL GI Manager Script

The VRSL GI Manager Script is the heart of the VRSL GI system. It sends all the necessary GI data to the correct shaders and keeps track of the current status of all GI-enabled fixtures in the scene. It is also where global settings like setting the Max Light Count live as well as simple toggles for the system as a whole. Here is a comprehensive list of all the functions/variables for the GI Manager Script

Variables and Functions

  • Enable GI - A global toggle for the GI system. Disabling this will stop updating all the GI information. The GI system will still be rendering though, so be warned.

  • Volume Size - Sets the size of the volume that the manager covers. Any VRSL GI lights outside of this cube will not be rendered! Make sure to increase this value and place the manager in the center of where you want your lights to render!

  • Light Data Texture - This is the data texture where the GI information is written to.
  • Clustering Texture - This is the data texture where the clustering algorithms are done. Created by z3y!.
  • Get All GI Lights - Gets a reference of all VRSL GI Fixtures in a scene and stores it into its array. Hit this button each time you add or remove a fixture.
  • Force Update GI Texture - If you made a change to a VRSL GI Fixture and you can't see the changes, hit this button to force the data textures to update!
  • Enable/Disable Cluster Debugging - This enables/disables debug mode for all VRSL GI compatible shaders in your scene. It displays a voxel displaying which pixels on a mesh are being affected by a light. The bright the pixel, the more GI lights are affecting that area. Try to make sure not too many lights are affecting the same area if possible for maximum performance!
  • Global Offset - Apply a global point offset to all VRSL GI Fixtures in the scene. This option simply applies edits to the offset parameter on each VRSL GI Fixture. It's good for giving you a nice baseline offset to start with.
  • Global Intensity - Apply a global intensity value to all VRSL GI Fixtures in the scene. This option simply applies edits to the intensity parameter on each VRSL GI Fixture. It's good for giving you a nice baseline intensity to start with.
  • Number of GI Lights - The current number of VRSL GI Fixtures. Updates in play mode.
  • Light Index *N* - This is the list of VRSL GI Fixture scripts the manager has found in the scene.

When there is a light entry, you can see some information about the light in the list at the bottom of the manager for each light, including information about its pan/tilt status, intensity, dmx channel, transform, and more!