The plotter control is used to facilitate editing of pairs of percentage values. Several
clip properties come in this format, the most common being the volume property of
video and audio clips. Since volume can be made to change over time, multiple pairs
of percentages are used to describe the fading in and out. Each pair
is interpretted as a cue point
(percentage of clip duration) and level value (percentage of full volume). The control guarantees that there will always
be at least two pairs, with the first locked to the start of the clip and the last locked
to the end.
The plotter control can also be configured to just edit a single pair of percentages,
by specifying zero for the
multiple attribute. Several modules have
properties that come in this format, often interpretted as X/Y positioning or scaling.
Using the default values for all attributes will
produce a medium grey, concave, mulit-pair plotter control with a four pixel curve
and two pixels of padding. The points and lines will be light grey and convex.
The control will be bound to the timeline.selection.volume
property, which will be defined if the selection contains items that support this property.
align: the string 'top', 'left' or 'center'
angle: floating point number (degrees)
bind: an object ID, period and property name
border: positive integer (pixels)
bordercolor: six character hex color value
color: six character hex color value
controlangle: floating point number (degrees)
controlcolor: six character hex color value
controlgrad: floating point number less than 128
curve: positive integer (pixels)
grad: floating point number less than 128
height: integer (pixels) or '*', '**'... (proportional)
hide: an object ID, period and property name followed by a condition and value
multiple: non-zero value for true
padding: positive integer (pixels)
symbol: a valid SWF URL, followed by an ampersand and class name
width: integer (pixels) or '*', '**'... (proportional)