Skip to main content

​
Overview

The VRStageLighting_AudioLink_Laser class provides AudioLink integration specifically for laser cone effects in VRSL. It creates animated laser beam patterns that react to audio, with extensive control over beam count, thickness, rotation, and scrolling effects. This script is designed for creating dynamic laser show effects that synchronize with music. Namespace: VRSL
Inherits from: UdonSharpBehaviour (in VRChat) or MonoBehaviour (in Unity)
​
enableAudioLink
bool
default:"false"
Enable or disable Audio Link Reaction for this fixture.
​
band
AudioLinkBandState
default:"Bass"
The frequency band of the spectrum to react to. Options: Bass, Low_Mids, High_Mids, Treble
​
delay
int
default:"0"
The level of delay to add to the reaction.
​
bandMultiplier
float
default:"1.0"
Multiplier for the sensitivity of the reaction.
​
enableColorChord
bool
default:"false"
Enable Color Chord tinting of the light emission.

​
General Settings

​
globalIntensity
float
default:"1.0"
Sets the overall intensity of the shader. Good for animating or scripting effects related to intensity. Its max value is controlled by Final Intensity.
​
finalIntensity
float
default:"1.0"
Sets the maximum brightness value of Global Intensity. Good for personalized settings of the max brightness of the shader by other users via UI.
​
lightColorTint
Color
default:"White * 2.0"
The main color of the light.

​
Color Sampling

​
enableColorTextureSampling
bool
default:"false"
Check this box if you wish to sample a separate texture for the color. The color will be influenced by the intensity of the original emission color. The texture is set in the shader itself.
​
traditionalColorTextureSampling
bool
default:"false"
Check this box if you wish to use traditional color sampling instead of white to black conversion.
​
textureSamplingCoordinates
Vector2
default:"(0.5, 0.5)"
The UV coordinates to sample the color from on the texture.
​
enableThemeColorSampling
bool
default:"false"
Check this box if you wish to enable AudioLink Theme colors.
​
themeColorTarget
int
default:"1"
Theme Color to Sample from.

​
Laser Cone Settings

​
coneWidth
float
default:"2.5"
Controls the radius of the laser cone.
​
coneLength
float
default:"8.5"
Controls the length of the laser cone.
​
coneFlatness
float
default:"0.0"
Controls how flat or round the cone is. 0 = circular, higher values = flatter.

​
Laser Rotation Settings

​
coneXRotation
float
default:"0.0"
X rotation offset for cone in degrees.
​
coneYRotation
float
default:"0.0"
Y rotation offset for cone in degrees.
​
coneZRotation
float
default:"0.0"
Z rotation offset for cone in degrees.

​
Laser Beam Settings

​
laserCount
int
default:"14"
Number of laser beams in the cone. Higher values create denser laser patterns.
​
laserThickness
float
default:"0.125"
Controls how thick/thin the lasers are. Lower values create thinner, more precise beams.
​
laserScroll
float
default:"0.0"
Controls the speed of laser scroll animation. Negative values scroll left, positive values scroll right, 0 means no scroll.

​
Mesh Settings

​
objRenderers
MeshRenderer[]
required
The meshes used to make up the light. You need at least 1 mesh in this group for the script to work properly. Supports up to 5 mesh renderers.

​
Public Methods

​
_UpdateInstancedProperties()

Updates all material property blocks with current fixture settings including all laser parameters. 
public void _UpdateInstancedProperties()

​
_UpdateInstancedPropertiesSansAudioLink()

Updates material property blocks without AudioLink functionality enabled. 
public void _UpdateInstancedPropertiesSansAudioLink()

​
_SetProps()

Initializes the MaterialPropertyBlock for this fixture. 
public void _SetProps()

​
Properties (for Udon Scripting)

All public fields have corresponding properties for safe access from Udon scripts:
  • EnableAudioLink - Get/Set AudioLink enabled state
  • ColorChord - Get/Set color chord enabled
  • Band - Get/Set the frequency band
  • Delay - Get/Set the reaction delay
  • BandMultiplier - Get/Set the band multiplier
  • LightColorTint - Get/Set the light color
  • ConeWidth - Get/Set the cone width
  • ConeLength - Get/Set the cone length
  • GlobalIntensity - Get/Set the global intensity
  • FinalIntensity - Get/Set the final intensity
  • ConeFlatness - Get/Set the cone flatness
  • ConeXRotation - Get/Set X rotation
  • ConeYRotation - Get/Set Y rotation
  • ConeZRotation - Get/Set Z rotation
  • LaserCount - Get/Set the number of lasers
  • LaserThickness - Get/Set laser thickness
  • LaserScroll - Get/Set laser scroll speed
  • ColorTextureSampling - Get/Set texture sampling enabled
  • TraditionalColorTextureSampling - Get/Set traditional sampling mode
  • TextureSamplingCoordinates - Get/Set texture sampling coordinates
  • ThemeColorSampling - Get/Set theme color sampling enabled
  • ThemeColorTarget - Get/Set theme color target

​
Usage Example

// Example: Setting up an AudioLink laser effect
VRStageLighting_AudioLink_Laser laser = GetComponent<VRStageLighting_AudioLink_Laser>();

// Enable AudioLink and configure it to react to treble
laser.EnableAudioLink = true;
laser.Band = AudioLinkBandState.Treble;
laser.BandMultiplier = 3.0f;

// Configure laser appearance
laser.LaserCount = 24;
laser.LaserThickness = 0.05f;
laser.LaserScroll = 0.5f; // Scroll to the right

// Set cone shape
laser.ConeWidth = 5.0f;
laser.ConeLength = 3.0f;
laser.ConeFlatness = 0.5f;

// Add some rotation
laser.ConeYRotation = 15.0f;

// Enable color chord
laser.ColorChord = true;

// Apply changes
laser._UpdateInstancedProperties();

​
Creating Dynamic Laser Shows

For more dynamic effects, you can animate properties over time: 
// Example: Rotating laser cone effect
float rotationSpeed = 30.0f; // degrees per second
laser.ConeYRotation += rotationSpeed * Time.deltaTime;
laser._UpdateInstancedProperties();

// Example: Pulsing laser count based on audio
if (laser.EnableAudioLink)
{
    // Laser count will react to audio automatically
    // But you can also script additional effects
    laser.LaserScroll = Mathf.Sin(Time.time) * 0.5f;
    laser._UpdateInstancedProperties();
}

​
Performance Considerations

  • Higher laserCount values increase draw calls and performance cost
  • Very thin lasers (laserThickness < 0.01) may have aliasing issues
  • Combining high laser counts with fast scrolling can be performance intensive

Build docs developers (and LLMs) love

Get started for freeTalk to us