SHADOWCMD SHD SM

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

Created By: Adtec Digital Inc