Frames 

 No Frames

Previous Element
ActionScriptSettings

Next Element
Argument


Alter

This element alters the properties of an instance of a symbol on the timeline at the specified display depth. A new ratio can be specified for MorphShape or video symbols and Transform and RGBAColorTransform child elements may also be specified. MovieClipActions cannot be specified. A Replace element must be used to specify new MovieClipActions. Existing Transform and RGBAColorTransform elements are unchanged unless explicitly specified.

Alter elements can also take basic transformation attributes. These, in general, should be used in preference to a nested Transform element in situations where the referenced symbol is already defined and the bounds are known. The location of the referenced symbol can be modified with the x and y attributes, the scale of the symbol can be modified using the width and height attributes, and the rotation of the symbol modified using the rotate attribute. Note that when the width and height attributes are used for compound symbols such as MovieClips and Buttons, their bounds are calculated by summing the bounds of all symbols on their timeline or, in the case of buttons, their hit areas.

If it is necessary to specify skew attributes using differing values for rotateX and rotateY, or if it is preferred to specify an absolute transform independent of the altered symbol, then the nested Transform element can be used

Attributes

name The id of the symbol to alter on the timeline. This attribute is optional from Version 2.0.04 - when supplied, the existing symbol on the specified depth is checked to ensure that it has the specified symbol ID.
TypeString
depth The depth of the symbol instance to alter.
TypeInteger
From Value1
To Value65535
tabIndex Optional attribute specifying a tab index for the symbol. Tab indices are used by screen readers and provide a means to signal that the current symbol has content that is renderable by such a reader.
TypeInteger
From Value0
To Value65535
ratio Optional attribute used for MorphShapes and Videos. When used for a MorphShape, this refers to the degree of interpolation between the FromShape and the ToShape. A value of 0 displays the FromShape, a value of 65535 displays the ToShape and all values in between result in an interpolation between the two in direct proportion to the ratio.

For Video symbols this moves the video playhead to the frame number specified by the ratio value.

TypeInteger
From Value0
To Value65535
x X position for specified symbol. Moves the origin of the symbol to the specified X coordinate.
TypeFloat
Default Value0
y Y position for specified symbol. Moves the origin of the symbol to the specified Y coordinate.
TypeFloat
Default Value0
width The new width of the symbol. The symbol width is independent of the coordinate system of the symbol being altered. In order for this attribute to be specified, the symbol must already be defined in RVML, and it cannot have a width of zero.
TypeFloat
Default ValueWidth of existing symbol
height The new height of the symbol. The symbol height is independent of the coordinate system of the symbol being altered. In order for this attribute to be specified, the symbol must already be defined in RVML, and it cannot have a height of zero.
TypeFloat
Default ValueHeight of existing symbol
rotate Rotation in degrees about the origin of the shape, applied before the application of the x and y attribute definitions, if specified.
TypeFloat
Default Value0
blend Flash 8 introduced blending of multiple overlapping symbols on a stage. There are 14 different blend types supported. Blends remain applied to a symbol instance until explicitly reset. To remove a previously applied blend mode, the blend value should be set to 'normal'.
Valuesnormal
layer
multiply
screen
lighten
darken
difference
add
subtract
invert
alpha
erase
overlay
hardlight
cacheAsBitmap Flash 8 introduced a new setting for indicating that a MovieClip or Button placed on the timeline should be converted to a bitmap for faster rendering. This enables the Flash player to optimize the rendering of display objects that are frequently redrawn on the stage.
Values
yes
The displayed symbol should be converted to a bitmap
no
The displayed symbol should not be converted to a bitmap
Default Valueno

Child Elements

Transform
RGBAColorTransform
Filters

Parent Elements

Frame

Examples

MorphShape Example
Square to Circle Morph Example
Video Example
Animate simple symbols on timeline

Previous Element
ActionScriptSettings

Next Element
Argument