Motion

包	fl.motion
类	public class Motion
继承	Motion MotionBase Object

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

Motion 类存储了一个关键帧动画序列，该序列可以应用于可视对象。动画数据包括位置、缩放、旋转、倾斜、颜色、滤镜和缓动。Motion 类有检索特定时间点数据和自动在关键帧之间插补值的方法。

注意：在 Flash CS3 中，此类支持的许多属性和方法是此类独有的成员。Flash CS4 为此类的这些属性和方法引入了一个基类，即 KeyframeBase，现在，其他类可通过继承链共享这些属性和方法。如果您之前就已在使用 Flash CS3，请注意 Keyframe 类仍然支持这些属性和方法，但这些属性和方法在 Flash CS3 之后的 Flash Professional 版本中是 KeyframeBase 类的成员。对于此参考中的任何其他类，选择 Show Inherited Public Properties 和 Show Inherited Public 方法可查看该类支持的所有属性和方法。

默认 MXML 属性keyframesCompact

相关 API 元素

Motion XML 元素

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		duration : int 控制 Motion 实例的时间长度（以帧为单位）。	MotionBase
		is3D : Boolean 指定此动画是否包含 3D 属性的更改。	MotionBase
		keyframes : Array 一个关键帧数组，定义 Motion 在不同时间的行为。	MotionBase
		keyframesCompact : Array 一个关键帧紧凑数组，其中每个索引处都有一个关键帧。	Motion
		source : Source 一个对象，可存储有关创建动作的上下文的信息，如帧速率、维数、变形点以及起始位置、缩放比例、旋转角度与倾斜角度。	Motion

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		Motion(xml:XML = null) Motion 实例的构造函数。	Motion
		addFilterPropertyArray(index:int, name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void 修改 Motion 对象的所有对应关键帧中的滤镜属性。	MotionBase
		addKeyframe(newKeyframe:KeyframeBase):void 向 Motion 实例添加关键帧对象。	MotionBase
		addPropertyArray(name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void 将值数组存储在与 Motion 类声明的属性对应的关键帧中。	MotionBase
		fromXMLString(xmlString:String):Motion [静态] 从 XML 字符串创建 Motion 实例所需的方法。	Motion
		getColorTransform(index:int):flash.geom:ColorTransform [覆盖] 检索 Motion 实例中特定时间索引处的插补 ColorTransform 对象。	Motion
		getCurrentKeyframe(index:int, tweenableName:String = ""):KeyframeBase 检索 Motion 实例中特定帧位置处当前处于活动状态的关键帧。	MotionBase
		getFilters(index:Number):Array [覆盖] 检索 Motion 实例中特定时间索引处的插补滤镜数组。	Motion
		getMatrix(index:int):Matrix 返回动画帧指定索引位置的 Matrix 对象。	MotionBase
		getMatrix3D(index:int):Object 返回动画帧指定索引位置的 Matrix3D 对象。	MotionBase
		getNextKeyframe(index:int, tweenableName:String = ""):KeyframeBase 检索 Motion 实例中位于特定帧之后的下一个关键帧。	MotionBase
		getValue(index:Number, tweenableName:String):Number 检索某个时间点处的动画属性值。	MotionBase
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		initFilters(filterClasses:Array, gradientSubarrayLengths:Array, startFrame:int = -1, endFrame:int = -1):void 初始化目标对象的滤镜列表并将滤镜列表复制到 Motion 对象的每个 Keyframe 实例。	MotionBase
		interpolateFilter(fromFilter:BitmapFilter, toFilter:BitmapFilter, progress:Number):BitmapFilter [静态] 从一个 Filter 对象平滑混合到另一个 Filter 对象。	Motion
		interpolateFilters(fromFilters:Array, toFilters:Array, progress:Number):Array [静态] 从一个 Filter 对象数组平滑混合到另一个 Filter 对象数组。	Motion
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		overrideTargetTransform(scale:Boolean = true, skew:Boolean = true, rotate:Boolean = true):void	MotionBase
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		setValue(index:int, tweenableName:String, value:Number):void 设置特定可补间属性在 Motion 实例中给定时间索引处的值。	MotionBase
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		useRotationConcat(index:int):Boolean 在 addPropertyArray() 方法提供动画的数据时，旋转目标对象。	MotionBase
		valueOf():Object 返回指定对象的原始值。	Object

属性详细信息

keyframesCompact

属性

keyframesCompact:Array

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

一个关键帧紧凑数组，其中每个索引处都有一个关键帧。与此相反，稀疏数组中有空索引（如在 keyframes 属性中）。在紧凑数组中，不使用 null 值来填充关键帧之间的索引单元。但是，keyframesCompact 中关键帧的索引可能与其在 keyframes 数组中的索引不匹配。

此属性主要用于与 Flex MXML 编译器兼容，该编译器基于 Motion XML 生成紧凑数组。

实现
public function get keyframesCompact():Array
public function set keyframesCompact(value:Array):void

相关 API 元素

keyframes

source

属性

public var source:Source

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

一个对象，可存储有关创建动作的上下文的信息，如帧速率、维数、变形点以及起始位置、缩放比例、旋转角度与倾斜角度。

构造函数详细信息

()

构造函数

public function Motion(xml:XML = null)

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

Motion 实例的构造函数。默认情况下，会自动创建一个初始关键帧，具有默认 Transform 属性。

参数

xml:XML (default = null) — 定义 Motion 实例的 E4X XML 对象（可选）。

方法详细信息

fromXMLString

()

方法

public static function fromXMLString(xmlString:String):Motion

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

从 XML 字符串创建 Motion 实例所需的方法。

参数

xmlString:String — Motion XML 的字符串。

Motion — 新的 Motion 实例。

getColorTransform

()

方法

override public function getColorTransform(index:int):flash.geom:ColorTransform

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

检索 Motion 实例中特定时间索引处的插补 ColorTransform 对象。

参数

index:int — Motion 实例中帧的时间索引（大于等于零的整数）。

flash.geom:ColorTransform — 插补的 ColorTransform 对象。

相关 API 元素

flash.geom.ColorTransform

getFilters

()

方法

override public function getFilters(index:Number):Array

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

检索 Motion 实例中特定时间索引处的插补滤镜数组。

参数

index:Number — Motion 实例中帧的时间索引（大于等于零的整数）。

Array — 插补的滤镜数组。如果没有适用的滤镜，则返回空数组。

相关 API 元素

flash.filters

interpolateFilter

()

方法

public static function interpolateFilter(fromFilter:BitmapFilter, toFilter:BitmapFilter, progress:Number):BitmapFilter

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

从一个 Filter 对象平滑混合到另一个 Filter 对象。

参数

	`fromFilter:BitmapFilter` — 起始 Filter 对象。

	`toFilter:BitmapFilter` — 结束 Filter 对象。

	`progress:Number` — 过渡的百分比（小数，其中 `0` 表示开始，`1` 表示结束）。

BitmapFilter — 插补的 Filter 对象。

相关 API 元素

flash.filters

interpolateFilters

()

方法

public static function interpolateFilters(fromFilters:Array, toFilters:Array, progress:Number):Array

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

从一个 Filter 对象数组平滑混合到另一个 Filter 对象数组。

参数

	`fromFilters:Array` — Filter 对象的起始数组。

	`toFilters:Array` — Filter 对象的结束数组。

	`progress:Number` — 过渡的百分比（小数，其中 `0` 表示开始，`1` 表示结束）。

Array — 插补的 Filter 对象数组。

相关 API 元素

flash.filters

法律声明 | 在线隐私策略

Motion - AS3 Flash

类 x

keyframesCompact

source

Motion

fromXMLString

getColorTransform

getFilters

interpolateFilter

interpolateFilters