DCOLORBARSOSD DCO 0S

Description:

  Enable/Disable OSD
  Print lines to screen
  Set txt size|position on sceen
  Print service ID, provider name, tmr, input to screen

Form:

  Command Handler: DCMD
  DCOLORBARSOSD|DCO|0S
  Argument List:

  To set OSD on/off:
  This controls the mode of the entire OSD engine.
  DCOLORBARSOSD|DCO|0S [MODE]
     MODE- 0= OFF
           1= ON

  To set OSD output:
  The OSD output will be displayed on SDI/COMP/HDMI, SDIALT, or all
  DCOLORBARSOSD|DCO|0S OUTPUT [VALUE]
     VALUE- 0= ALL_OFF              No OSD output
            1= SDI                  OSD on SDI/COMP/HDMI
            2= SDIALT               OSD on alt SDI
            3= SDI_SDIALT           OSD on SDI/COMP/HDMI and SDIALT

  To clear all OSD characters:
  Clear all characters off the current display.  If the
  service mode is on it will not stop it from redrawing to
  the screen.
  DCOLORBARSOSD|DCO|0S CLEAR

  To set OSD text size:
  The text size is based off the current resolution.
  DCOLORBARSOSD|DCO|0S SIZE [VALUE]
     VALUE- 0= 1X
            1= 2X
            2= 4X

  To change the position of all osd text:
  The position command will move the entire display frame as whole.
    (0,0)___________________
         |
         |
         |     x(-500,-500)*
         |
         |
         |
         * = estimation, text size will cause it to vary.
  DCOLORBARSOSD|DCO|0S POSITION [X] [Y]
     X- Range [-4096,4095]
     Y- Range [-4096,4095]

  To display a string on screen:
  DCOLORBARSOSD|DCO|0S STRING [FORMAT] [BLINK] [X] [Y] [STRING]
     FORMAT- 0= No character
             1= White character with no outline
             2= Black outline of character only
             3= White character with black outline
             4= White character over black background
             5= Reversed video. The character area is transparent and
                the background is white.
             6= White character outline only.
             7= Reversed video character with black outline.

     BLINK- 0= ON
            1= OFF

     X-     Range [0,64]

     Y-     Range [0,16]

     STRING- Any string (max 1024 character)

  Display services information on screen
  DCOLORBARSOSD|DCO|0S SERVICES [MODE] [LINES] [BLINK]
     MODE-  0= OFF
            1= ON

     LINES-  [0,4] See notes for details

     BLINK- [0,16] See notes for details

Response:

  DISPLAY DCOLORBARSOSD RESPONSE
    "OK\r\n" to acknowledge receipt of command, followed by
    "Osd Mode= [OFF/ON]\r\n"
    "Osd Output= [OFF/SDI/SDIALT/SDI_SDIALT]\r\n"
    "Service Mode= [OFF/ON]\r\n"
    "Service Lines= [0,4]\r\n"
    "Service Blink= [0,16] X\r\n"
    "X Position= [-4096,4095]\r\n"
    "Y Position= [-4096,4095]\r\n"
    "Text Size= [0,2]\r\n"
    "String Format= [0,7]\r\n"
    "String Blink= [On/OFF]\r\n"
    "String X Position= [0,64]\r\n"
    "String Y Position= [0,16]\r\n"
    "String Length= [0,1024]\r\n"
    "String= "[string displayed]"\r\n" or
    "ERROR- [Description]\r\n" if error, ending command
    "\r\n" concludes display responses (empty line)

Examples:

   Verbose command to retrieve current DCOLORBARSOSD setting:
   *.DCMD DCO <enter>
      Response is: Osd Mode= ON
                   Output= SDI_SDIALT
                   Service Mode= OFF
                   Service Lines= 2
                   Service Blink= 2
                   X Position= 0
                   Y Position= 0
                   Text Size= 0X
                   String Format= 0
                   String Blink= OFF
                   String X Position= 0
                   String Y Position= 0
                   String Length= 11
                   String= "Test String"

   Terse command to retrieve current DCOLORBARSOSD setting:
   *.DCMD 0S <enter>
      Response is: 1 3 0 2 2 0 0 0 0 0 0 0 11 "Test String"

   Verbose command to change DCOLORBARSOSD setting to activate the text
   generator:
   *.DCMD DCO ON<enter>
      Response is: OK\r\n

   Terse command to change DCOLORBARSOSD setting to activate the text
   generator:
   *.DCMD 0S ON<enter>
      Response is: 0\r\n

   Verbose command to change DCOLORBARSOSD setting of the text size (to 2x)
   used for the text generator:
   *.DCMD DCO SIZE 1<enter>
      Response is: OK\r\n

   Terse command to change DCOLORBARSOSD setting of the text size (to 2x)
   used for the text generator:
   *.DCMD 0S SIZE 1<enter>
      Response is: 0\r\n

   Verbose command to change DCOLORBARSOSD setting for the position of the
   printed string|service:
   *.DCMD DCO POSITION -500 -500<enter>
      Response is: OK\r\n

   Terse command to change DCOLORBARSOSD setting for the position of the
   printed string|service:
   *.DCMD 0S POSITION -500 -500<enter>
      Response is: 0\r\n

   Verbose command to activate the  DCOLORBARSOSD dynamic service display
   *.DCMD DCO SERVICES ON<enter>
      Response is: OK\r\n

   Terse command to activate the  DCOLORBARSOSD dynamic service display
   *.DCMD 0S SERVICES 1<enter>
      Response is: 0\r\n

Notes:

  OUTPUT
   OFF will not display OSD output, even if OSD is enabled.
   SDI will place the OSD display on the SDI, composite and HDMI outputs.
   SDIALT will place the OSD disaply on the SDI alternate output.
   SDI_SDIALT will place the OSD display on all outputs

  LINES
  Lines is used to define what is displayed during the services command.
  The format of the display is below
   (1)    Service Name
   (2)  Service Provider
   (3)       Input
   (4)        TMR
  For example a value of 3 will display lines 1-3.  A value of 2 will
  display lines 1-2.  These lines can not be selected individually.

  BLINK
  Blink is used as a bit defined field.  When used with the string command
  it will blink the entire string not individual lines or characters.
  For example, binary number 1100 will blink the 4th and 3rd line of the
  services command

      1 0 1 0
      ^ ^ ^ ^
      ^ ^ ^ line 1
      ^ ^ line 2
      ^ line 3
      line 4

  SERVICES
  If only the ON argument is used without LINES or BLINK, the default values
  will be used.  LINES=2 and BLINK=2.
Created By: Adtec Digital