User manual

Appendices
520
© 2014 Digital Vision
UM-2014.1-07
NOTE
Grid specification lines must end with a semi-colon ";" character.
A '#' character at line start delimits a comment. Rest of line is
ignored.
Strings should be quoted i.e. "string".
There should be a space between each identifier and before the
terminating semi-colon.
Grid Specification
The following identifiers are used.
name
name "<STRING>" ;
This is the name of the grid as shown in the GUI drop-down list.
Grid names should be unique.
units
units "<UNITS>" ;
where UNITS are :
pixels
By default the coordinate system is absolute image pixels,
lower left to top right.
Elements are drawn relative to the lower left corner of a
pixel.
normalised
Normalised coordinates map the range 0.0..1.0 to the
monitor source full image pixel size in x and y.
unitsImageAspect
unitsImageAspect <FLOAT> ;
The normalised region may be mapped to an image aspect extraction of the
monitor source full image (pre or post monitor mask).
This is achieved by specifying the target image aspect. Given the monitor
source image and aspect ratio, the normalised region will automatically be
adjusted for 'letterbox' or 'pillarbox' display of the target aspect ratio.
unitsObeyMask
unitsObeyMask <INT> ;
where INT can be 0 or 1.
The normalised region may be mapped to the visible (post monitor mask)
image pixel size in x and y.