| 包 | spark.effects |
| 类 | public class AnimateTransform3D |
| 继承 | AnimateTransform3D  AnimateTransform Animate Effect EventDispatcher Object |
| 子类 | Move3D, Rotate3D, Scale3D |
| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
对于 AnimateTransform，存在此效果的某些属性，这些属性是与在运行时结合到一起的所有其它转换效果共享的。特别是，与投影相关的属性 applyLocalProjection、removeProjectionWhenComplete、autoCenterProjection、fieldOfView、focalLength、projectionX 和 projectionY 都是共享属性。以相似方式在所有 3D 效果上设置这些属性，可以将这些效果组合成一个复合效果以获得预期的结果。
显示 MXML 语法
隐藏 MXML 语法The <s:AnimateTransform> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<s:AnimateTransform
Properties
id="ID"
applyChangesPostLayout="true"
applyLocalProjection="false"
autoCenterProjection="true"
fieldOfView="no default"
focalLength="no default"
projectionX="0"
projectionY="0"
removeLocalProjectionWhenComplete="false"
/>
默认 MXML 属性motionPaths
相关 API 元素
| 属性 | 由以下参数定义 | ||
|---|---|---|---|
| applyChangesPostLayout : Boolean [覆盖]
由 AnimateTransform 的子类用于指定该效果是否更改布局管理器所用的转换值，或者它是否更改运行布局之后使用的值。 | AnimateTransform3D | ||
| applyLocalProjection : Boolean
若为 true，则该效果会使用效果中的其它投影相关属性创建透视投影，并在它开始播放时将其应用于目标组件的父项。 | AnimateTransform3D | ||
| autoCenterProjection : Boolean = true
设置为 false 可以禁止 3D 效果自动将投影点设置到目标中心。 | AnimateTransform3D | ||
 | autoCenterTransform : Boolean = false
指定在转换效果开始播放时，该效果是否围绕目标的中心 (width/2, height/2) 发生。 | AnimateTransform | |
| className : String [只读]
效果类的名称，如“Fade”。 | Effect | |
| constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| customFilter : mx.effects:EffectTargetFilter
指定一个 EffectTargetFilter 类型的自定义滤镜对象，效果将使用此对象来确定播放效果的目标。 | Effect | |
| disableLayout : Boolean
如果为 true，则效果通过将容器的 autoLayout 属性设置为 false 对其目标的父容器禁用布局，并同时对目标对象禁用任何布局约束。 | Animate | |
| duration : Number
效果的持续时间（以毫秒为单位）。 | Effect | |
| easer : IEaser
此效果的缓动行为。 | Animate | |
| effectTargetHost : mx.effects:IEffectTargetHost
一个属性，您可以通过设置此属性访问数据效果基于列表的目标控件。 | Effect | |
| fieldOfView : Number
为三维视野指定一个角度（介于 0 度到 180 度之间）。 | AnimateTransform3D | ||
| filter : String
指定用于过滤效果目标的算法。 | Effect | |
| focalLength : Number
眼睛或视点的原点 (0,0,0) 与位于 z 轴的显示对象之间的距离。 | AnimateTransform3D | ||
| hideFocusRing : Boolean
确定在开始播放效果时，效果是否应隐藏对焦环。 | Effect | |
| instanceClass : Class
一个 Class 类型的对象，用于指定此效果类的效果实例类。 | Effect | |
| interpolator : IInterpolator
此效果计算属性的起始值和结束值之间的值所用的插补器。 | Animate | |
| isPlaying : Boolean [只读]
一个只读标志，如果当前正在播放效果的任一实例，则为 true；否则，则为 false。 | Effect | |
| motionPaths : Vector.<MotionPath>
MotionPath 对象的 Vector，其中的每个对象都带有正在设置动画的属性的名称以及该属性在动画过程中所采用的值。 | Animate | |
| perElementOffset : Number
在效果的第一个目标之后，其他效果目标的附加延迟（以毫秒为单位）。 | Effect | |
| playheadTime : Number
效果的当前时间位置。 | Effect | |
| projectionX : Number = 0
将投影点设置为投影点在 x 方向距目标 (0, 0) 坐标的偏移量。 | AnimateTransform3D | ||
| projectionY : Number = 0
将投影点设置为投影点在 y 方向距目标 (0, 0) 坐标的偏移量。 | AnimateTransform3D | ||
| relevantProperties : Array
一个属性名称 Array，执行过滤时将使用这些名称。 | Effect | |
| relevantStyles : Array
一个样式名称 Array，执行过滤时将使用这些名称。 | Effect | |
| removeLocalProjectionWhenComplete : Boolean = false
如果为 true，则该效果会在它完成播放时从目标组件的父组件中删除透视投影。 | AnimateTransform3D | ||
| startDelay : int = 0
开始播放效果前需要等待的时间（以毫秒为单位）。 | Effect | |
| target : Object
要应用此效果的对象。 | Effect | |
| targets : Array
一个对象 Array，这些对象都是效果的目标。 | Effect | |
| transformX : Number
设置转换中心的 x 坐标（由 autoCenterTransform 属性覆盖时除外）。 | AnimateTransform | |
| transformY : Number
设置转换中心的 y 坐标（由 autoCenterTransform 属性覆盖时除外）。 | AnimateTransform | |
| transformZ : Number
设置转换中心的 z 坐标（由 autoCenterTransform 属性覆盖时除外）。 | AnimateTransform | |
| triggerEvent : Event
如果触发了某个效果，则此项目是由 EffectManager 传递给此 Effect 的 Event 对象；如果 EffectManager 当前没有播放此效果，则为 null。 | Effect | |
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
AnimateTransform3D(target:Object = null)
构造函数。 | AnimateTransform3D | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。 | EventDispatcher | |
|
捕获效果目标上相关属性的当前值，并将这些值另存为结束值。 | Effect | |
|
捕获另一组目标相关属性的当前值。在运行数据更改效果时，Flex 将使用此函数。
| Effect | |
|
捕获效果目标上相关属性的当前值。 | Effect | |
|
创建一个效果实例并对其进行初始化。 | Effect | |
|
获取一个目标对象 Array，并对每个目标调用 createInstance() 方法。 | Effect | |
|
删除实例中的事件侦听器，然后从实例列表中删除该实例。 | Effect | |
|
将事件调度到事件流中。 | EventDispatcher | |
|
中断当前正在播放的效果，立即跳转到该效果的末尾。 | Effect | |
|
返回一个字符串 Array，其中每个 String 都是被此效果更改的属性的名称。 | Effect | |
|
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | |
|
表示对象是否已经定义了指定的属性。 | Object | |
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
|
暂停效果，直到调用 resume() 方法。 | Effect | |
|
开始播放效果。 | Effect | |
|
表示指定的属性是否存在、是否可枚举。 | Object | |
|
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
|
在效果由 pause() 方法暂停后继续播放效果。 | Effect | |
|
逆序播放效果；如果当前正在播放效果，则从该效果的当前位置开始逆序播放。 | Effect | |
|
设置循环操作动态属性的可用性。 | Object | |
|
停止播放效果，使效果目标保持当前状态。 | Effect | |
|
返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。 | Object | |
|
返回指定对象的字符串表示形式。 | Object | |
|
返回指定对象的原始值。 | Object | |
|
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | EventDispatcher | |
applyChangesPostLayout | 属性 |
applyChangesPostLayout:Boolean[覆盖] | 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
由 AnimateTransform 的子类用于指定该效果是否更改布局管理器所用的转换值，或者它是否更改运行布局之后使用的值。因为 Flex 布局系统忽略 3D 转换属性，所以此类会覆盖 AnimateTransform.applyChangesPostLayout 属性，从而为 3D 效果将该默认值设置为 true。
默认值为 true。
实现
override public function get applyChangesPostLayout():Boolean override public function set applyChangesPostLayout(value:Boolean):voidapplyLocalProjection | 属性 |
applyLocalProjection:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
若为 true，则该效果会使用效果中的其它投影相关属性创建透视投影，并在它开始播放时将其应用于目标组件的父项。默认情况下，在效果完成后，会将投影留在父项上；若要在效果结束时删除投影，请将 removeLocalProjectionWhenComplete 设置为 true。
默认值为 true。
实现
public function get applyLocalProjection():Boolean public function set applyLocalProjection(value:Boolean):void相关 API 元素
autoCenterProjection | 属性 |
public var autoCenterProjection:Boolean = true| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
设置为 false 可以禁止 3D 效果自动将投影点设置到目标中心。接着使用 projectionX 和 projectionY 属性将投影点显式设置为投影点距目标 (0, 0) 坐标的偏移量。
这些 3D 效果的工作方式是将三维图像映射到二维表示形式，以在计算机屏幕上显示。投影点定义视野的中心，并控制目标从三维形式投影到屏幕上的方式。
仅在将 applyLocalProjection 设置为 true 时才使用此属性。
默认值为 true。
相关 API 元素
fieldOfView | 属性 |
public var fieldOfView:Number| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
为三维视野指定一个角度（介于 0 度到 180 度之间）。此值可确定应用于具有非零 z 坐标的三维显示对象的透视转换和扭曲的强度。
若角度接近于 0，则表示屏幕的二维 x 和 y 坐标与三维 x、y 和 z 坐标大致相同，只不过具有少许扭曲或无扭曲。换句话说，若角度较小，则沿 z 轴下移的显示对象看起来大小不变且移动距离很小。
若值接近于 180 度，则会产生鱼眼镜头效果，即 z 值小于 0 的位置将被放大，而 z 值大于 0 的位置将被最小化。若角度较大，则沿 z 轴下移的显示对象看起来大小变化很快且移动距离很大。如果视野设置为 0 或 180，则屏幕上不会显示任何内容。
仅在将 applyLocalProjection 设置为 true 时才使用此属性。
相关 API 元素
focalLength | 属性 |
public var focalLength:Number| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
眼睛或视点的原点 (0,0,0) 与位于 z 轴的显示对象之间的距离。在透视转换过程中，将使用视野的角度和舞台的高宽比（舞台宽度除以舞台高度）来自动计算 focalLength。
仅在将 applyLocalProjection 设置为 true 时才使用此属性。
相关 API 元素
projectionX | 属性 |
public var projectionX:Number = 0| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
将投影点设置为投影点在 x 方向距目标 (0, 0) 坐标的偏移量。默认情况下，应用 3D 效果时，该效果会自动将投影点设置为目标的中心。可以将效果的 autoCenterProjection 属性设置为 false 以禁用此默认值，并改为使用 projectionX 和 projectionY 属性。
仅在将 applyLocalProjection 设置为 true 时才使用此属性。
相关 API 元素
projectionY | 属性 |
public var projectionY:Number = 0| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
将投影点设置为投影点在 y 方向距目标 (0, 0) 坐标的偏移量。默认情况下，应用 3D 效果时，该效果会自动将投影点设置为目标的中心。可以将效果的 autoCenterProjection 属性设置为 false 以禁用此默认值，并改为使用 projectionX 和 projectionY 属性。
仅在将 applyLocalProjection 设置为 true 时才使用此属性。
相关 API 元素
removeLocalProjectionWhenComplete | 属性 |
public var removeLocalProjectionWhenComplete:Boolean = false| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
如果为 true，则该效果会在它完成播放时从目标组件的父组件中删除透视投影。默认情况下，保留透视投影。
仅在将 applyLocalProjection 设置为 true 时才使用此属性。
默认值为 false。
相关 API 元素
AnimateTransform3D | () | 构造函数 |
Tue Jun 12 2018, 11:04 AM Z