Description:
Enable/disable shadow command files
Form:
SHADOWCMD|SHD|SM [ARGUMENT]
Argument List:
Terse Verbose Description
0 OFF Disable shadow command files
1 ON Enable shadow command files
Response:
MODIFY SHADOWCMD RESPONSE
Verbose- "OK\r\n" to acknowledge receipt of command, or
"ERROR- [Description]\r\n" if error, ending command
Terse- "0\r\n" to acknowledge receipt of command, or
"[NON-ZERO NUMERIC VALUE]\r\n" if error, ending command
"\r\n" concludes modify responses (empty line)
DISPLAY SHADOWCMD RESPONSE
Verbose- "OK\r\n" to acknowledge receipt of command, followed by
"SHADOWCMD= [STANDARD]\r\n", or
"ERROR- [Description]\r\n" if error, ending command
Terse- "0\r\n" to acknowledge receipt of command, followed by
"[TERSE NUMERIC VALUE]\r\n", or
"[NON-ZERO NUMERIC VALUE]\r\n" if error, ending command
"\r\n" concludes display responses (empty line)
Examples:
Verbose command to retrieve current setting:
SHADOWCMD <enter>
Response is: OK\r\n
SHADOWCMD= OFF\r\n
Terse command to retrieve current setting:
SM <enter>
Response is: 0\r\n
0\r\n
Verbose command to change setting:
SHADOWCMD ON <enter>
Response is: OK\r\n
Terse command to change setting:
SM 1 <enter>
Response is: 0\r\n
Notes:
Creating a shadow file:
A typical shadow file must be named the exactly the same as the media file
playing with the extension changed to .SHD. Thus if you have a spot named
TestVideo.mpg the corresponding shadow file would be named TestVideo.SHD. The
files can be created with any text editor and uploaded via FTP to the unit.
The contents of the shadow file contain lines with two things. First is the
STC Value giving the time the command should be run followed by the properly
formatted API command(s) separated by '|' (pipes). There are typically 90,000
STC ticks per each second of video. If the desired commands should run at the
beginning and end of a spot then one can calculate the STC value for the end of
the spot by multiplying the duration of the spot in seconds by 90,000.
An example shadow file which will load an OSD at the beginning of a 60 second
spot and unload it at the end would look similar to:
1 OSD L image.png | OSD D 0 0 0
5400000 OSD OFF
Products Supporting Command