Connecting Levels - AMX AXCESS CONTROL SYSTEM PROGRAM Instruction Manual

Since this code resides in mainline, it will be executed continually, thus making sure that the
bargraph always reflects the value of level number 1 of the volume card. As the volume ramps up,
VOL_LEVEL increases and the bargraph fills. As the volume ramps down, VOL_LEVEL
decreases and the level indicated on the bargraph also decreases. Since both volume levels are
ramping together, you only have to track one of them for the bargraph.

Connecting levels

A unique feature of Touch Panel bar graphs is that you can touch and slide the TP bargraph to raise
or lower the level. The level tracks the movement of your finger. However, to do this you must set
up a connection between the bargraph and the volume level. This is the function of the
DEFINE_CONNECT_LEVEL keyword.
DEFINE_CONNECT_LEVEL is not a keyword used inside mainline, but a definition section, like
DEFINE_DEVICE or DEFINE_START. The best location to place it is immediately following the
DEFINE_VARIABLE section. Underneath the DEFINE_CONNECT_LEVEL header is where all
level connections are listed. Here is how DEFINE_CONNECT_LEVEL is used:
DEFINE_CONNECT_LEVEL
(device 1,level number 1,device 2,level number 2,...etc.)
The section inside the parentheses represents a single connection. All levels listed in the connection
will follow each other. If any one level changes, all others in the connection will change to match.
Any number of levels may be supported per connection, and there is no limit to the number of
connections.
Here is how you would use DEFINE_CONNECT_LEVEL in your program to connect the Touch
Panel bargraph to the volume card levels:
DEFINE_CONNECT_LEVEL
(TP, 1, VOLUME, 1, VOLUME, 2)
This connects level number 1 on the Touch Panel (the bargraph) and levels 1 and 2 on the volume
card. The reason that two levels on the volume card are included is because volume control cards
have two levels: the left audio channel and the right audio channel. These connections are a two-
way street: anytime the bargraph is changed, both volume levels will follow, and anytime a volume
level is changed (for example, by the volume control buttons on the Touch Panel), the bargraph will
automatically follow. When using DEFINE_CONNECT_LEVEL, it is not necessary to use the
SEND_LEVEL keyword in your program, since the connection takes care of updating the
bargraph.
Axcess Programming Language
Levels
45