A keyframe’s <elements> lists what is on the stage while it
lasts. Adobe never published a schema for XFL; the element and attribute
names, defaults and value lists here are those of the unofficial
XFL schema of the JPEXS
project, which is drawn from what Flash CS5 to Animate write. An attribute that is
absent has its default. Positions and sizes are in pixels, colours are
#RRGGBB, and alphas and multipliers are numbers from 0 to 1.
The elements
| Element | Is |
|---|---|
<DOMShape> | A shape: fills, strokes and edges. See Shapes and edge encoding. isDrawingObject="true" marks a drawing object (object drawing mode). |
<DOMRectangleObject>, <DOMOvalObject> | Rectangle and oval primitives, below. |
<DOMGroup> | A group: a <matrix> and its elements in <members>. |
<DOMSymbolInstance> | An instance of a graphic, button or movie clip symbol, below. |
<DOMComponentInstance> | An instance of a component: a symbol instance with <parametersAsXML>, <dataBindingXML> and a uniqueID. |
<DOMCompiledClipInstance> | An instance of a compiled clip: libraryItemName, name, uniqueID, locked, a matrix, its handlers, persistent data and parameters. |
<DOMBitmapInstance> | A bitmap from the library: libraryItemName, name and a matrix. |
<DOMVideoInstance> | A video from the library: libraryItemName, name, a matrix and its frame, frameLeft, frameTop, frameRight, frameBottom. |
<DOMStaticText>, <DOMDynamicText>, <DOMInputText> | Classic text fields, below. |
<DOMTLFText> | A Text Layout Framework field (Flash CS5 to CS6), below. |
Every element can have a <matrix><Matrix a b c d tx ty/></matrix>
(defaults 1, 0, 0, 1, 0, 0; x′ = a·x + c·y + tx, y′ = b·x + d·y + ty) and a
<transformationPoint><Point x y/></transformationPoint>, the
point it rotates and scales about. Most also take a referenceID, which TLF
and IK use to point at them.
Symbol instances
| Attribute | Default | Meaning |
|---|---|---|
libraryItemName | The symbol’s name in the library, with its folder path. | |
symbolType | movie clip | graphic, button, movie clip or ik container. |
name | The instance name, by which scripts refer to it. | |
loop, firstFrame | loop, 0 | For a graphic: loop, play once or single frame, and the frame to start on, counted from 0. |
blendMode | The blend mode. | |
cacheAsBitmap, exportAsBitmap, bits32 | false, false, true | Cache as bitmap; export as bitmap; 32-bit colour for the bitmap. |
isVisible, locked, isExtensible | true, false, false | Visible, locked on the stage, extensible. |
trackAsMenu | false | For a button: track as a menu item. |
matrix3D | A 3D transform: sixteen numbers. | |
rotationX, rotationY, rotationZ | 0 | 3D rotation in degrees. |
centerPoint3DX, …Y, …Z | 0 | The 3D centre point. |
animationSymbolMode, animationFrameOffset | Lists of numbers: the loop mode and first frame for each frame of a motion tween. |
Children: the matrix and transformation point; <Actionscript> with
ActionScript 1.0 and 2.0 handlers (see
ActionScript in FLA);
<filters>; <color>; <MatteColor
color>, the background of an instance exported as a bitmap; and
<persistentData>, values set by extensions.
Colour effect
<color><Color …/></color>: redMultiplier,
greenMultiplier, blueMultiplier, alphaMultiplier
(default 1) and redOffset, greenOffset, blueOffset,
alphaOffset (default 0) are the transform. brightness,
or tintColor with tintMultiplier, say that the panel’s
brightness or tint setting made it.
Blend modes
blendMode is one of normal, layer,
multiply, screen, lighten, darken,
difference, add, subtract, invert,
alpha, erase, overlay and
hardlight; absent means normal. They are the same fourteen modes, in the
same order, as the numbers 1 to 14 of a binary FLA.
Filters
<filters> holds the filters in the order they apply. Every filter
has isEnabled (default true). Blur amounts are pixels (default 5),
quality is 1 (low) to 3 (high), angle is degrees (default 45)
and strength a number (default 1, 100%).
| Element | Attributes |
|---|---|
<DropShadowFilter> | blurX, blurY, strength, quality, angle, distance (5), knockout, inner, hideObject, color (#000000), alpha (1). |
<BlurFilter> | blurX, blurY, quality. |
<GlowFilter> | blurX, blurY, strength, inner, knockout, quality, color, alpha. |
<BevelFilter> | blurX, blurY, strength, quality, angle, distance, knockout, type (inner, outer or full), shadowColor, shadowAlpha, highlightColor (#ffffff), highlightAlpha. |
<GradientGlowFilter>, <GradientBevelFilter> | As the bevel’s first eight, then <GradientEntry color alpha ratio> children: the gradient, up to 15 stops, ratio 0 to 1. |
<AdjustColorFilter> | brightness, contrast, saturation, hue (default 0 each). |
Rectangle and oval primitives
Both hold a matrix, a <fill> and a <stroke> (one
fill style and one stroke style, as on the shapes
page), and objectWidth, objectHeight, x,
y.
<DOMRectangleObject>:topLeftRadius,topRightRadius,bottomLeftRadius,bottomRightRadiusandlockFlag(all corners the same).<DOMOvalObject>:startAngleandendAnglein degrees,innerRadiusas a percentage, andclosePath.
Text fields
<DOMStaticText>, <DOMDynamicText> and
<DOMInputText> share these attributes:
| Attribute | Default | Meaning |
|---|---|---|
left, top, width, height | 0 | The field’s box. |
autoExpand, scrollable | false | The box grows with the text; the field scrolls. |
fontRenderingMode | advanced | device, bitmap, standard, advanced or customThicknessSharpness, with antiAliasThickness and antiAliasSharpness. |
includeOutlines | false | Embed the font outlines. |
selected | false | Selected when saved. |
name, variableName, renderAsHTML, border, lineType | single line | Dynamic and input text only: the instance name, the variable, HTML text, a border, and single line, multiline, multiline no wrap or password. |
maxCharacters | Input text only. | |
isSelectable, orientation | true, horizontal | Static and dynamic text: selectable; horizontal, vertical right to left or vertical left to right. |
| accessibility | hasAccessibleData, silent, forceSimple, autoLabeling, accName, description, shortcut, tabIndex. |
The text is in <textRuns>: one <DOMTextRun> for
each stretch of one style, with <characters> (the text; a line break
is a carriage return) and <textAttrs><DOMTextAttrs …/></textAttrs>:
| Attribute | Default | Meaning |
|---|---|---|
face, size, bitmapSize | –, 12 | The font’s PostScript name and its size in points; the bitmap size is in twentieths. |
fillColor, alpha | #000000, 1 | The colour. |
alignment | left | left, right, center or justify. |
characterPosition | normal | normal, superscript or subscript. |
lineSpacing, lineHeight, letterSpacing | 2, 0, 0 | Spacing in points. |
indent, leftMargin, rightMargin | 0 | Paragraph margins. |
autoKern, aliasText, useScreenSpacing, rotation | true, true, –, false | Kerning; the panel’s alias text setting; screen spacing; rotated characters (vertical text). |
url, target | A link and its window. |
Text fields also take <filters> and <persistentData>.
TLF text
<DOMTLFText> holds a box (left, top,
right, bottom), name, variableName,
localizationStringID, locked, isInBackground,
cacheAsBitmap, a blend mode and 3D settings as an instance has, and these
children:
<tlfFonts>– the fonts used, each<TLFFont platformName psName bold italic><markup>– the text itself as a Text Layout Framework<tlf:TextFlow>, whose elements and attributes are those of Adobe’s published TLF markup<tlfTextObject>– the container’s settings:type(PointorParagraph),editPolicy(readOnly,readSelect,readWrite),columnCount,columnGap,verticalAlign,firstBaselineOffset, the four paddings, background and border and their colours,multiline,antiAliasType,embedFonts,maxChars,displayAsPassword<markupElements>– inline graphics:<MarkupElement referenceID markupChildID referenceType><filters>,<color>
In the explorer
The explorer lists every element of every keyframe: shapes with their fills, strokes and every edge; instances with their library item, name, matrix, colour effect, blend mode, filters and 3D; text with its kind, its characters, font, size and colour; and a table of every filter with its settings.