Action
The second argument is the action to take. It can be Set,
Get, Modify, Toggle, or Reset. This chooses whether to
read the current value or change the value in a variety of
ways. As you might guess, “Get” reads and “Set” writes.
The “Modify” option allows changing the value relative to
the current setting using a positive or negative offset. The
“Toggle” value toggles a boolean (button) parameter from on
to off or vice versa. The “Reset” option resets a parameter
to its default, i.e. what it would be in a fresh module placed
in Composer.
Note that not all actions are appropriate for all feature
types. For example, “Toggle” is not applicable to continuous
parameters such as gains. In these cases, the command
does nothing but does not return an error.
“Modify” may be used with boolean parameters, e.g. mutes
and grid connect buttons. In this case, any positive modifier
will turn the parameter on, any negative modifier will turn the
parameter off, and a 0 modifier will do nothing.
Format
The optional <Format> field allows the user to specify the
format of the <Value>. If no option is specified, it uses the
native format for that particular control, i.e. dB for gains,
0/1 for Booleans, milliseconds for delay, and percentage for
pans. Other options are ‘P’ or ‘%’ for percentage 0-100%
and ‘L’ for the legacy 0-65535 range. The format also
applies to the returned data.
Unit
The <Unit> field allows the user to specify the unit in the
current site. If set to 0, the unit currently being addressed
is assumed. Otherwise, it is the enumerator shown in
Composer.
Module
The <Module> field allows the user to specify the module
number shown in Composer. For the Super Matrix, the
module number is always 1.
Feature
1. The <Feature> may be any of the following for the
matrix mixer:
2. CPGain Crosspoint Gain
3. CPConnect Crosspoint Connect status
4. CPDelay Crosspoint Delay
5. IMute Input Mute
6. IGain Input Gain
7. ISolo Input Solo
8. IPan Input Pan
9. OMute Output Mute
10. OGain Output Gain
11. OPre Output Pre/Post
Enumerator
The <Enumerator> specifies which crosspoint, input, output,
etc. to control. Matrix crosspoints, will be identified with an
“IxOy” syntax, e.g. “I3O4” refers to input #3 output #4. For
parameters that refer only to an input or output and not a
crosspoint, specify just the “I” or “O” part, e.g. “I3” or “O1”.
All values are 1-based so they match what the user sees in
Composer.
The <Enumerator> may also be specified as a contiguous
range or arbitrary set of values. If this format is used, the
enumerator should be enclosed in {curly brackets}. For a
range, a colon is used to separate the beginning and ends
of the range. For example “{I1O1:I3O4}” specifies a 3x4
rectangle of values with upper left of Input #1 Output #1 and
lower right at Input #3 Output #4.
Sets of values are specified using comma-delimited lists.
For example “{I1O1,I3O3,I16O12}” specifies 3 different
crosspoints at input 1/output 1, input 3/output 3, and input
16/output 12.
Sets, ranges, and individual values may be combined, so
complex groups may be set in a single command, e.g.
“{I1O1:I3O4, I8O8:I9O9, I10O10}”. It is legal to include the
{curly brackets} even if only a single value is specified. So
the brackets may always be included if desired. Spaces
between individual comma-separated values in a set may be
used for clarity.
Value
The <Value> may be in 1 of 3 different formats as mentioned
in the discussion of the <Format> field. For percent and
native mode, values may be floating-point of any precision.
Legacy 16-bit mode uses integers between 0-65535. In
native mode, all gains are expressed in dB. Boolean
parameters should be either 0 or 1. Delay values are in
fractional milliseconds. In percentage mode, a percent sign
may or may not be included. In dB mode, anything -72.0
dB of under will be interpreted as fully off or muted. The
word “Off” may also be used. Muted values will always read
back as -72.0 dB. Values larger than the accepted range
will be clamped to their minimum or maximum values.
If multiple enumerators are given, all specified parameters
will be set to the same <Value>. Only one <Value> may be
provided in each command.
22 25
of
www.symetrix.co | T +1.425.778.7728
To Next Page
Loading...