このページでは

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

このプロパティは、パーティクルを活性化し、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.ConstructModelBlendParticle3D.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.