Adjustments are the built-in controls of a clip. Most are empty elements, or hold
param elements to animate their values. enabled is
0 or 1 with a default of 1 wherever it appears.
Intrinsic parameters
The DTD fixes the order of the adjustments inside a story element. In the list of
video intrinsic params, each element is optional and appears at most once:
object-tracker, adjust-crop, adjust-corners,
adjust-conform, adjust-transform, adjust-blend,
adjust-stabilization, adjust-rollingShutter,
adjust-360-transform, adjust-reorient,
adjust-orientation, adjust-cinematic. Later versions add
adjust-colorConform (1.11) and adjust-stereo-3D (1.13) at the
end. Audio intrinsic params are adjust-volume then
adjust-panner; full intrinsic params are the video list followed
by the audio list. Timing params are conform-rate then
timeMap.
Audio enhancements, on the audio source elements, are in order:
adjust-loudness, adjust-noiseReduction,
adjust-humReduction, then adjust-EQ or
adjust-matchEQ, and from 1.11 adjust-voiceIsolation.
Video adjustments
| Element | Content | Attributes and defaults |
|---|---|---|
adjust-crop | crop-rect?, trim-rect?, two pan-rect? | mode (required): trim, crop or pan. enabled. |
crop-rect, trim-rect | param* | left, top, right, bottom: default 0, as a percentage of the original frame height. |
pan-rect | Empty | The same four attributes. The first and last rectangles of a Ken Burns move; not keyframable. |
adjust-corners | param* | enabled. botLeft, topLeft, topRight, botRight: default 0 0. |
adjust-conform | Empty | type: fit (default), fill or none. If the element is absent, fit applies. |
adjust-transform | param* | enabled. position, default 0 0; scale, default 1 1; rotation, default 0; anchor, default 0 0; tracking (IDREF). |
adjust-blend | param*, reserved? | amount, default 1.0; mode. |
adjust-stabilization | param* | enabled. type: automatic (default), inertiaCam or smoothCam. |
adjust-rollingShutter | Empty | enabled. amount: none (default), low, medium, high or extraHigh. |
adjust-360-transform | param* | enabled. coordinates (required): spherical or cartesian. For spherical: latitude, longitude (default 0), distance. For cartesian: xPosition, yPosition (default 0), zPosition. xOrientation, yOrientation, zOrientation, default 0; autoOrient, default 1; convergence, default 0; interaxial; scale, default 1 1. |
adjust-reorient | param* | enabled. tilt, pan, roll, convergence: default 0. |
adjust-orientation | param* | enabled. tilt, pan, roll: default 0. fieldOfView. mapping: normal (default) or tinyPlanet. |
adjust-cinematic | param* | enabled. dataLocator (IDREF), aperture. |
adjust-colorConform (1.11) | Empty | enabled. autoOrManual: automatic (default) or manual. conformType: conformNone (default), conformAuto, conformHLGtoSDR, conformPQtoSDR, conformHLGtoPQ, conformPQtoHLG, conformSDRtoHLG75, conformSDRtoHLG100 or conformSDRtoPQ. peakNitsOfPQSource and peakNitsOfSDRToPQSource (both required). |
adjust-stereo-3D (1.13) | param* | enabled. convergence, default 0; autoScale, default 1; swapEyes, default 0; depth, default 0. |
Object tracking
object-tracker holds one or more tracking-shape elements.
| Attribute | Use | Values |
|---|---|---|
id | required | XML ID. |
name | optional | Text. |
offsetEnabled | default 0 | 0 or 1. |
analysisMethod | default automatic | automatic, combined, machineLearning or pointCloud. |
dataLocator | optional | IDREF of a locator. |
Audio adjustments
| Element | Attributes and defaults |
|---|---|
adjust-volume | Holds param*. amount, default 0dB. |
adjust-panner | Holds param*. mode; amount, default 0; original_decoded_mix, ambient_direct_mix, surround_width, left_right_mix, front_back_mix, LFE_balance, rotation, stereo_spread, attenuate_collapse_mix, center_balance. |
adjust-loudness | amount and uniformity, both required. |
adjust-noiseReduction | amount, required. |
adjust-humReduction | frequency, required: 50 or 60. |
adjust-EQ | Holds param*. mode, required: flat, voice_enhance, music_enhance, loudness, hum_reduction, bass_boost, bass_reduce, treble_boost or treble_reduce. |
adjust-matchEQ | Holds one data. |
adjust-voiceIsolation (1.11) | amount, required. |
mute | Suppresses audio for a range. Holds fadeIn?, fadeOut?. start, duration. |
Parameters and animation
| Element | Content | Attributes and defaults |
|---|---|---|
param | fadeIn?, fadeOut?, keyframeAnimation?, param* | name (required); key, which identifies a parameter and can be a path separated by /; value, the initial value; enabled; auxValue (1.11). |
fadeIn, fadeOut | Empty | duration (required). type: linear, easeIn, easeOut or easeInOut; default easeIn and easeOut respectively. |
keyframeAnimation | keyframe* | None. |
keyframe | Empty | time and value (required). interp: linear (default), ease, easeIn or easeOut. curve: linear or smooth (default). auxValue (1.11). |
data | Text | key. A chunk of data; valid keys for filters include effectData and effectConfig. |
Filters and masks
| Element | Content | Attributes and defaults |
|---|---|---|
filter-video | data*, param* | ref (required; effect ID), name, enabled, nameOverride (1.12). Filters are applied in document order. Up to two data elements. |
filter-video-mask | One or more of mask-shape or mask-isolation, then one or two filter-video | enabled; inverted, default 0. The second filter is outer colour correction only. |
mask-shape | param* | name, enabled. blendMode: add (default), subtract or multiply. tracking (IDREF). |
mask-isolation | data, param* | name, enabled. blendMode: add, subtract or multiply (default). type: 3D (default) or HSL. |
filter-audio | data?, param* | ref (required; effect ID), name, enabled, presetID, nameOverride (1.12). |
A filter that is the Final Cut Pro colour correction may carry an XML comment of the
form info-asc-cdl: slope="1.0 1.0 1.0" offset="0 0 0" power="1.0 1.0 1.0",
with red, green and blue values for each.
Retiming
| Element | Content | Attributes and defaults |
|---|---|---|
conform-rate | Empty | scaleEnabled, default 1. srcFrameRate: 23.98, 24, 25, 29.97, 30, 60, 47.95, 48, 50 or 59.94, and from 1.13 also 90, 100, 119.88 and 120. frameSampling: see below; default floor. |
timeMap | timept* | frameSampling, default floor. preservesPitch, default 1. |
timept | Empty | time (required; new adjusted clip time); value (required; original clip time); interp: smooth2 (default), linear or smooth (deprecated); inTime, outTime, for smooth interpolation. |
frameSampling is floor, nearest-neighbor,
frame-blending, optical-flow-classic or
optical-flow, with optical-flow-frc from 1.12. A
timeMap sets a new clip range from its first and last timept,
and other times are interpolated.