User guide

XML example
The best way to understand the frame lines system is by looking at an
example. The following example describes a frame lines file for a 2.35
centered aspect ratio inside the cameras 1.78 recorded image.
<?xml version="1.0" encoding="UTF-8"?>
<!-- NOTES:
All widths are in pixels.
All colors can be one of: black, white, or user.
If you select user, the color can be changed through
the user interface.
You can add as many lines as you like. Lines are
defined by giving 3 distances from the border.
So if you specify top, left and right it will
be a horizontal line with the given distance
from left, right and from the top.
The values are in the range [0, 1], where:
0 is at the edge
1 is on the opposite edge
So specifing 0.4 from left is the same as 0.6 from right.
-->
<framelines>
<!-- The description of the camera, this will
only be used for selecting the correct files.
So the user can only select glasses for his
camera/current setup. -->
<camera>
<type>Alexa EV</type>
<sensor>3K</sensor>
<aspect>1.78</aspect>
<hres>2880</hres>
<vres>1620</vres>
</camera>
<!-- This describes the surround view (or overscan) area.
You can select the opacity in the range [0, 1]
and the border width and color -->
<surround>
<opacity>0</opacity>
<!-- If you omit the border tag no border is shown -->
<border>
<!-- This is the width in pixels. No
pixel is drawn in active/visible area. -->
<width>4</width>
<!-- The color can be one of: black,
white or user. If you select user,
the color can be changed through the
user interface. -->
<color>user</color>
</border>
</surround>
<!--user color line at top and bottom of 2.35 aspect-->
<line>
<left>0</left>
<top>0.12174</top>
<right>0</right>
<width>4</width>
<color>user</color>
</line>
<line>
<left>0</left>
<bottom>0.12174</bottom>
<right>0</right>
<width>4</width>
<color>user</color>
</line>