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
}注: デリゲートからインスタンス化されたモデルは 、独自のlayers 割り当てを保持します。ParticleSystem3D のlayers値は、このモデルには適用されません。特定のコンテンツレイヤー上でパーティクルをレンダリングするには、デリゲート内でlayersプロパティを設定してください。
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.