Using the Command Line
ONYX utilizes a logically structured command line syntax that orientates itself along established industry standards.
Once the general idea of the command structure is understood, many commands will come easily to the you as they are modeled along the communication between a lighting designer and a programmer.
"Bring fixture 25 at 80%" is exactly that in the command line: 25 @ 80 Enter.
This system is based on a Source @ Target Enter based command structure that feels natural and is easily learned.
If you know the number(s) of the fixture(s) you wish to select, you can use the 0-9 keypad buttons to specify the fixture numbers and the (and), (except) and (through) buttons to modify your selection. ONYX allows simple as well as complex fixture selection.
A full list of Commands can be found in Command Line Reference.
Remember, in ONYX every light has it's own fixture ID number.
Some examples are:
| Basic Fixture Selection | |
|---|---|
| 1 Enter | Selects fixture 1. |
| 1 + 2 Enter | Selects fixture 1 and 2. |
| 1 Thru 5 Enter | Selects fixture 1 through 5. |
| 1 Thru 5 + 21 Thru 25 Enter | Selects fixtures 1 through 5 and 21 through 25. |
| 1 Thru 5 - 4 Enter | Selects fixtures 1, 2, 3 and 5. (but not 4!) |
Using the above buttons in conjunction with the (at) or buttons allows you to set specified fixtures to specified intensity values. When using , you don't have to press .
For example:
| Selecting Fixtures & Specifying Intensity | |
|---|---|
| 1 Full | Brings the intensity of fixture 1 to 100% |
| 1 + 2 Full | Brings the intensity of fixtures 1 and 2 to 100%. |
| 1 Thru 5 @ 50 Enter | Brings the intensity of fixtures 1 through 5 to 50%. |
| Use "@" When Assigning Non-Full Intensities: | |
|---|---|
| 1 Thru 5 + 21 Thru 25 @ 75 Enter | Brings the intensity of fixtures 1 through 5 and 21 through 25 to 75 percent. |
| 1 Thru 5 - 4 @ 95 Enter | Brings the intensity of fixtures 1, 2, 3 and 5 to 95% |
ONYX allows you to rapidly assign a range of intensities to a range of fixtures as follows:
| Intensity Fanning | |
|---|---|
| 1 Thru 5 @ 50 Thru 100 Enter* | Brings the intensity of fixture 1 to 50%, fixture 2 to 62%, fixture 3 to 75%, etc. |
|
1 Thru 5 @ 50 Thru 10 Enter |
Puts fixture 1 at 50% and each of the following fixtures 10% lower. |
*Note that you can not use here as this would drive all fixtures to 100% instantly.
ONYX provides four keypad shortcuts to rapidly select fixtures in the Programmer:
| Selection Shortcuts - Selecting/Deselecting All Fixtures in the Programmer | |
|---|---|
| . Enter | Selects every fixture in the Programmer |
| 0 Enter | Deselects every fixture in the Programmer |
| / Enter | Inverts the current fixture selection. Those that are selected will become deselected and vice versa. Note that this only applies to fixtures in the Programmer. |
| . 0 Enter | Selects all fixtures that are patched in your show (regardless of whether they are in the Programmer or not. |
Deselecting Specific Fixtures
Once you have finished adjusting the desired attributes of the selected fixtures, you can deselect those fixtures in a number of different ways. Note that deselected fixtures and their attribute values (whether active or inactive) remain in the Programmer until cleared or recorded.
To deselect a specific fixture or fixtures using the keypad, press the (minus) button followed by the desired fixture number(s) and the (and), (except) and (through) buttons to modify your selection, for example:
- 6 Thru 10 Enter
You can use the and buttons to scroll through the fixtures or, if a mask is enabled (see Using the Grouping Tools), scroll through sets of the fixtures.
You can click on or touch active fixtures in the Fixtures screen to deselect them, or press at the bottom of that window.
Clearing Selected Fixtures
To clear all attributes for a selected fixture or fixtures from the Programmer, press once followed by the fixture number(s), for example:
Clear 31 Thru 35 Enter
Clearing All Fixtures
To completely clear the Programmer of all fixtures, press Clear twice.
The first time you press , the "Clear Options" pop up will appear. The second time you press , all fixtures will be cleared and the Programmer will be emptied.
It is also possible to clear only selected attributes of specified fixtures.
The command is discussed in more detail under Clearing the Programmer.
When bringing fixtures to Full you are not required to use the “@” or “Enter” buttons, but you still can if it brings you joy. When entering any other value, these buttons are required.