ModelBlendParticle3D QML Type
パーティクル効果を3Dモデルとブレンドします。もっと詳しく...
Import Statement: | import QtQuick3D.Particles3D |
Inherits: |
プロパティ
- ModelBlendEmitMode : enumeration
- ModelBlendMode : enumeration
- activationNode : Node
- delegate : Component
- emitMode : bool
- endNode : Node
- endTime : int
- modelBlendMode : ModelBlendMode
詳細説明
この型は、パーティクル効果を3Dモデルとブレンドする方法を提供する。提供されるモデルは三角形ベースである必要があります。モデル内の各三角形はパーティクルに変換され、エミッタによって使用されます。パーティクル・シェーダの代わりに、モデルで指定されたmaterial 。エフェクトのブレンド方法はmodelBlendMode によって決定されます。
可能なモードは次のとおりです:
- Construct(構築):モデルはパーティクルから構築されます。
- Explode:モデルがパーティクルに変換されます。
- Transfer(トランスファー):Construct(コンストラクト)とExplode(エクスプロード)を組み合わせて、モデルがある場所から別の場所に移動するエフェクトを作成します。
デフォルトでは、emitMode がRandom
に設定されるか、emitMode がActivation
に設定され、activationNode が設定されない限り、パーティクルはモデルで指定された順序で放出されます。
ベースクラスとエミッターで定義されているいくつかの機能は、このタイプでは機能しません:
- Particle3D::alignMode パーティクルはモデル内で任意の向きにできるため、機能しません。
- Particle3D::sortMode パーティクルは常にモデル内でプリミティブが指定された順序でレンダリングされるため、機能しません。
- ParticleEmitter3D::depthBias は、モデルの深度バイアスが代わりに使用されるため、機能しません。
注意: デフォルトのfadeInEffect とfadeOutEffect はParticle3D.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.Construct
、ModelBlendParticle3D.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.