| パッケージ | 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 [オーバーライド]
Layout Manager によって使用された変換値をエフェクトが変更するかどうか、つまりレイアウトが実行された後で使用された値を変更するかどうかを指定するために、AnimateTransform のサブクラスによって使用されます。 | AnimateTransform3D | ||
| applyLocalProjection : Boolean
true の場合、投影関連の他のプロパティを使用して遠近法に基づく投影が作成され、再生開始時にターゲットコンポーネントの親に投影が適用されます。 | AnimateTransform3D | ||
| autoCenterProjection : Boolean = true
3D エフェクトが投影ポイントをターゲットの中心に自動的に設定しないようにするには、false に設定します。 | 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
3 次元の視野について、角度を 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 オブジェクトのベクターです。各オブジェクトには、アニメーション化するプロパティの名前と、アニメーション実行期間においてプロパティが受け取る値が保持されます。 | Animate | |
| perElementOffset : Number
エフェクトの最初のターゲットの後に発生する、エフェクトターゲットの追加遅延（ミリ秒）です。 | Effect | |
| playheadTime : Number
エフェクトの現在の時間位置です。 | Effect | |
| projectionX : Number = 0
ターゲットの (0, 0) 座標からの x 方向への投影ポイントのオフセットとして、投影ポイントを設定します。 | AnimateTransform3D | ||
| projectionY : Number = 0
ターゲットの (0, 0) 座標からの y 方向への投影ポイントのオフセットとして、投影ポイントを設定します。 | AnimateTransform3D | ||
| relevantProperties : Array
フィルタリング実行時に使用するプロパティ名の配列を表します。 | Effect | |
| relevantStyles : Array
フィルタリング実行時に使用するスタイル名の配列を表します。 | Effect | |
| removeLocalProjectionWhenComplete : Boolean = false
true の場合、エフェクトは再生の完了時に、ターゲットコンポーネントの親から遠近法に基づく投影を削除します。 | AnimateTransform3D | ||
| startDelay : int = 0
エフェクトを開始する前の待機時間を表します（ミリ秒単位）。 | Effect | |
| target : Object
このエフェクトが適用されるオブジェクトを表します。 | Effect | |
| targets : Array
エフェクトのターゲットであるオブジェクトの配列を表します。 | Effect | |
| transformX : Number
autoCenterTransform プロパティによってオーバーライドされない場合、変換の中心の x 座標を設定します。 | AnimateTransform | |
| transformY : Number
autoCenterTransform プロパティによってオーバーライドされない場合、変換の中心の y 座標を設定します。 | AnimateTransform | |
| transformZ : Number
autoCenterTransform プロパティによってオーバーライドされない場合、変換の中心の z 座標を設定します。 | 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 | |
|
1 つのエフェクトインスタンスを作成し、それを初期化します。 | Effect | |
|
ターゲットオブジェクトの配列を取得し、各ターゲットで createInstance() メソッドを呼び出します。 | Effect | |
|
インスタンスからイベントリスナーを削除し、インスタンスのリストからインスタンスを削除します。 | Effect | |
|
イベントをイベントフローに送出します。 | EventDispatcher | |
|
現在再生中のエフェクトをすべて中断し、直ちにエフェクトの終わりにジャンプします。 | Effect | |
|
ストリングの配列を返します。各ストリングは、このエフェクトによって変更されるプロパティの名前です。 | 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 |
Layout Manager によって使用された変換値をエフェクトが変更するかどうか、つまりレイアウトが実行された後で使用された値を変更するかどうかを指定するために、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 |
3D エフェクトが投影ポイントをターゲットの中心に自動的に設定しないようにするには、false に設定します。その後、projectionX プロパティと projectionY プロパティを使用して、ターゲットの (0, 0) 座標からのオフセットとして投影ポイントを明示的に設定します。
3D エフェクトは、3D イメージをコンピューターの画面に表示するための 2D 表現にマッピングすることで動作します。投影ポイントは、視野の中心を定義し、ターゲットが 3 次元から画面に投影される方法を制御します。
このプロパティは、applyLocalProjection が true に設定されているときにのみ使用されます。
デフォルト値： true。
関連する API エレメント
fieldOfView | プロパティ |
public var fieldOfView:Number| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
3 次元の視野について、角度を 0 ～ 180 度で指定します。この値は、0 以外の z 座標の 3 次元の表示オブジェクトに適用される、遠近法に基づく変形と歪みの強さを決定します。
0 に近い角度は、画面の 2 次元の x 座標と y 座標が、ほとんどまたはまったく歪みのない 3 次元の 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 |
ターゲットの (0, 0) 座標からの x 方向への投影ポイントのオフセットとして、投影ポイントを設定します。デフォルトでは、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 |
ターゲットの (0, 0) 座標からの y 方向への投影ポイントのオフセットとして、投影ポイントを設定します。デフォルトでは、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, 10:34 AM Z