Macros And Presets; Command Structure - Polycom Vortex EF2210 Program Manual

In a similar fashion, many of the integer commands (such as gains) can be controlled by incrementing
or decrementing them by a specific amount. For example, the command ' ' increments the input gain
on channel by 1 dB. The acknowledgment for this command will return the actual value that the gain
was incremented to. Thus, to implement a volume control, your control program can send a
command to increment the gain by 1 dB when the "up" button is pressed and decrement the gain by
1 dB when the "down" button is pressed. The control can update its level indicator based on the
acknowledgment that is received.

3.4. Macros and Presets

Although macros and presets are similar, there are times when using one is better than the other.
Presets store the absolute values of all of the non-global settings of the device. This includes, but is
not limited to, input and output gain settings, matrix settings, algorithm settings, parametric EQ
settings, and automixer settings. See
saved to presets.
Presets should be used when you really want to change all the settings in a device. One example
would be when you want to have one unit be able to control different rooms. In this case, having a
preset for each different room is the easiest solution.
Macros are like mini-presets. You can define them to change only the settings you are interested in.
One advantage of macros over presets is that macros can make relative changes in addition to
absolute changes. An absolute change is something like "set the input gain to -3 dB". A relative
change is something like "raise the input gain by 3 dB". One example of using macros for a relative
change is stereo volume ramping. If you have two outputs setup to have left and right program
audio, then you could build a macro that contains two commands: one to increment the left channel
by 1 dB and the other to increment the right channel by 1 dB. Then, by calling that macro, you can
ramp the stereo outputs. A similar thing can be done with decreasing the volume.
Another thing to consider when using macros and presets is to use the
commands instead of the
macro or preset, but the X versions produce acknowledgements for the settings that change, while
the Q versions don't. If your control system updates its status by looking at the acknowledgements
that come back, then you'll probably want to use the X versions. Another option would be to use the
Q versions and then manually query the values you're interested in. If your control system does not
need use acknowledgements, or if you are manually querying the values you're interested in, using
the Q versions is better since it doesn't generate acknowledgements and thus reduces RS-232 traffic.

4. Command Structure

A Vortex command consists of a series of ASCII characters with the following structure.
Description
Device Type
Device ID
Section 7
and
MACROX PRESETX
Number of Characters
1
2
for a list showing all the commands and which are
commands. Both the Q and X versions execute the
and
MACROQ PRESETQ
Range of Values
0-9, A-Z, *
0-9, *