SpringAnimation QML Type

プロパティがバネのような動きで値を追跡できるようにします。詳細...

• 継承されたメンバを含む、すべてのメンバのリスト

プロパティ

• damping : real
• epsilon : real
• mass : real
• modulus : real
• spring : real
• velocity : real

詳しい説明

SpringAnimation はスプリングの振動動作を模倣します。適切なspring 定数で加速度を制御し、damping で効果が消えるまでの時間を制御します。

また、アニメーションの最大velocity を制限することもできます。

次のRectangle は、マウスがクリックされると、SpringAnimationを使ってマウスの位置に移動します。x とy の値にBehavior が使われているのは、これらの値が変更されるたびにSpringAnimationが適用されることを示しています。

import QtQuick

Item {
    width: 300; height: 300

    Rectangle {
        id: rect
        width: 50; height: 50
        color: "red"

        Behavior on x { SpringAnimation { spring: 2; damping: 0.2 } }
        Behavior on y { SpringAnimation { spring: 2; damping: 0.2 } }
    }

    MouseArea {
        anchors.fill: parent
        onClicked: (mouse)=> {
            rect.x = mouse.x - rect.width/2
            rect.y = mouse.y - rect.height/2
        }
    }
}

他のアニメーションタイプと同様に、SpringAnimationはトランジション、ビヘイビア、プロパティ値のソースなど、さまざまな方法で適用できます。Animation and Transitions inQt Quickdocumentationでは、アニメーションを作成するための様々な方法を紹介しています。

SmoothedAnimation,Animation and Transitions inQt Quick,Qt Quick Examples - Animation,Qt Quick Demo - Clocksも参照してください 。

プロパティのドキュメント

damping : real

このプロパティは、スプリングの減衰値を保持する。

この値は、バネのような動きが静止するまでの時間を表します。デフォルト値は0です。

有効な値の範囲は0～1.0です。値が小さいほど、静止するのが速くなります。

epsilon : real

この特性はバネのイプシロンを保持する。

イプシロンは、0に等しいとみなされるほど0に近い値の変化率と変化量です。これは値の用途によって異なります。ピクセル位置なら0.25で十分でしょう。スケールの場合は0.005で十分です。

デフォルトは0.01です。この値を調整することで、パフォーマンスが少し向上します。

mass : real

このプロパティは、移動されるプロパティの「質量」を保持する。

デフォルトでは 1.0 です。

質量が大きいほど、動きは遅くなり、アイテムが静止したときのバネのような動きが大きくなります。

modulus : real

このプロパティはモジュラス値を保持する。デフォルト値は0である。

modulus を設定すると、ターゲット値はそのモジュラスで "折り返す "ようになります。例えば、モジュラスを360に設定すると、370の値が10に折り返されます。

spring : real

このプロパティは、ターゲットがソースの方に引っ張られる強さを表します。デフォルト値は0（つまり、バネのような動きは無効）。

有効な値の範囲は 0 ～ 5.0 です。

このプロパティが設定され、velocity 値が 0 より大きい場合、velocity は最大速度を制限します。

velocity : real

このプロパティは、ソースをトラッキングする際に許可される最大速度を保持します。

デフォルト値は0（最大速度なし）です。