Movie Masher

open source video editing tools for your site

HomeExamplesFAQDocumentationDownload

Plotter Control

Parent Tags: bar
Tag Attributes: align, angle, bind, border, bordercolor, color, controlangle, controlcolor, controlgrad, curve, grad, height, hide, multiple, padding, symbol, width

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.

© Movie Masher 2006-2010