Particle3D QML Type
抽象的な論理パーティクル。詳細...
Import Statement: | import QtQuick3D.Particles3D |
Since: | Qt 6.2 |
Inherits: | |
Inherited By: |
プロパティ
- AlignMode : enumeration
- FadeType : enumeration
- SortMode : enumeration
- alignMode : AlignMode
- alignTargetPosition : vector3d
- color : color
- colorVariation : vector4d
- fadeInDuration : int
- fadeInEffect : FadeType
- fadeOutDuration : int
- fadeOutEffect : FadeType
- hasTransparency : bool
- maxAmount : int
- sortMode : SortMode
- unifiedColorVariation : bool
詳細説明
この要素は論理パーティクルの共通プロパティを定義します。Particle3Dはパーティクルの抽象ベースクラスです。代わりにModelParticle3D またはSpriteParticle3D 。
注意: モデルで使用されるマテリアルとは異なり、パーティクルはデフォルトで半透明を想定してレンダリングされるため、ブレンドが有効になっています。パーティクルのテクスチャ、色(アルファ)のバリエーション、フェーディングなどのため、ほとんどの場合、これが望ましい動作です。ブレンディングが不要な場合は、hasTransparency をfalse
に設定するとパフォーマンスが向上する可能性があります。
プロパティ ドキュメント
AlignMode : enumeration |
アライメントのタイプを定義します。
定数 | 説明 |
---|---|
Particle3D.AlignNone | アライメントなし。パーティクルの回転はparticleRotation で定義できます。 |
Particle3D.AlignTowardsTarget | パーティクルをalignTargetPosition 方向に揃えます。 |
Particle3D.AlignTowardsStartVelocity | velocity 方向にパーティクルを揃えます。 |
FadeType : enumeration |
フェード効果のタイプを定義します。
定数 | 説明 |
---|---|
Particle3D.FadeNone | フェードなし。 |
Particle3D.FadeOpacity | パーティクルの不透明度を 0.0 からフェードします。 |
Particle3D.FadeScale | パーティクルのスケールを 0.0 からフェードします。 |
SortMode : enumeration |
パーティクルのソートモードを定義します。ソートモードはパーティクルの描画順序を決定します。
定数 | 説明 |
---|---|
Particle3D.SortNone | ソートなし。 |
Particle3D.SortNewest | パーティクルの寿命に基づいてソートします。 |
Particle3D.SortOldest | パーティクルの寿命に基づいてソートします。 |
Particle3D.SortDistance | カメラまでの距離に基づいてソートします。 |
alignMode : AlignMode |
このプロパティは、パーティクルの整列モードを定義します。パーティクルの整列とは、パーティクルが向いている方向を意味します。
注意: SpriteParticle3D billboard プロパティがtrue
に設定されている場合、alignMode は影響しません。
デフォルト値はParticle3D.AlignNone
です。
alignTargetPositionも参照してください 。
alignTargetPosition : vector3d |
color : color |
このプロパティは、パーティクルの色付けに使用されるベースカラーを定義します。
デフォルト値は"#FFFFFF"
(白)です。
colorVariation : vector4d |
このプロパティは、パーティクルのカラー化に使用されるカラーバリエーションを定義します。値は RGBA オーダーで、各値は 0.0(バリエーションなし)から 1.0(フルバリエーション)の間でなければなりません。
たとえば、#ff0000
から#e50000
の間の半透明の赤色を持つパーティクルを作成するには、不透明度を 40% から 60% にします:
ModelParticle3D { ... color: "#7fff0000" colorVariation: Qt.vector4d(0.1, 0.0, 0.0, 0.2) }
デフォルト値は(0, 0, 0, 0)
(バリエーションなし)です。
unifiedColorVariationも参照してください 。
fadeInDuration : int |
このプロパティは、フェードイン効果の持続時間をミリ秒単位で定義します。
注意: フェーディングの持続時間はパーティクルの一部ですlifeSpan 。例えば、lifeSpan
が 3000、fadeInDuration
が 500、fadeOutDuration
が 500 の場合、パーティクルが完全に表示される時間は 2000 ミリ秒です。
デフォルト値は250
です。
fadeInEffect およびfadeOutDurationも参照して ください。
fadeInEffect : FadeType |
このプロパティは、パーティクルが表示されるときに使用されるフェード効果を定義します。
デフォルト値はParticle3D.FadeOpacity
です。
fadeInDuration およびfadeOutEffect も参照して ください。
fadeOutDuration : int |
fadeOutEffect : FadeType |
このプロパティは、パーティクルがlifeSpan に到達して消えるときに使用されるフェードエフェクトを定義します。
デフォルト値はParticle3D.FadeOpacity
です。
fadeOutDuration およびfadeInEffect も参照して ください。
hasTransparency : bool |
このプロパティは、パーティクルが透明度を持ち、背景とブレンドされるかどうかを定義します。パーティクルの色が完全なアルファを持っていないとき、テクスチャに半透明のピクセルが含まれているとき、パーティクルの不透明度がフェードインまたはフェードアウトしているときなど、通常はtrueにする必要があります。これを false に設定すると、特定の場合に最適化できます。
デフォルト値はtrue
です。
color 、fadeInEffect 、fadeOutEffectも参照して ください。
maxAmount : int |
このプロパティは、同時に存在できるパーティクルの最大量を定義します。particlesUsed を使用して、割り当てられたパーティクルがどの程度効率的に使用されているかをデバッグできます。maxAmount が小さすぎる場合、パーティクルはlifeSpan の終端に達する前に再使用されます。 maxAmount が大きすぎる場合、パーティクル用に不要なメモリが割り当てられます。
注意: maxAmount を変更すると、パーティクルシステム内のすべてのパーティクルがリセットされます。
デフォルト値は100
です。
sortMode : SortMode |
このプロパティはパーティクルのソートモードを定義します。
デフォルト値はParticle3D.SortNone
です。
unifiedColorVariation : bool |
このプロパティは、colorVariation をすべてのカラーチャンネルに一様に適用するかどうかを定義します。これは、すべてのバリエーションが同じランダム量で適用されることを意味します。
たとえば、#ffff00
と#7f7f00
の間に黄色を持つパーティクルを作成する場合、R
とG
のカラーチャンネルの値は常に同じになります:
ModelParticle3D { ... color: "#ffff00" colorVariation: Qt.vector4d(0.5, 0.5, 0.0, 0.0) unifiedColorVariation: true }
デフォルト値はfalse
です。
colorVariationも参照してください 。
© 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.