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
このプロパティは、パーティクルを活性化し、reqular emit ルーチンをオーバーライドするノードを保持します。アクティブ化ノードは、モデルがパーティクルから分解/構築されるときに、パーティクルがどのように空間的に放出されるかを制御するために使用できます。アクティブ化ノードは、パーティクルの中心がアクティブ化ノードの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
このプロパティは、パーティクル効果のブレンドモードを保持します。
© 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.