Triggers; Actions - Polycom SoundStructure C16 Design Manual

Triggers

● The trigger determines when the information in the source becomes actionable. Triggers may be one
of three values: always, equals, or range as defined below.
● The always trigger means that any changes to the source parameter causes the action to execute.
● The equals trigger means that when the source parameter equals the desired value (e.g., open or
closed for logic inputs), the action executes.
● The range trigger means that anytime the source parameter value is equal to or greater than the min
value and less than or equal to the max value, the action executes.
Triggers are 'edge' triggered, meaning that when the source parameter value changes, the event engine
determines whether the trigger condition is met or not. For example, for logic input switches this means
there are two edges – when a logic input is closed (has a value of 0), or when a logic input is opened (has
a value of 1). The following figure shows the two signal edges associated with a button press – the transition
from open to closed and from closed to open. Either edge, or both edges, may be used to trigger events.
Signal Edges Associated with Button Presses
Switch Open
1
Logic State
0

Actions

The action specifies what happens when the trigger condition is met. Actions include
● running a particular command,
● running a preset, or
● mapping the value of the source parameter to a destination parameter.
Running a command allows the event to directly execute a single command to change a SoundStructure
parameter via a valid API command. An example is muting all microphones as the action for when a button
is pressed.
Running a preset allows the event to execute either a partial or full preset. An example of this type of action
is changing the room matrix routing when a button is pressed.
When the Always trigger is used, it is convenient to use the Map action. The map action allows the value of
the destination parameter to track the value of the source parameter with a single event. Both Boolean
parameters (with values of only 0 or 1, e.g., mute state) and numeric parameters (with values from a min to
a max value, e.g., fader value) may be mapped.
Polycom, Inc.
Switch Closed
Push Release
Switch Open
234