spark.effects.animationKeyframe Keyframe クラスは、エフェクト実行期間の特定の時間におけるプロパティの値を定義します。The <s:Keyframe> tag inherits the tag attributes of its superclass, and adds the following tag attributes:

  <s:Keyframe 
    id="ID"
    easier="Linear"
    time="val"
    value="val"
    valueBy="val"
  />
]]>Object Keyframe クラスは、エフェクト実行期間の特定の時間におけるプロパティの値を定義します。例えば、エフェクトの最初、エフェクトの中間およびエフェクトの最後におけるプロパティの値を定義する、3 つのキーフレームを作成できます。エフェクトは、エフェクトの継続時間にわたってキーフレームからキーフレームへと、ターゲットに対するプロパティの変更をアニメーション化します。

エフェクトのキーフレームのコレクションは、エフェクトのモーションパスと呼ばれます。モーションパスでは、任意の数のキーフレームを定義できます。その後、エフェクトは、2 つのキーフレームで指定された値の間を補間することによってプロパティの値を計算します。

MotionPath クラスを使用して、エフェクトのモーションパスを表す Keyframe オブジェクトのコレクションを保持します。MotionPath クラスは、ターゲットのプロパティの名前を指定し、Keyframe オブジェクトのコレクションは、エフェクト実行期間の異なる時間におけるプロパティの値を指定します。

MotionPathKeyframe コンストラクターです。timeunknownこのキーフレームのエフェクトターゲットが、value パラメーターによって指定された値を保持する必要がある時間です（ミリ秒単位）。 valuenull指定された time においてエフェクトターゲットが保持する必要がある値です。 valueBynull指定された場合に、MotionPath オブジェクト内の一連のキーフレームにおいて valueBy を前のキーフレームの value に追加することによって value が動的に計算されるようにする、オプションのパラメーターです。これがシーケンスに含まれる最初の Keyframe である場合、この値は無視されます。 コンストラクターです。 clone この Keyframe オブジェクトのコピーを返します。この Keyframe オブジェクトのコピーです。 spark.effects.animation:Keyframe この Keyframe オブジェクトのコピーを返します。 easer モーションパスにある前の Keyframe オブジェクトとこの Keyframe オブジェクトの間のモーションに適用されるイージングビヘイビアーです。unknownspark.effects.easing:IEaserLinear モーションパスにある前の Keyframe オブジェクトとこの Keyframe オブジェクトの間のモーションに適用されるイージングビヘイビアーです。デフォルトでは、イージングは線形です。つまり、イージングはまったく行われません。

親エフェクトによりアニメーション全体にわたって既にイージングが適用されている可能性があることに注意してください。したがって、代わりにキーフレーム間隔ごとのイージングを行う場合、エフェクトイーザー全体を線形イージング（spark.effects.easing.Linear）に設定した後、必要に応じて、各 Keyframe で easer を設定することが必要になります。

このプロパティは、シーケンスにある前の Keyframe オブジェクトとこの Keyframe オブジェクトの間の間隔に対して作用するため、シーケンスにある最初の Keyframe オブジェクトでは easer プロパティは無視されます。

time このキーフレームのエフェクトターゲットが、value プロパティによって指定された値を保持する必要がある時間です（ミリ秒単位）。 このキーフレームのエフェクトターゲットが、value プロパティによって指定された値を保持する必要がある時間です（ミリ秒単位）。この時間は、このキーフレームと共に定義されたエフェクトの開始時間を基準とします。 valueBy 指定された場合に、このキーフレームまたは前のキーフレームで value を計算するために使用される、オプションのパラメーターです。 指定された場合に、このキーフレームまたは前のキーフレームで value を計算するために使用される、オプションのパラメーターです。前のキーフレームで value が設定されていない場合にこのキーフレームで value と valueBy の両方が定義されていると、前のキーフレームの value が、このキーフレームの value からこのキーフレームの valueBy を減算した値として計算されます。

同様に、このキーフレームの value が定義されていない場合にこのキーフレームの valueBy と前のキーフレームの value の両方が設定されていると、このキーフレームの value が、前のキーフレームの value にこのキーフレームの valueBy を加算した値として計算されます。

シーケンスにある最初のキーフレームでは valueBy は無視されます。これは、このプロパティが、キーフレームに先行する間隔のみに適用され、この先行する間隔が最初のキーフレームにはないためです。

value time プロパティによって指定された時間においてエフェクトターゲットのプロパティが保持する必要がある値です。 time プロパティによって指定された時間においてエフェクトターゲットのプロパティが保持する必要がある値です。 IAnimationTarget IAnimationTarget インターフェイスは、Animation インスタンスのイベントをサポートするクラスによって実装されます。 IAnimationTarget インターフェイスは、Animation インスタンスのイベントをサポートするクラスによって実装されます。 spark.effects.animation.AnimationanimationEnd Animation インスタンスが終了するときに呼び出されます。animationspark.effects.animation:AnimationAnimation オブジェクトです。 Animation インスタンスが終了するときに呼び出されます。 animationRepeat Animation インスタンスが繰り返されるときに呼び出されます。animationspark.effects.animation:AnimationAnimation オブジェクトです。 Animation インスタンスが繰り返されるときに呼び出されます。Animation インスタンスには、0（無限に繰り返す）、または 1 よりも大きい値に等しい、repeatCount が設定されている必要があります。 animationStart Animation インスタンスが開始されるときに呼び出されます。animationspark.effects.animation:AnimationAnimation オブジェクトです。 Animation インスタンスが開始されるときに呼び出されます。Animation に startDelay がある場合、その遅延の後にこの関数が呼び出されます。 animationStop Animation インスタンスが停止するときに呼び出されます。animationspark.effects.animation:AnimationAnimation オブジェクトです。 Animation インスタンスが停止するときに呼び出されます。これは animationEnd() メソッドとは異なります。animationEnd() メソッドはアニメーションが終了するときに呼び出されて、ターゲットの終了値を自動的に設定します。animationStop() メソッドは、アニメーションがその位置で停止されるときに呼び出されます。このイベントを処理すると、アニメーションが中止されるときに必要なクリーンアップを行うことができます。 animationUpdate Animation インスタンスのすべての更新時に呼び出されます。animationspark.effects.animation:AnimationAnimation オブジェクトです。 Animation インスタンスのすべての更新時に呼び出されます。指定された時間において Animation の値が計算された後で何らかの処理を実行できるように、実装クラスが Animation を明示的にリッスンしている場合、この関数でそれらの値を使用する必要があります。このインターフェイスの残りのメソッドは、より多くの情報を提供します。これらのメソッドは、アニメーションの開始、停止、または繰り返しをリスナーに通知します。このメソッドは、値が計算されてそれらの値で何らかの処理を行えるようになったときに呼び出されます。 MotionPath MotionPath クラスは、エフェクト用の Keyframe オブジェクトのコレクションと、アニメーション化するターゲットのプロパティの名前を定義します。The <s:MotionPath> tag inherits the tag attributes of its superclass, and adds the following tag attributes:

  <s:MotionPath 
    id="ID"
    interpolator="NumberInterpolator"
    keyframes="val"
    property="val"
  />
]]>Object MotionPath クラスは、エフェクト用の Keyframe オブジェクトのコレクションと、アニメーション化するターゲットのプロパティの名前を定義します。各 Keyframe オブジェクトは、エフェクト実行期間の特定の時間におけるプロパティの値を定義します。その後、エフェクトは、2 つのキーフレームで指定された値の間を補間することによってターゲットプロパティの値を計算します。 Keyframespark.effects.interpolation.NumberInterpolatorMotionPath コンストラクターです。propertynullアニメーション化するターゲットのプロパティの名前を表します。 コンストラクターです。 clone 各キーフレームのコピーを含む、この MotionPath オブジェクトのコピーを返します。各キーフレームのコピーを含む、この MotionPath オブジェクトのコピーです。 spark.effects.animation:MotionPath 各キーフレームのコピーを含む、この MotionPath オブジェクトのコピーを返します。 getValue 経過時間の割合が指定されると、補間された値を計算して返します。補間された値です。 fractionエフェクトの継続時間全体のうちの割合です（0.0 ～ 1.0 の値で示されます）。 経過時間の割合が指定されると、補間された値を計算して返します。この関数は、その割合が収まるキーフレーム間隔を特定してから、その間隔上にある境界キーフレームの値の間を対象にその間隔内を補間します。 interpolator インターポレーターは、アニメーション内にある中間の値を計算する方法を決定します。unknownspark.effects.interpolation:IInterpolator インターポレーターは、アニメーション内にある中間の値を計算する方法を決定します。デフォルトでは、MotionPath クラスは値が Number 型であると見なし、中間の Number 値を自動的に計算できます。MotionPath クラスに Number ではない値のキーフレームが指定される場合、または目的のビヘイビアーにおいて異なる補間方法（チャンネルごとのカラー補間など）を使用する必要がある場合、インターポレーターを提供する必要があります。

Flex では、spark.effects.interpolation パッケージに定義済みのインターポレーターが用意されています。

keyframes アニメーション実行期間にプロパティが受け取る、時間と値のペアを表す Keyframe オブジェクトのシーケンスです。 アニメーション実行期間にプロパティが受け取る、時間と値のペアを表す Keyframe オブジェクトのシーケンスです。連続するキーフレームの各ペアは、それらの間の時間間隔にわたってアニメーションを制御します。後のキーフレームに関する、オプションの easer プロパティと valueBy プロパティは、その間隔にわたるビヘイビアーを決定するために使用されます。キーフレームのシーケンスは、時間の値が増加する順にソートする必要があります。

アニメーションは常に時間 = 0 から開始し、最終キーフレームの time 値に等しい継続時間にわたって実行されます。時間 = 0 においてキーフレームが定義されていない場合、そのキーフレームは暗黙的になり、アニメーション開始時のターゲットプロパティの値を使用します。

キーフレームはアニメーションに含まれる時間を明示的に定義するため、キーフレームを使用するエフェクトの継続時間は、エフェクトにある全 MotionPath の最終キーフレームの最大時間に従って設定されます。例えば、エフェクトでキーフレームが 0、500、1000、2000 の各時間に存在する場合、エフェクト自体にどのような duration プロパティが設定されているかにかかわらず、そのエフェクトでは 2000 ミリ秒が実際の継続時間になります。継続時間は最終キーフレームによって決まるため、どの MotionPath にも必ず最終キーフレームが存在する必要があります。つまり、最終キーフレームの時間が暗黙的に MotionPath の継続時間になります。

キーフレームでは、その value を未定義の状態で残すことができます（値を設定しないか、null に設定するか、NaN に設定することができます）。その場合は、アニメーションの開始時に値が動的に決定されます。未定義の値は次のように決定されます。

  1. 未定義の値が最初のキーフレームにある場合、次のキーフレームに value と valueBy の両方のプロパティが設定されていれば、そのキーフレームから、これらの値の差として値が計算されます。それ以外の場合は、ターゲットからプロパティの現在の値が取得されます。
  2. 未定義の値が最終キーフレームにあり、アニメーションがトランジションで実行中である場合、トランジションのターゲットビューステートにある値が使用されます。
  3. それ以外の場合は、現在のキーフレームで valueBy が設定されていれば、前のキーフレームの value を使用してそれに現在のキーフレームの valueBy を追加することによって、その value が計算されます。
Keyframeproperty アニメーション化するエフェクトターゲットのプロパティの名前です。 アニメーション化するエフェクトターゲットのプロパティの名前です。 RepeatBehavior RepeatBehavior クラスは、Animate クラスと Animation クラスの repeatBehavior プロパティと共に使用する定数を定義します。Object RepeatBehavior クラスは、Animate クラスと Animation クラスの repeatBehavior プロパティと共に使用する定数を定義します。 spark.effects.Animate.repeatBehaviorAnimation.repeatBehaviorLOOP 繰り返すアニメーションが、すべての繰り返しで順方向に進むように指定します。loop 繰り返すアニメーションが、すべての繰り返しで順方向に進むように指定します。 REVERSE 繰り返すアニメーションが、すべての繰り返しで逆方向になるように指定します。reverse 繰り返すアニメーションが、すべての繰り返しで逆方向になるように指定します。例えば、反転するアニメーションは、偶数番目の繰り返しでは順方向に再生し、奇数番目の繰り返しでは逆方向に再生します。 SimpleMotionPath SimpleMotionPath クラスは、Animate エフェクトのインスタンスについて、プロパティの名前と、そのプロパティが時間の経過と共に受け取る値を指定します。spark.effects.animation:MotionPath SimpleMotionPath クラスは、Animate エフェクトのインスタンスについて、プロパティの名前と、そのプロパティが時間の経過と共に受け取る値を指定します。

このクラスは、valueFrom、valueTo、valueBy の各プロパティを保持する 2 つのキーフレームを定義する、MotionPath の単純なサブクラスです。MotionPath クラス自体は、任意の数のキーフレームを定義できます。

MotionPathSimpleMotionPath コンストラクターです。propertynullアニメーション化されるプロパティの名前です。 valueFromnullプロパティの初期値です。 valueTonullプロパティの終了値です。 valueBynullfrom または to の値を計算するためのデルタを指定する、オプションのパラメーターです。一方の値が省略されている場合に使用します。 コンストラクターです。valueFrom と valueTo の両方のパラメーターを指定するか、あるいは valueBy パラメーターと、valueFrom または valueTo のいずれかのパラメーターを指定することができます。これらのパラメーターを省略すると、Flex によってエフェクトターゲットからこれらの値が計算されます。 valueBy valueFrom または valueTo の値を計算するために使用されるデルタを指定するオプションプロパティです。 valueFrom または valueTo の値を計算するために使用されるデルタを指定するオプションプロパティです。このオプションプロパティを提供すると、必要な from または to の値の一方が提供されていないかアニメーションの開始時に動的に決定される予定である場合に、その値をエフェクトが計算できるようになります。

valueBy の値が使用される方法は、他にどちらの値が設定されるかによって異なります。どちらの値も設定されなかった場合、valueFrom の値はターゲットの現在のプロパティ値から決定され、valueTo の値は valueFrom + valueBy になります。どちらか一方の値のみが設定された場合、未設定の値は他方の値によって計算されます（valueTo = valueFrom + valueBy または valueFrom = valueTo - valueBy）。両方の値が設定された場合、valueBy プロパティは無視されます。

valueBy は Object 型であるため、エフェクトがそれを使用して他の値を直接計算できないことに注意してください。エフェクトはエフェクトのインターポレーターを使用して、インターポレーターの increment() メソッドと decrement() メソッドを呼び出すことによって値を計算します。インターポレーターが設定されていない場合、デフォルトで NumberInterpolator が使用されます。

valueFrom アニメーション実行期間におけるプロパティの開始値です。 アニメーション実行期間におけるプロパティの開始値です。

Null または NaN（Number の場合）の値は、実行時に動的に値を決定する必要があることを示します。この場合、値をターゲットプロパティから直接取得するか、または、他方の値が有効であり、かつ有効な valueBy の値も提供されている場合は値を計算します。

valueTo 名前付きプロパティをアニメーション化するときの終了値です。 名前付きプロパティをアニメーション化するときの終了値です。

Null または NaN（Number の場合）エレメントの値は、実行時に動的に値を決定する必要があることを示します。この場合、値をターゲットプロパティから直接取得するか、または、他方の値が有効であり、かつ有効な valueBy の値も提供されている場合は値を計算します。

Animation Animation クラスは、指定された期間にわたってプロパティの開始値と終了値の間で実行される、アニメーションを定義します。Object Animation クラスは、指定された期間にわたってプロパティの開始値と終了値の間で実行される、アニメーションを定義します。アニメーションに該当するのは、（Move エフェクトなどで実行される）位置の変化、（Resize エフェクトなどで実行される）サイズの変化、（Fade エフェクトなどで実行される）可視性の変化、または（エフェクトによって使用されるか Animation クラスで直接実行される）他のタイプのアニメーションです。

このクラスは、アニメーションのタイミングと値の部分を定義します。エフェクトまたはアプリケーションコードにある他のコードは、アニメーションをターゲットオブジェクトとプロパティに関連付けます。その際、Animation クラスによって作成されたアニメーション値がその後ターゲットオブジェクトとプロパティに適用されることで、実際にこれらのオブジェクトがアニメーション化されます。

アニメーションエフェクトを定義する場合は、通常、Animate クラスのインスタンス、または Animate のサブクラスのインスタンスを作成します。これにより、Animation インスタンスが play() メソッドに作成されます。Animation インスタンスは、開始値と終了値、継続時間、およびオプションパラメーター（イーザーオブジェクト、インターポレーターオブジェクトなど）を受け取ります。

Animation オブジェクトは、アニメーションの開始時と終了時、アニメーションの繰り返し時、およびアニメーション実行期間における一定間隔の更新時に、イベントリスナーを呼び出します。これらの呼び出しでは、Animation インスタンスが開始値と終了値およびイーザーオブジェクトとインターポレーターオブジェクトから計算した値が渡されます。その後、これらの値はターゲットオブジェクトのプロパティ値を設定するために使用されます。

spark.effects.Animatespark.effects.supportClasses.AnimateInstanceAnimation コンストラクターです。duration500アニメーションの長さです（ミリ秒単位）。 propertynullアニメーション化するプロパティです。 startValuenullプロパティの初期値です。 endValuenullプロパティの終了値です。 コンストラクターです。オプションの property パラメーター、startValue パラメーター、および endValue パラメーターは、2 つの Keyframe がある単一の MotionPath オブジェクトを使用して、単純なアニメーションを定義します。いずれかの値が null でない場合、startValue は最初のキーフレームの value（時間 = 0）になり、endValue は 2 番目のキーフレームの value（アニメーションの最後）になります。 end アニメーションを中止して、すぐにアニメーションの最後のジャンプし、animationTarget で animationEnd() 関数を呼び出します。 アニメーションを中止して、すぐにアニメーションの最後のジャンプし、animationTarget で animationEnd() 関数を呼び出します。 pause resume() メソッドが呼び出されるまでエフェクトを一時停止します。 resume() メソッドが呼び出されるまでエフェクトを一時停止します。stop() が resume() の前に呼び出されると、アニメーションを再開できません。 play アニメーションを開始します。 アニメーションを開始します。アニメーションが既に再生されている場合は、最初に停止し、その後再生されます。 resume pause() メソッドを呼び出し、エフェクトを一時停止した後、再開させます。 pause() メソッドを呼び出してエフェクトを一時停止した後、再開させます。 stop アニメーションを停止し、end() メソッドを呼び出さないで終了します。 アニメーションを停止し、end() メソッドを呼び出さないで終了します。animationTarget で animationStop() 関数が呼び出されます。 currentValue Animation の現在のフレームまでについて計算された値を含む Object です。 Animation の現在のフレームまでについて計算された値を含む Object です。キーとしてプロパティ名を使用し、マップ値として値が格納されます。 duration repeatCount プロパティによって定義された繰り返しをカウントしない、アニメーションの時間の長さです（ミリ秒単位）。500500 repeatCount プロパティによって定義された繰り返しをカウントしない、アニメーションの時間の長さです（ミリ秒単位）。 interpolator プロパティの開始値と終了値の間の値を計算するために Animation インスタンスによって使用されるインターポレーターです。nullspark.effects.interpolation:IInterpolator プロパティの開始値と終了値の間の値を計算するために Animation インスタンスによって使用されるインターポレーターです。デフォルトでは、このクラスは NumberInterpolator クラスを使用します。または、開始値と終了値が配列または Vector である場合は、MultiValueInterpolator クラスを使用します。他のデータ型の補間、または異なる方法で補間する必要がある Number（カラーチャンネル情報を保持する uint 値など）の補間は、異なるインターポレーターを提供することによって処理できます。 spark.effects.interpolation.NumberInterpolatorspark.effects.interpolation.MultiValueInterpolatormotionPaths Animation で時間の経過と共にアニメーション化するプロパティと値を定義する、MotionPath オブジェクトのセットです。 Animation で時間の経過と共にアニメーション化するプロパティと値を定義する、MotionPath オブジェクトのセットです。 spark.effects.animation.MotionPathanimationTarget このアニメーションにおいて、開始、終了、繰り返し、更新のすべてのイベントで通知される、IAnimationTarget オブジェクトです。spark.effects.animation:IAnimationTargetnull このアニメーションにおいて、開始、終了、繰り返し、更新のすべてのイベントで通知される、IAnimationTarget オブジェクトです。値が null の場合、通知するターゲットがないことを示します。 cycleFraction イージングが適用された後で経過したアニメーションの現在の割合です。 イージングが適用された後で経過したアニメーションの現在の割合です。この値の範囲は 0 ～ 1 です。アニメーションの「サイクル」は、アニメーションの 1 回の繰り返しと定義され、repeatCount プロパティは再生されるサイクルの数を定義します。 cycleTime 現在のサイクルのアニメーションでの、現在のミリ秒位置です。 現在のサイクルのアニメーションでの、現在のミリ秒位置です。この値の範囲は 0 ～ duration です。アニメーションの「サイクル」は、アニメーションの 1 回の繰り返しと定義され、repeatCount プロパティは再生されるサイクルの数を定義します。アニメーションの位置を変更するには、seek() メソッドを使用します。 easer このエフェクトのイージングビヘイビアーです。spark.effects.easing:IEaserSine(.5) このエフェクトのイージングビヘイビアーです。この IEaser オブジェクトは、アニメーションの経過割合をイージング割合に変換するために使用され、これが後でその経過イージング割合で値を計算するために使用されます。

値が null の場合は、イージングが使用されないことを意味し、これは Linear イージングを使用すること、つまり animation.easer = Linear.getInstance(); と同じです。

isPlaying true の場合、アニメーションは現在再生中です。false true の場合、アニメーションは現在再生中です。アニメーションが再生されており、まだ（プログラムによって、または自動的に）停止されておらず、かつ一時停止もされていない場合を除き、この値は false です。 playReversed true の場合、逆順でアニメーションを再生します。false true の場合、逆順でアニメーションを再生します。現在アニメーションが playReversed で指定されている値とは逆の方向に再生している場合、アニメーションは動的に方向を変更します。 playheadTime 開始遅延と繰り返しを含む、アニメーションの合計経過時間です。 開始遅延と繰り返しを含む、アニメーションの合計経過時間です。その最初のサイクルを再生しているアニメーションの場合、この値は cycleTime の値と等しくなります。 repeatBehavior 繰り返すアニメーションのビヘイビアーを設定します。RepeatBehavior.LOOP 繰り返すアニメーションのビヘイビアーを設定します。繰り返すアニメーションの repeatCount プロパティは、0 に設定されるか、または 1 よりも大きい値に設定されます。この値は、RepeatBehavior.LOOP（毎回同じ順番でアニメーションを繰り返す）または RepeatBehavior.REVERSE（繰り返しのたびにアニメーションの方向を逆にする）である必要があります。 spark.effects.animation.RepeatBehaviorrepeatCount このアニメーションを繰り返す回数です。1 このアニメーションを繰り返す回数です。値が 0 の場合、無限に繰り返されます。 repeatDelay 各繰り返しサイクルを開始する前の遅延時間です（ミリ秒単位）。0 各繰り返しサイクルを開始する前の遅延時間です（ミリ秒単位）。この値をゼロ以外の数値に設定すると、その終了値で正確に前のアニメーションサイクルが終了します。ただし、遅延のない繰り返しの場合、あるサイクルの終わりに近づいてから次のサイクルの始まりを経過するまでアニメーションがスムーズに移行されるため、その値を完全に飛び超える可能性があります。このプロパティは、0 以上の値である必要があります。

このプロパティは、最初のアニメーションサイクルの後、最初の繰り返しで使用されます。アニメーションの最初のサイクルを遅延させるには、startDelay プロパティを使用します。

startDelaystartDelay アニメーションを開始する前に待機する時間です。0 アニメーションを開始する前に待機する時間です。このプロパティは、0 以上の値である必要があります。