Back to Qt.io
Contact Us Blog Download Qt

Animator QML Type

すべての QML アニメータの基本です。詳細...

Import Statement: import QtQuick
Inherits:

Animation

Inherited By:

OpacityAnimator, RotationAnimator, ScaleAnimator, UniformAnimator, XAnimator, and YAnimator

プロパティ

詳しい説明

Animator型は、通常のAnimation型のようにQMLオブジェクトやそのプロパティを操作するのではなく、Qt Quickのシーングラフを直接操作する特殊なアニメーションです。このため、UI スレッドがブロックされている場合でも、シーングラフのレンダリングスレッドでアニメーションを行うことができます。

QML プロパティの値はアニメーション終了後に更新されます。アニメーションの実行中にプロパティが更新されることはありません。

Animator タイプは他の Animation タイプと同様に使用することができます。

Rectangle {
    id: mixBox
    width: 50
    height: 50
    ParallelAnimation {
        ColorAnimation {
            target: mixBox
            property: "color"
            from: "forestgreen"
            to: "lightsteelblue";
            duration: 1000
        }
        ScaleAnimator {
            target: mixBox
            from: 2
            to: 1
            duration: 1000
        }
        running: true
    }
}

ParallelAnimation とSequentialAnimation のすべてのサブアニメーションが Animator タイプの場合、ParallelAnimation とSequentialAnimation も Animator として扱われ、可能な限りシーングラフのレンダリングスレッドで実行されます。

Animatorタイプはトランジション中のアニメーションに使用できますが、reversible プロパティには対応していません。

AnimatorタイプはQMLファイルで直接使用することはできません。Animatorは共通のプロパティとメソッドを提供するために存在し、それを継承する他のすべてのAnimatorタイプで利用可能です。Animator型を直接使用しようとするとエラーになります。

プロパティの説明

duration : int

このプロパティは、アニメーションの継続時間をミリ秒単位で保持します。

デフォルト値は 250 です。


easing group

easing.amplitude : real

easing.bezierCurve : list<real>

easing.overshoot : real

easing.period : real

easing.type : enumeration

アニメーションに使用するイージングカーブを指定します。

イージングカーブを指定するには、少なくともタイプを指定する必要があります。いくつかのカーブでは、振幅、周期、オーバーシュートも指定できます (詳細は表の後で説明します)。デフォルトのイージングカーブはEasing.Linear です。

PropertyAnimation { properties: "y";
                    easing.type: Easing.InOutElastic;
                    easing.amplitude: 2.0;
                    easing.period: 1.5 }

利用可能なタイプは以下の通りです：

Easing.Linear一次 (t) 関数のイージングカーブ: 速度は一定。
Easing.InQuad2次 (t^2) 関数のイージングカーブ: 速度ゼロからの加速。
Easing.OutQuad2次(t^2)関数の緩和曲線：速度ゼロから減速する。
Easing.InOutQuad二次関数(t^2)の緩和曲線：途中まで加速、その後減速。
Easing.OutInQuad次関数(t^2)の緩和曲線：途中まで減速、その後加速。
Easing.InCubic次関数(t^3)のイージングカーブ：速度ゼロからの加速。
Easing.OutCubic次関数(t^3)の緩和曲線：速度ゼロから減速する。
Easing.InOutCubic次関数(t^3)のイージングカーブ：途中まで加速、その後減速。
Easing.OutInCubic次関数(t^3)の緩和曲線：途中まで減速、その後加速。
Easing.InQuart次関数(t^4)の緩和曲線：速度ゼロからの加速。
Easing.OutQuart次関数(t^4)の緩和曲線：速度ゼロからの減速。
Easing.InOutQuart4次関数(t^4)の緩和曲線：途中まで加速し、その後減速する。
Easing.OutInQuart4次(t^4)関数の緩和曲線：途中まで減速、その後加速。
Easing.InQuint5次関数(t^5)の緩和曲線：速度ゼロからの加速。
Easing.OutQuint5次関数(t^5)の緩和曲線：速度ゼロからの減速。
Easing.InOutQuint5次関数(t^5)の緩和曲線：途中まで加速し、その後減速。
Easing.OutInQuint5進(t^5)関数の緩和曲線：途中まで減速、その後加速。
Easing.InSine正弦波(sin(t))関数のイージングカーブ：速度ゼロからの加速。
Easing.OutSine正弦波(sin(t))関数の緩和曲線：速度ゼロから減速する。
Easing.InOutSine正弦波(sin(t))関数のイージングカーブ：途中まで加速し、その後減速する。
Easing.OutInSine正弦波(sin(t))関数の緩和曲線：途中まで減速し、それから加速する。
Easing.InExpo指数(2^t)関数の緩和曲線：速度ゼロからの加速。
Easing.OutExpo指数(2^t)関数の緩和曲線：速度ゼロから減速する。
Easing.InOutExpo指数(2^t)関数の緩和曲線：途中まで加速し、それから減速する。
Easing.OutInExpo指数関数(2^t)の緩和曲線：途中まで減速し、それから加速する。
Easing.InCirc円(sqrt(1-t^2))関数の緩和曲線：速度ゼロからの加速。
Easing.OutCirc円(sqrt(1-t^2))関数の緩和曲線：速度ゼロから減速する。
Easing.InOutCirc円(sqrt(1-t^2))関数の緩和曲線：途中まで加速し、その後減速する。
Easing.OutInCirc円(sqrt(1-t^2))関数の緩和曲線：途中まで減速し、それから加速。
Easing.InElastic弾性（指数関数的に減衰する正弦波）関数のイージングカーブ：速度ゼロからの加速。
ピークの振幅はamplitudeパラメータで、減衰の周期はperiodパラメータで設定できます。
Easing.OutElastic弾性（指数関数的に減衰する正弦波）関数の緩和曲線：速度ゼロまで減速する。
ピークの振幅はamplitudeパラメータで、減衰の周期はperiodパラメータで設定します。
Easing.InOutElastic弾性（指数関数的に減衰する正弦波）関数のイージングカーブ：途中まで加速し、その後減速する。
Easing.OutInElastic弾性（指数関数的に減衰する正弦波）関数のイージングカーブ：途中まで減速、その後加速。
Easing.InBackバック（オーバーシュート3次関数：(s+1)*t^3 - s*t^2）のイージングカーブ：速度ゼロからの加速。
Easing.OutBackバックのイージングカーブ（オーバーシュート3次関数：(s+1)*t^3 - s*t^2） イージングアウト：速度ゼロから減速。
Easing.InOutBackバックのイージングカーブ（オーバーシュート3次関数：(s+1)*t^3 - s*t^2） イージングイン/アウト：途中まで加速、その後減速。
Easing.OutInBackバックのイージングカーブ（オーバーシュート3次関数：(s+1)*t^3 - s*t^2） イージングアウト/イン：途中まで減速、その後加速。
Easing.InBounceバウンス（指数関数的に減衰する放物線バウンス）の緩和曲線 関数：速度ゼロからの加速。
Easing.OutBounceバウンス（指数関数的に減衰する放物線バウンス）関数のイージングカーブ：速度ゼロから減速する。
Easing.InOutBounceバウンス（指数関数的に減衰する放物線バウンス）のイージングカーブ 関数のイージングイン/アウト：途中まで加速し、その後減速する。
Easing.OutInBounceバウンス（指数関数的に減衰する放物線バウンス）関数のイージングカーブ イージングアウト/イン：途中まで減速し、その後加速する。
Easing.BezierSplineeasing.bezierCurveプロパティで定義されたカスタムイージングカーブ。

easing.amplitude は、バウンス曲線と弾性曲線（ , , , , , , または タイプの曲線）にのみ適用できます。Easing.InBounce Easing.OutBounce Easing.InOutBounce Easing.OutInBounce Easing.InElastic Easing.OutElastic Easing.InOutElastic Easing.OutInElastic

easing.overshoot は、 の場合にのみ適用されます： , または 。easing.type Easing.InBack Easing.OutBack Easing.InOutBack Easing.OutInBack

easing.period は、easing.type が次の場合にのみ適用されます： , または の場合のみ適用されます。Easing.InElastic Easing.OutElastic Easing.InOutElastic Easing.OutInElastic

easing.bezierCurve は easing.type が: の場合のみ適用されます。このプロパティは、0,0から1,1までの曲線を定義する3点のグループ - control1、control2、end point: [cx1, cy1, cx2, cy2, endx, endy, ...] - を含むlist<real>です。最後の点は1,1でなければならない。Easing.BezierSpline

異なるイージング設定のデモについては、イージングカーブを参照してください。


from : real

このプロパティは、アニメーションの開始値を保持します。

Animator がTransition またはBehavior 内で定義されている場合、この値はTransition の開始状態で定義された値、またはBehavior がトリガーされた瞬間のプロパティの現在値にデフォルト設定されます。

Qt Quick のアニメーションとトランジション」も参照してください 。


target : QtQuick::Item

このプロパティは、アニメーターのターゲット項目を保持します。

注: アニメーターのターゲットは、Item ベースのタイプでなければなりません。


to : real

このプロパティは、アニメーションの終了値を保持します。

アニメーターがTransition またはBehavior 内で定義されている場合、この値はデフォルトでTransition の終了状態で定義された値、またはBehavior をトリガーしたプロパティ変更の値になります。


本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。