Instruments

• Generic Instrument
• Par
• MovingHead
• Strobe
• External In

The drop-down menu in the top-left corner of every instrument is used to select the fixture tag group the instrument device will control. The menu is populated with all available tags assigned to fixtures in Beam's Fixture Patch.

Generic Instrument

---

While the Par, MovingHead, and Strobe devices are designed to control specific fixture types (and also serve as building blocks for custom instruments - see Building new plugins), Generic Instrument offers an out-of-the-box solution for working with a wide range of fixtures, regardless of their parameters.

Main Controls

This section contains the Tag Group Selector, as well as Intensity and Color controls for the selected tag group.

Parameters

• Intensity: direct control of the dim parameter of all the fixtures in the selected tag group.
• HSL/RGB: direct control of the red, green, blue and optionally white, or cyan, magenta and yellow parameters of all the fixtures in the selected tag group. Click the HSL button to switch to RGB mode. Click the color box to pop up a color chooser to visually select a color.

Parameter Controls

Parameters (1-16)

• Parameter: a dropdown menu that allows you to select a modulation parameter to control with the corresponding Value.
• Value: sets a value between 0.0 and 1.0 for the selected modulation parameter.

Envelopes

Generic Instrument comes with two envelopes, which can each be mapped to a different modulation parameter within the selected fixture tag group.

Parameters

• Attack: the attack in beats of incoming notes. The time it takes for the selected modulation parameter to move up to gain after receiving a note on. The value of the modulation parameter will stay at Gain until the instrument receives a note off.
• Release: the release in beats of incoming notes. The time it takes for the selected modulation parameter to go back to zero after receiving a note off.
• Gain: the maximum value that the envelope for the selected modulation parameter reaches.
• Int < Vel: toggles whether the intensity of the envelope for the selected modulation parameter is controlled by the note velocity.

Controlling individual fixtures or groups of fixtures in a tag

With the Generic Instrument you can control individual fixtures or groups of fixtures within the selected tag by assigning the same modulation parameter to multiple Parameter slots. The number of Parameter slots with the same modulation parameter is distributed across the number of fixtures in a tag:

• If you select a tag with 10 fixtures and have 10 Parameter slots for a modulation parameter, each Parameter slot will control 1 fixture.
• If you select a tag with 10 fixtures and have 2 Parameter slots for a modulation parameter, each Parameter slot will control 5 fixtures.
• If you select a tag with 10 fixtures and have 5 Parameter slots for a modulation parameter, each Parameter slot will control 2 fixtures.

Choosing Color

The color controls allow you to select a color that is not fully bright, in theory you can select a color that is black. Note that this will affect the total intensity of the fixture, meaning that the dim envelope can have a lower maximum if the darkness bar in the color chooser is not set to be fully bright:

Par

---

Par is the most basic instrument, supporting intensity and color control. Color control typically only applies to LED PARs.

Main Controls

This section contains the Tag Group Selector, as well as Intensity and Color controls for the selected tag group.

Parameters

• Intensity: direct control of the dim parameter of all the fixtures in the selected tag group.
• HSL/RGB: direct control of the red, green, blue and optionally white, or cyan, magenta and yellow parameters of all the fixtures in the selected tag group. Click the HSL button to switch to RGB mode. Click the color box to pop up a color chooser to visually select a color.

Envelope

The envelope is mapped to dim.

Parameters

• Attack: the attack in beats of incoming notes. The time it takes for dim to move up to gain after receiving a note on. dim will stay at gain until the instrument receives a note off.
• Release: the release in beats of incoming notes. The time it takes for dim to go back to zero after receiving a note off.
• Gain: the maximum value that the dim envelope reaches.
• Int < Vel: toggles whether the intensity of the dim envelope is controlled by the note velocity.

MovingHead

---

In addition to intensity and color, MovingHead also supports controlling movement parameters pan and tilt.

Main Controls

This section contains the Tag Group Selector, as well as Intensity and Color controls for the selected tag group.

Parameters

• Intensity: direct control of the dim parameter of all the fixtures in the selected tag group.
• Pan: direct control of the pan parameter of all the fixtures in the selected tag group. This controls the horizontal rotation of a moving head.
• Tilt: direct control of the tilt parameter of all the fixtures in the selected tag group. This controls the vertical rotation of a moving head.
• HSL/RGB: direct control of the red, green, blue and optionally white, or cyan, magenta and yellow parameters of all the fixtures in the selected tag group. Click the HSL button to switch to RGB mode. Click the color box to pop up a color chooser to visually select a color.

Envelope

The envelope is mapped to dim.

Parameters

• Attack: the attack in beats of incoming notes. The time it takes for dim to move up to gain after receiving a note on. dim will stay at gain until the instrument receives a note off.
• Release: the release in beats of incoming notes. The time it takes for dim to go back to zero after receiving a note off.
• Gain: the maximum value that the dim envelope reaches.
• Int < Vel: toggles whether the intensity of the dim envelope is controlled by the note velocity.

Strobe

---

In addition to intensity and color, Strobe supports controlling strobe-specific parameters stroberate and strobeduration. The color control usually only applies to LED strobes.

Main Controls

This section contains the Tag Group Selector, as well as Intensity and Color controls for the selected tag group.

Parameters

• Intensity: direct control of the dim parameter of all the fixtures in the selected tag group.
• Rate: direct control of the stroberate parameter of all the fixtures in the selected tag group. This controls how frequently the strobe flashes.
• Duration: direct control of the strobeduration parameter of all the fixtures in the selected tag group. This controls the duration of each flash.
• HSL/RGB: direct control of the red, green, blue and optionally white, or cyan, magenta and yellow parameters of all the fixtures in the selected tag group. Click the HSL button to switch to RGB mode. Click the color box to pop up a color chooser to visually select a color.

Envelope

The envelope is mapped to dim.

Parameters

• Attack: the attack in beats of incoming notes. The time it takes for dim to move up to gain after receiving a note on. dim will stay at gain until the instrument receives a note off.
• Release: the release in beats of incoming notes. The time it takes for dim to go back to zero after receiving a note off.
• Gain: the maximum value that the dim envelope reaches.
• Int < Vel: toggles whether the intensity of the dim envelope is controlled by the note velocity.

External In

---

Similar to the routing of Live, the External In is an important routing element that allows you to receive lighting signals from external hardware sources (by using an assigned Tag), or from other tracks within Live, and then manipulate them with Beam's effects.

Two input types are available:

• Input is for receiving lighting signals from external sources, like an Art-Net device.
• Track is for receiving lighting signals from other tracks within this Live Set.

Input

Use the Tag Group Selector to select a tag that represents incoming DMX data from an external source.

Track

Use the Track Source to select a track to receive lighting signals from.