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: