Optrix Documentation

You can use expressions to change how values from an ARDI asset are translated into effects.

These are most often used when you need to convert a measurement from raw units (ie. meters) to a value more suitable for an effect.

The basic format is…

[ <property name/number> ]

However, there are three expression types that can help change the value.

[ <property name/number>|value1|value2|value3 ]

This expression results in a boolean (yes/no) value. When the property (for example, 'Mode') matches any one of the given values, the boolean is 'true'. Otherwise, it's 'false'.

[ <property name/number>:%:<minimum>:<maximum>]

This uses the minimum and maximum scale of the measurement to rescale the value. It's most often used to convert properties from a raw value (for instance, tank level measured in meters) to a height (tank level measured in %).

Let's take a look at the following example…

Tank Level - Analogue value, 0.5 - 2.5m

If you used this expression…

[ Tank Level:%:0:100 ]

Then you would get the following values….

[ <property name/number>:*:<offset>:<multiplier>]

This option allows you to add an offset and multiplier to your values.

Lets take a look at the last example, where we again want to convert a tank level in meters to a percentage.

Tank Level - Analogue value, 0.5 - 2.5m

To convert a 0.5-2.5 value to a 0-1 value, we need to first subtract 0.5, then multiply by 0.5. This gives us the following expression

[ Tank Level:*:-0.5:0.5 ]

NOTE - Where possible, please use the measurement-scale version of this function. This allows users to adjust your visual scales globally from the web interface, without needing to edit individual effect files.