このページでは

Particle3D QML Type

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

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

Object3D

Inherited By:

LineParticle3D, ModelBlendParticle3D, ModelParticle3D, and SpriteParticle3D

プロパティ

詳細説明

この要素は論理パーティクルの共通プロパティを定義します。Particle3Dはパーティクルの抽象基底クラスです。代わりにModelParticle3D またはSpriteParticle3D を使用してください。

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

プロパティのドキュメント

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

このプロパティは、パーティクルの整列位置を定義する。このプロパティは、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も参照してください

© 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.