API version 1

- ‐

R

number

position

アニメーション実行中のプロパティ変化量の相対値を示します。

子オブジェクトのAnimationParameterクラスのfromプロパティの値が0となり、toプロパティの値が1となるような、アニメーション実行中のプロパティ変化量を相対化した値を取得します。

positionプロパティの値は通常0から1の範囲に収まり、負数になることはありませんが、easingプロパティの値がEASINGTYPE_ELASTIC, EASINGTYPE_BACKの場合は1より大きな値をとることがあります。

関連項目

easing、AnimationParameter.from、AnimationParameter.toプロパティ

使用例 CRSダウンロード

Form Animation_properties {
   X = 0;
   Y = 0;
   Width = 400;
   Height = 300;
   Button buttonStart {
           x = 8;
           y = 8;
           width = 104;
           height = 24;
           title = "実行";
           Function OnTouch( e ) {
                   #アニメーション実行状態を取得し、未実施時のみブロック内のCRSコードを実行します
                   if (!^.anim.isAnimating) {
                           ^.anim.start();
                   }
           }
   }
   Label labelAnimation {
           x = 120;
           y = 20;
           width = 100;
           height = 30;
           Title = "Animation Sample";
           bgColor = "#80FFFF";
   }

   Animation anim {
           #アニメーションの実行方向をALTERNATEに設定します
           direction = DIRECTION_ALTERNATE;

           #アニメーション実行時間を5秒に設定します
           duration = 5.0;

           #アニメーション実行時の数値変化パターンをSWINGに設定します
           easing = EASINGTYPE_SWING;

           #アニメーション中に描画が間に合わなくても描画をスキップしないようにします
           frameSkip = false;

           #アニメーション実行中の描画間隔を0.2秒に設定します
           interval = 0.2;

           function onProceed(e) {
                   #アニメーション実行中の実行方向、プロパティ変化量の相対量、相対時間を取得し表示します
                   print("animatingDirection=", (animatingDirection == DIRECTION_FORWARD ? "FORWARD" : "BACKWARD")
                     , ", position=", position
                     , ", time=", time);
           }

           AnimationParameter param {
                   target = ^.^.labelAnimation;
                   propertyName = "Y";
                   from = 20;
                   to = 260;
           }
   }
}