Differences

This shows you the differences between two versions of the page.

--- fixture_formula [2011/02/14 03:19] – GaryBonaducci
+++ fixture_formula [2011/10/19 05:10] (current) – removed Jan_K
@@ Line 1: / Line 1: @@
-**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.
-==== Variables ====
-Three main variable families are available:
-  * **GI**x //(GI1, GI2, GI3.... or GI01, GI02, GI03...)//  →  **Gobo Index** number
-  * **CI**x //(CI1, CI2.... or CI01, CI02...)//  →  **Color Index** number
-  * **CH**x //(CH1, CH2, CH3.... or CH01, CH02, CH03....)//  →  The fixture's **Channel** number
-NOTES:
-  - **GI**x and **CI**x are //indexed// values and only go in the order 1, 2, 3, 4.... (sequential whole numbers)
-  - **GI**x and **CI**x 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.
-  - **CH**x corresponds to the channels you have setup and described on the "Fixture Config" and "Channel Description" tabs.
-==== Operators ====
-Basic math operators can be used in Formulas:
-  * ** + **  →  Addition
-  * ** - **  →  Subtraction
-  * ** * **  →  Multiply
-  * ** / **  →  Divide
-  * ** ( ) **  →  Parenthetical Ordering
-==== 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]