Adtec API Help

# OUTPUTVIDEOSCALE OVS OV ## Description:
      Sets scaling and position of the video output.  The scale can be used to reduce the picture
      size and the the position can be used to place the reduced picture at different positions
      of the display.

      The OVS size and position values are stored as configuration options and will be
      automatically applied when the system starts if the configuration changes have been saved.
      The default configuration is 'OFF' which forces native display size and positioning.

      Notes: OUTPUTVIDEOSCALE and OUTPUTASPECTRATIO cannot be used at the same time.  If
             OUTPUTASPECTRATIO is not set to OFF (default), then the OUTPUTVIDEOSCALE
             command options will not be activated.

             When the DECODEACTIVEFORMAT is made active, the OUTPUTVIDEOSCALE will be
             forced to an OFF condition.
## Form:
      Command Handler: DCMD
      OUTPUTVIDEOSCALE|OVS|OV [ORIGIN X ORIGIN Y WIDTH HEIGHT]
       or
      OUTPUTVIDEOSCALE|OVS|OV OFF
      Argument List:
      ORIGIN X      Sets X position of the display image. Value must fit the current
                    video display resolution.
                    Accepts offsets (+/-) and absolutes (no sign).  L, C,
                    and R (Left, Center, Right) may also be argued to
                    automatically place the X position.  An '*' may be argued to
                    keep the existing value, if changing other parameters.
                    Note: ORIGIN X and ORIGIN Y denote the upper left corner of the displayed
                          image.
      ORIGIN Y      Sets Y position of the display image. Value must fit the current
                    video display resolution.
                    Accepts offsets (+/-) and absolutes (no sign).  T, C,
                    and B (Top, Center, Bottom) may also be argued to
                    automatically place the y position.  An '*' may be argued to
                    keep the existing value, if changing other parameters.
                    Note: ORIGIN X and ORIGIN Y denote the upper left corner of the displayed
                          image.
      WIDTH         Specifies the width of the displayed image.  Accepts
                    offsets (+/-) and absolutes (no sign) in pixel units.  Also accepts
                    percentage values as absolutes (50%) or as offsets (+50%, -50%).  The
                    offset percent calculation is based on the current display width
                    size and the absolute percent calculation is based on the resolution of
                    the video display.  The width can be 'auto-calculated' to maintain
                    the display aspect ratio if an 'F' option is argued.  'F' forces
                    the width size based on the HEIGHT value and the aspect ratio
                    of the display.  An '*' may be argued to keep the existing
                    value, if changing other parameters.
      HEIGHT        Specifies the height of the displayed image.  Accepts
                    offsets (+/-) and absolutes (no sign) in pixel units.  Also accepts
                    percentage values as absolutes (50%) or as offsets (+50%, -50%).  The
                    offset percent calculation is based on the current display height
                    size and the absolute percent calculation is based on the resolution of
                    the video display.  The height can be 'auto-calculated' to maintain
                    the display aspect ratio if an 'F' option is argued.  'F' forces
                    the height size based on the WIDTH value and the aspect ratio
                    of the display.  An '*' may be argued to keep the existing
                    value, if changing other parameters.

                    WIDTH and HEIGHT Considerations:
                   - The 'F' argument can be argued for width or height but not both at the
                     same time.
       OFF          The OFF option forces the display to return to its native resolution
                    and position.  An 'OVS 0 0 100% 100%' command will also set the
                    display to its native resolution.
                    OFF is the system configuration default for this option.
## Response:
      OOUTPUTVIDEOSCALE 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)
## Examples:
      Verbose command to set origin in a specified location with
      a display that is half the normal size.  The height will
      be auto calculated based on the width value and the aspect
      ratio of the display.

      *.DCMD OVS 34 349 C 50% F<enter>
         Response is: OK\r\n

      Verbose command to set origin in center of screen with
      a display that is half the normal size.  The height will
      be auto calculated based on the width value and the aspect
      ratio of the display.

      *.DCMD OVS C C 50% F <enter>
         Response is: OK\r\n

      Verbose command to maintain the current position while increasing the
      horizontal size and decreasing the vertical size.

      *.DCMD OVS * * +36 -20 <enter>
         Response is: OK\r\n

      Verbose command to maintain the current position while increasing the
      horizontal size by a percentage value and maintaining the aspect ratio.

      *.DCMD OVS * * +25% F <enter>
         Response is: OK\r\n

      Verbose command to display the OVS setting after an OVS 0 0 720 480 command
       *.DCMD OVS <enter>
       OK
       OUTPUTVIDEOSCALE: Origin (0,0) Size= 720W x 480H

      Verbose command to display the OVS setting after an OVS C C 50% F command
       *.DCMD OVS<enter>
       OK
       OUTPUTVIDEOSCALE: Origin (180,120) Size= 360W x (Aspect Ratio Locked) H

      Verbose command to display the OVS setting after an OVS OFF command
       *.DCMD OVS<enter>
       OK
       OUTPUTVIDEOSCALE: OFF
## Notes:
      None.
## Products Supporting Command: SoloistHD4111 edjeHD4111 signEdjeHD SoloistHD Pro Created By: Adtec Digital Inc