Multi-Viewer Switch API
MAN-000023 Page 5
<pre-amble> <command> <operand1> <operand2>
Where:
•
There is a space between each field
•
The pre-amble is either #ANATL or #ANATR, where:
o
#ANATL equals the key sequence Left CTRL | Left CTRL
o
#ANATR equals the key sequence Right CTRL | Right CTRL
•
Commands require 0, 1 or 2 operands
•
Command success: Upon successful command execution, the device returns the output:
c OK
•
Command failure: Upon failure, the device returns the output: c Error Message
•
To initiate a new serial connection, enter #ANATF 1
Command List
The command is a translation of the keyboard hotkey listed in an Appendix of the Multi-Viewer User
Manual (MAN-000007). Example translations are:
Description
Hotkey
API Command
Load preset #3
Left Ctrl | Left Ctrl | F3
#ANATL F3
Switch to channel #4
Left Ctrl | Left Ctrl | 4
#ANATL 4
Maximize active channel
to full screen
Left Ctrl | Left Ctrl | F
#ANATL F
Figure 5: Example commands
The most common commands are likely to be loading a preset and positioning and resizing windows on
the display. The general format of the command to move and resize a window is:
#ANATL F11 END <Channel> <Operation> <Location>
Where:
<Channel> is 1 to 4
<Operation> is:
1. Window top left X location (0 to 100%)
2. Window top left Y location (0 to 100%)
3. Window X extent as percentage of total X width
4. Window Y extent as percentage of total Y height
5. X offset (the location of the window compared to the full image size when bigger).
6. Y offset (the location of the window compared to the full image size when bigger).
7. X scaling as a percentage
8. Y scaling as a precentage
<Percent> is a 4 digit number in increments of 0.01%
Note that where dual monitors are used in Extend mode, the percentages relate to the total display size.
For example, to set the window for channel 1 to occupy the 4
th
quadrant:
Description
API Command
Set the window top left X position at half display
#ANATL F11 END 1 1 5000
Set the window top left X position at half display
#ANATL F11 END 1 2 5000
Set window X extent to half screen
#ANATL F11 END 1 3 5000
Set window Y extent to half screen
#ANATL F11 END 1 4 5000
Figure 6: Set Channel 1 to 4
th
quadrant (single monitor)
Note that the commands change slightly when using dual side by side monitors:
