パッケージfl.motion
クラスpublic class CustomEase
継承CustomEase Inheritance Object
実装 ITween

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9.0.28.0

CustomEase クラスを使用すると、モーショントゥイーンで時間経過に沿ってトゥイーン処理が進行する際のイージングビヘイビアの特定のプロパティを変更できます。カスタムイージング曲線は、少なくとも 1 つの 3 次ベジェ曲線で構成されます。カスタムイージング曲線をすべてのプロパティに対して一度に適用できるほか、個々のプロパティに対してそれぞれ異なる曲線を定義することもできます。

このクラスの実装は、Flash CS4 のカスタムイーズイン / イーズアウトダイアログボックスに相当します。Flash CS4 のカスタムイーズイン / イーズアウトダイアログボックスに、時間経過に沿ったモーションの進度を表すグラフが表示されます。水平軸はフレームを表し、垂直軸はトゥイーンの進行に伴うプロパティの変化率を表します。最初のキーフレームは 0%、最後のキーフレームは 100% として表されます。グラフの曲線の傾きは、オブジェクトの変化の速度を表します。曲線が horizontal である(水平で傾きがない)場合、速度はゼロです。曲線が vertical(垂直)である場合は、瞬間的な変化の発生を示します。

デフォルトの MXML プロパティpoints

関連項目

モーション XML エレメント


パブリックプロパティ
 プロパティ定義元
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  points : Array
カスタムイージング曲線の、順序付けられたポイントのコレクション。
CustomEase
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  target : String
対象となるアニメーションプロパティの名前。
CustomEase
パブリックメソッド
 メソッド定義元
  
CustomEase(xml:XML = null)
CustomEase インスタンスのコンストラクタ。
CustomEase
  
getValue(time:Number, begin:Number, change:Number, duration:Number):Number
数値型のアニメーションプロパティについて、カスタムイージング曲線を使って補間した値を計算します。
CustomEase
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
プロパティの詳細
pointsプロパティ
public var points:Array

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9.0.28.0

カスタムイージング曲線の、順序付けられたポイントのコレクション。配列内の各アイテムは、flash.geom.Point のインスタンスです。各ポイントの x プロパティおよび y プロパティは、0 から 1 までの範囲に収まるように正規化されます。0 はトゥイーンの開始時におけるアニメーションプロパティの値を、1 はトゥイーンの終了時における値を表します。 曲線の最初と最後のポイントは配列に含まれません。なぜなら、最初のポイントは現在のキーフレームによって定義された開始値に固定され、最後のポイントは次のキーフレームによって定義された終了値に固定されるためです。これらのポイントは、カスタムイージング曲線上では、それぞれ (0, 0) と (1, 1) に対応します。

関連項目

targetプロパティ 
target:String  [読み書き可能]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9.0.28.0

対象となるアニメーションプロパティの名前。

デフォルト値 : "".



実装
    public function get target():String
    public function set target(value:String):void

関連項目

コンストラクタの詳細
CustomEase()コンストラクタ
public function CustomEase(xml:XML = null)

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9.0.28.0

CustomEase インスタンスのコンストラクタ。

パラメータ
xml:XML (default = null) — Motion XML 形式で CustomEase を定義する E4X XML オブジェクト (オプション)。
メソッドの詳細
getValue()メソッド
public function getValue(time:Number, begin:Number, change:Number, duration:Number):Number

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9.0.28.0

数値型のアニメーションプロパティについて、カスタムイージング曲線を使って補間した値を計算します。パーセント値は、メソッドの引数ではなく、CustomEase インスタンスの points プロパティを読み取ることによって取得されます。このプロパティの値を使用することにより、関数のシグネチャを ITween インターフェイスに合わせることができます。

パラメータ

time:Number0 から duration までの時間値。 単位は自由に選択できますが ( フレーム、秒、ミリ秒など)、duration の単位と合わせる必要があります。
 
begin:Number — トゥイーンの開始時、つまり、時間値が 0 のときのアニメーションプロパティの値。
 
change:Number — トゥイーン処理におけるアニメーションプロパティの値の変化。正の値だけでなく、負の値を使用することもできます。例えば、オブジェクトを 90 度から 60 度まで回転させる場合、change-30 になります。
 
duration:Number — トゥイーンの時間の長さ。ゼロより大きな値を指定する必要があります。単位は自由に選択できますが (フレーム、秒、ミリ秒など)、time の単位と合わせる必要があります。

戻り値
Number — 指定された時点における補間値。

関連項目