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も参照してください 。
本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
