Particle3D QML Type

抽象的な論理パーティクル。詳細...

Import Statement: import QtQuick3D.Particles3D
Since: Qt 6.2
Inherits:

Object3D

Inherited By:

ModelBlendParticle3D, ModelParticle3D, and SpriteParticle3D

プロパティ

詳細説明

この要素は論理パーティクルの共通プロパティを定義します。Particle3Dはパーティクルの抽象ベースクラスです。代わりにModelParticle3D またはSpriteParticle3D

注意: モデルで使用されるマテリアルとは異なり、パーティクルはデフォルトで半透明を想定してレンダリングされるため、ブレンドが有効になっています。パーティクルのテクスチャ、色(アルファ)のバリエーション、フェーディングなどのため、ほとんどの場合、これが望ましい動作です。ブレンディングが不要な場合は、hasTransparencyfalse に設定するとパフォーマンスが向上する可能性があります。

プロパティ ドキュメント

AlignMode : enumeration

アライメントのタイプを定義します。

定数説明
Particle3D.AlignNoneアライメントなし。パーティクルの回転はparticleRotation で定義できます。
Particle3D.AlignTowardsTargetパーティクルをalignTargetPosition 方向に揃えます。
Particle3D.AlignTowardsStartVelocityvelocity 方向にパーティクルを揃えます。

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

このプロパティは、パーティクルの整列位置を定義します。このプロパティは、alignModeParticle3D.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 です。

colorfadeInEffectfadeOutEffectも参照して ください。


maxAmount : int

このプロパティは、同時に存在できるパーティクルの最大量を定義します。particlesUsed を使用して、割り当てられたパーティクルがどの程度効率的に使用されているかをデバッグできます。maxAmount が小さすぎる場合、パーティクルはlifeSpan の終端に達する前に再使用されます。 maxAmount が大きすぎる場合、パーティクル用に不要なメモリが割り当てられます。

注意: maxAmount を変更すると、パーティクルシステム内のすべてのパーティクルがリセットされます。

デフォルト値は100 です。


sortMode : SortMode

このプロパティはパーティクルのソートモードを定義します。

デフォルト値はParticle3D.SortNone です。


unifiedColorVariation : bool

このプロパティは、colorVariation をすべてのカラーチャンネルに一様に適用するかどうかを定義します。これは、すべてのバリエーションが同じランダム量で適用されることを意味します。

たとえば、#ffff00#7f7f00 の間に黄色を持つパーティクルを作成する場合、RG のカラーチャンネルの値は常に同じになります:

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.