ModelBlendParticle3D QML Type

パーティクル効果を3Dモデルとブレンドします。もっと詳しく...

Import Statement: import QtQuick3D.Particles3D
Inherits:

Particle3D

プロパティ

詳細説明

この型は、パーティクル効果を3Dモデルとブレンドする方法を提供する。提供されるモデルは三角形ベースである必要があります。モデル内の各三角形はパーティクルに変換され、エミッタによって使用されます。パーティクル・シェーダの代わりに、モデルで指定されたmaterial 。エフェクトのブレンド方法はmodelBlendMode によって決定されます。

可能なモードは次のとおりです:

  • Construct(構築):モデルはパーティクルから構築されます。
  • Explode:モデルがパーティクルに変換されます。
  • Transfer(トランスファー):Construct(コンストラクト)とExplode(エクスプロード)を組み合わせて、モデルがある場所から別の場所に移動するエフェクトを作成します。

デフォルトでは、emitModeRandom に設定されるか、emitModeActivation に設定され、activationNode が設定されない限り、パーティクルはモデルで指定された順序で放出されます。

ベースクラスとエミッターで定義されているいくつかの機能は、このタイプでは機能しません:

  • Particle3D::alignMode パーティクルはモデル内で任意の向きにできるため、機能しません。
  • Particle3D::sortMode パーティクルは常にモデル内でプリミティブが指定された順序でレンダリングされるため、機能しません。
  • ParticleEmitter3D::depthBias は、モデルの深度バイアスが代わりに使用されるため、機能しません。

注意: デフォルトのfadeInEffectfadeOutEffectParticle3D.FadeNone です。

プロパティ ドキュメント

ModelBlendEmitMode : enumeration

パーティクルのエミットモードを定義します。

定数説明
ModelBlendParticle3D.Sequentialパーティクルはモデルで定義された順序で放出されます。
ModelBlendParticle3D.Randomパーティクルはランダムな順番で放出されます。
ModelBlendParticle3D.Activationパーティクルは、activationNode によってアクティブにされたときに放出されます。

ModelBlendMode : enumeration

パーティクル効果のブレンドモードを定義します。

定数説明
ModelBlendParticle3D.Explodeモデルは分解され、パーティクルはモデルの位置から放出されます。
ModelBlendParticle3D.Constructモデルは構築されます。つまり、パーティクルはエミッタから飛び、最後にモデルを構築します。
ModelBlendParticle3D.Transfer同じモデルに対して、ExplodeとTransferを組み合わせます。

activationNode : Node

このプロパティはパーティクルを活性化するノードを保持し、通常のエミットルーチンをオーバーライドします。アクティブ化ノードを使用すると、モデルがパーティクルからエクスプロード/コンストラクトされるときに、パーティクルがどのように空間的に放出されるかを制御できます。アクティブ化ノードは、パーティクルの中心がアクティブ化ノードのz軸の正の半分にある場合にパーティクルを放出します。アクティブ化ノードをアニメーションさせてモデルを移動させると、アクティブ化ノードが移動するパスに沿ってパーティクルが順次放出されます。


delegate : Component

デリゲートは、ModelBlendParticle3D のモデルを定義するテンプレートを提供します。

例えば、デフォルトのマテリアルでデフォルトの球体モデルを使用する場合、次のようになります。

Component {
    id: modelComponent
    Model {
        source: "#Sphere"
        scale: Qt.vector3d(0.5, 0.5, 0.5)
        materials: DefaultMaterial { diffuseColor: "red" }
    }
}

ModelBlendParticle3D {
    id: particleRedSphere
    delegate: modelComponent
}

emitMode : bool

このプロパティは、パーティクルのエミット・モードを保持します。


endNode : Node

このプロパティは、パーティクル効果終了時のモデルのトランスフォームを指定するノードを保持します。ModelBlendParticle3D.ConstructModelBlendParticle3D.Transfer ブレンドモードを使用する際に、モデルが構築されるサイズ、位置、回転を定義します。


endTime : int

このプロパティは、パーティクルの終了時間をミリ秒単位で保持します。終了時間は構築中に使用され、パーティクルのライフタイムから、エフェクトがモデルの位置とブレンドされる終了までの時間を定義します。終了時間の前は、パーティクルの位置はパーティクル効果によってのみ定義されますが、終了時間の間は、パーティクルの位置はモデルの終了位置とリニアにブレンドされます。


modelBlendMode : ModelBlendMode

このプロパティは、パーティクルエフェクトのブレンドモードを保持します。


© 2025 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.