This is an old revision of the document!
Table of Contents
this entire section under construction.
The "Formula" Feature
The new “Formula” feature can both greatly simplify a fixture's Macro window and add more controls at the same time.
"Formula" Variables
Three main variable families are available:
- GIx (GI1, GI2, GI3…. or GI01, GI02, GI03…) → Gobo Index number
- CIx (CI1, CI2…. or CI01, CI02…) → Color Index number
- CHx (CH1, CH2, CH3…. or CH01, CH02, CH03….) → The fixture's Channel number
NOTES:
- GIx and CIx are indexed values and only go in the order 1, 2, 3, 4…. (sequential whole numbers)
- GIx and CIx correspond with the number of Gobos and Colors you have set on the “Fixture Config” tab. If you have specified that Gobo Channel 1 has eight gobos, then GI01 (or GI1) will vary between 1~8 according to whichever Gobo is currently displayed. Likewise, if you have specified your Colorwheel has 12 colors, then CI01 (or CI1) will vary between 1~12.
- CHx corresponds to the channels you have setup and described on the “Fixture Config” and “Channel Description” tabs.
"Formula" Operators
Basic math operators can be used in Formulas:
- + → Addition
- - → Subtraction
- * → Multiply
- / → Divide
- ( ) → Parenthetical Ordering
"Formula" Usage
Formulas are written in standard programming syntax. Computations on the right side of the “=” are assigned to the variable on the left side.
NOTES:
- Spaces are NOT permitted in Formulas!
- CH01 = 6 + (GI1 * 6) ← WRONG, will not work.
- CH01=6+(GI1*6) ← CORRECT, will work. (No spaces in Formula.)
- Only ONE “=” is permitted in a Formula. Using multiple “=” in a Formula will yield unexpected results.
- CH01=48 ← CORRECT, will work. (Assigns the value “48” to Channel 1.)
- CH01=CH02=CH03=48 ← WRONG, will not work. The programmer is trying to assign the value “48” to Channels 1, 2 and 3 simultaneously, but this will not work.
Example 1:
CH01=48
Action: This assigns the value “48” to the fixture's Channel 1.
Example 2:
CH01=GI01*16
Action: This takes the index value of Gobo Channel 1, multiplies it by 16, and assigns it to the fixture's Channel 1.
If the fixture has 4 gobos, then GI01 will range in values 1, 2, 3, or 4; and the results of this formula will assign the values 16, 32, 48, or 64 to Channel 1.
Example 3:
CH01=16*(GI01-1)
Action: This subtracts 1 from the index value of Gobo Channel 1, multiplies the result by 16, and assigns it to the fixture's Channel 1.
If the fixture has 4 gobos, then GI01 will range in values 1, 2, 3, or 4; and the results of this formula will assign the values 0, 16, 32, or 48 to Channel 1.
Example 4:
CH01=16*(GI01-1)+4
Action: This subtracts 1 from the index value of Gobo Channel 1, multiplies the result by 16, adds 4, and assigns it to the fixture's Channel 1.
If the fixture has 4 gobos, then GI01 will range in values 1, 2, 3, or 4; and the results of this formula will assign the values 4, 20, 38, or 52 to Channel 1.
Example 5:
CH2=CH1
Action: This assigns the value in Channel 1 to the fixture's Channel 2. (Programming syntax reads from right to left.)
Summary
[TK]