Particle3D QML Type

抽象的な論理粒子。詳細…

• 継承されたメンバーを含むすべてのメンバーの一覧

プロパティ

• AlignMode : enumeration
• FadeType : enumeration
• SortMode : enumeration
• alignMode : AlignMode
• alignTargetPosition : vector3d
• color : color
• colorVariation : vector4d
• fadeInDuration : int
• fadeInEffect : FadeType
• fadeOutDuration : int
• fadeOutEffect : FadeType
• hasTransparency : bool
• maxAmount : int
• sortMode : SortMode
• unifiedColorVariation : bool

詳細な説明

この要素は、論理パーティクルの共通プロパティを定義します。Particle3Dはパーティクルの抽象基底クラスであるため、代わりにModelParticle3D またはSpriteParticle3D を使用してください。

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

AlignMode : enumeration

アライメントのタイプを定義します。

FadeType : enumeration

フェード効果の種類を定義します。

SortMode : enumeration

パーティクルのソートモードを定義します。ソートモードによって、パーティクルが描画される順序が決まります。

alignMode : AlignMode

このプロパティは、パーティクルに使用される配置モードを定義します。パーティクルの配置とは、パーティクルが向く方向を指します。

デフォルト値は `Particle3D.AlignNone` です。

「alignTargetPosition」も参照してください 。

alignTargetPosition : vector3d

このプロパティは、パーティクルが整列される位置を定義します。このプロパティは、alignMode がParticle3D.AlignTowardsTarget に設定されている場合にのみ有効です。

「alignMode」も参照してください 。

color : color

このプロパティは、パーティクルの着色に使用されるベースカラーを定義します。

デフォルト値は"#FFFFFF" （白）です。

colorVariation : vector4d

このプロパティは、パーティクルの着色に使用される色の変化を定義します。値はRGBA順で指定され、各値は0.0（変化なし）から1.0（最大変化）の範囲で指定する必要があります。

たとえば、#ff0000 から#e50000 までの半透明の赤色を持ち、不透明度が 40% から 60% のパーティクルを作成するには、次のように指定します。

ModelParticle3D {
    ...
    color: "#7fff0000"
    colorVariation: Qt.vector4d(0.1, 0.0, 0.0, 0.2)
}

デフォルト値は(0, 0, 0, 0) （変化なし）です。

「unifiedColorVariation」も参照してください 。

fadeInDuration : int

このプロパティは、フェードイン効果が持続する時間をミリ秒単位で指定します。

デフォルト値は250 です。

「 fadeInEffect 」および「fadeOutDuration 」も参照してください 。

fadeInEffect : FadeType

このプロパティは、パーティクルが出現する際に使用されるフェード効果を定義します。

デフォルト値はParticle3D.FadeOpacity です。

「 fadeInDuration 」および「fadeOutEffect 」も参照してください 。

fadeOutDuration : int

このプロパティは、フェードアウト効果の持続時間をミリ秒単位で指定します。

デフォルト値は250 です。

「 fadeOutEffect 」および「fadeInDuration 」も参照してください 。

fadeOutEffect : FadeType

このプロパティは、パーティクルがlifeSpan に到達して消える際に適用されるフェード効果を定義します。

デフォルト値は「Particle3D.FadeOpacity 」です。

「 fadeOutDuration 」および「fadeInEffect 」も参照してください 。

hasTransparency : bool

このプロパティは、パーティクルに透明性があり、背景とブレンドされるべきかどうかを定義します。通常、パーティクルの色が完全なアルファ値を持たない場合、テクスチャに半透明のピクセルが含まれている場合、またはパーティクルの不透明度がフェードイン・フェードアウトされる場合など、このプロパティは true に設定すべきです。特定のケースでは、これを false に設定することで最適化を図ることができます。

デフォルト値はtrue です。

関連項目： color 、fadeInEffect 、およびfadeOutEffect 。

maxAmount : int

このプロパティは、同時に存在できるパーティクルの最大数を定義します。particlesUsed を使用すると、割り当てられたパーティクルがどれほど効率的に使用されているかをデバッグできます。maxAmountの値が小さすぎると、パーティクルはlifeSpan の終了に達する前に再利用されてしまいます。一方、maxAmountの値が大きすぎると、パーティクル用に不要なメモリが割り当てられてしまいます。

デフォルト値は100 です。

sortMode : SortMode

このプロパティは、パーティクルに使用されるソートモードを定義します。

デフォルト値はParticle3D.SortNone です。

unifiedColorVariation : bool

このプロパティは、colorVariation をすべてのカラーチャンネルに均一に適用するかどうかを定義します。つまり、すべてのバリエーションに同じランダムな量が適用されます。

たとえば、#ffff00 から#7f7f00 までの範囲の黄色を持つパーティクルを作成し、R およびG の各カラーチャンネルの値が常に同じになるようにするには、次のように設定します。

ModelParticle3D {
    ...
    color: "#ffff00"
    colorVariation: Qt.vector4d(0.5, 0.5, 0.0, 0.0)
    unifiedColorVariation: true
}

デフォルト値はfalse です。

「colorVariation」も参照してください 。