このページでは

Wander3D QML Type

パーティクルにランダムな波状の曲線を適用します。詳細...

Import Statement: import QtQuick3D.Particles3D
Since: Qt 6.2
Inherits:

Affector3D

プロパティ

詳細な説明

この要素は、パーティクルにランダムな波状の曲線を適用します。曲線には、すべてのパーティクルで共通するグローバル値と、ランダムに異なる固有値を組み合わせることができます。

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

fadeInDuration : int

このプロパティは、エフェクターのフェードインにかかる時間をミリ秒単位で定義します。この時間が経過すると、ワンダリング効果が完全に発動します。この設定を行うと、特定の位置や形状からエフェクトを放出するのに役立ちます。設定しない場合、ワンダリングは開始時点から位置にも影響を及ぼします。

デフォルト値は0 です。

fadeOutDuration : int

このプロパティは、エフェクターがフェードアウトするまでの時間をミリ秒単位で定義します。この設定を行うと、パーティクルのライフタイムが終了した際の動きの乱れを抑えるのに役立ちます。例えば、Attractor3D と組み合わせることで、終了位置がshape と一致するようになります。

デフォルト値は0 です。

globalAmount : vector3d

このプロパティは、カーブの端で各パーティクルがどの程度の距離を移動するかを定義します。たとえば、値が (100, 10, 0) の場合、すべてのパーティクルは (100, 10, 0) から (-100, -10, 0) の間で動き回ります。

デフォルト値は(0.0, 0.0, 0.0) です。

globalPace : vector3d

このプロパティは、各パーティクルが1秒間に曲線を描きながら移動するペース(頻度)を定義します。

デフォルト値は(0.0, 0.0, 0.0) です。

globalPaceStart : vector3d

このプロパティは、ペース(周波数)の開始点を定義します。有効な範囲は 0 ~ 2 * PI です。たとえば、ペースの開始時の x 座標をアニメーション化するには:

PropertyAnimation on globalPaceStart {
    loops: Animation.Infinite
    duration: 2000
    from: Qt.vector3d(0, 0, 0)
    to: Qt.vector3d(Math.PI * 2, 0, 0)
}

デフォルト値は(0.0, 0.0, 0.0) です。

uniqueAmount : vector3d

このプロパティは、カーブの端点において各パーティクルが最大でどのくらいの距離移動するかを定義します。

デフォルト値は(0.0, 0.0, 0.0) です。

uniqueAmountVariation : real

このプロパティは、uniqueAmount の変動範囲を0.0から1.0の間で定義します。変動量が0.0の場合、すべてのパーティクルが最大量に達します。0.5の場合、すべてのパーティクルが量の0.5~1.5の範囲に達します。 たとえば、uniqueAmount が(100, 50, 20)で、uniqueAmountVariationが0.1の場合、パーティクルの最大波長は(110, 55, 22)から(90, 45, 18)までの間のランダムな値になります。

デフォルト値は0.0 です。

uniquePace : vector3d

このプロパティは、各パーティクルが1秒間に曲線を描きながら移動する固有のペース(周波数)を定義します。

デフォルト値は(0.0, 0.0, 0.0) です。

uniquePaceVariation : real

このプロパティは、各パーティクルごとに0.0から1.0の範囲で一意のペース(周波数)の変動を定義します。変動が0.0の場合、すべてのパーティクルは同じ周波数で移動します。 たとえば、uniquePace が(1.0, 2.0, 4.0)で、uniquePaceVariationが0.5の場合、パーティクルの波のペースは(2.0, 4.0, 8.0)と(0.5, 1.0, 2.0)の間でランダムに変化します。

デフォルト値は0.0 です。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.