Particle3D QML Type
抽象的な論理パーティクル。詳細...
| Import Statement: | import QtQuick3D.Particles3D |
| Since: | Qt 6.2 |
| Inherits: | |
| Inherited By: | LineParticle3D, ModelBlendParticle3D, ModelParticle3D, and SpriteParticle3D |
プロパティ
- 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
このプロパティは、パーティクルの整列位置を定義する。このプロパティは、alignMode がParticle3D.AlignTowardsTarget に設定されている場合にのみ有効です。
alignModeも参照してください 。
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
このプロパティは、フェードアウト効果の継続時間をミリ秒単位で定義します。
デフォルト値は250 です。
fadeOutEffect およびfadeInDurationも参照してください 。
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も参照してください 。
© 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.