Skip to main content

Creating Effects with Virtual Dimmer Fixtures

When working with fixtures that use a virtual dimmer (VDIM), effects require special configuration to work properly. This guide explains how to set up effects for virtual dimmer fixtures and verify they're working correctly.

Ian Peterson avatar
Written by Ian Peterson
Updated over 2 weeks ago

Understanding Virtual Dimmers

Virtual dimmers work differently than traditional dimmer channels. Since RGB fixtures don't have a physical dimmer parameter, a virtual dimmer scales the RGB values to create the dimming effect. This means:

  • The level parameter won't automatically control virtual dimmer fixtures in effects

  • You need to explicitly set the Virtual Dimmer value in each effect step

  • Changes appear in the RGB values rather than a dimmer channel

Setting Up Effects with Virtual Dimmers

To create an effect with a virtual dimmer fixture:

  1. Open your effect and navigate to each step

  2. Go to Light Settings for each step

  3. Manually adjust the Virtual Dimmer value (don't rely on the level parameter)

  4. Repeat for all steps in your effect

Important: Make sure the Virtual Dimmer is fully set to on/off in each step—partial settings may cause the effect to not work as expected.

Verifying Your Effect is Working

Since virtual dimmers don't show changes in the normal viewstate pillbox, you need to check the actual output values:

Method 1: Use OUTPUT - VALUE Viewstate

  1. Switch to OUTPUT - VALUE viewstate (Drop down menu at the top)

  2. Watch the RGB values in the pillbox—they should change as the effect runs

  3. The dimmer will show "--" (this is expected since there's no physical dimmer channel)

Method 2: Check Table View

  1. Open Table View

  2. Set viewstate to OUTPUT - VALUE

  3. Monitor the RGB value columns—you should see them scaling up and down with the virtual dimmer

Method 3: Use LivePlot

LivePlot can visualize virtual dimmer effects even without physical fixtures connected:

  1. Open LivePlot

  2. Run your effect

  3. Watch the fixtures respond in the visualization

This is particularly useful when programming effects away from your actual lighting rig.


Troubleshooting

Effect doesn't appear to be running:

  • Verify you've set the Virtual Dimmer (not just intensity) in Light Settings for each step

  • Check OUTPUT - VALUE viewstate instead of the normal viewstate

  • Use sliders instead of typing values if experiencing issues on older iOS versions

Pillbox shows "--":

  • This is normal behavior for virtual dimmer fixtures

  • Switch to OUTPUT - VALUE viewstate and check RGB values instead

Still not working:

  • Test with actual output or LivePlot to confirm

  • Ensure you're on the latest version of Blackout

  • Update to the latest iOS version

Performance Note

While OUTPUT - VALUE viewstate is excellent for programming and troubleshooting effects, avoid staying in this viewstate during live shows as it can affect console performance depending on your show complexity.

Need More Help?

For technical troubleshooting questions, use the "Technical Troubleshooting" option in the support chat for instant answers from Patch!

Did this answer your question?