このページでは

SpriteParticle3D QML Type

2Dスプライトテクスチャを使用するパーティクル。詳細...

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

Particle3D

Inherited By:

LineParticle3D

プロパティ

詳細な説明

SpriteParticle3D は、2D スプライトテクスチャからパーティクルを生成する論理的なパーティクル要素です。

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

BlendMode : enumeration

パーティクルのブレンドモードを定義します。

定数説明
SpriteParticle3D.SourceOverSourceOver モードでパーティクルをブレンドします。
SpriteParticle3D.ScreenScreen モードでパーティクルをブレンドします。
SpriteParticle3D.Multiply「Multiply」モードでパーティクルをブレンドします。

billboard : bool

このプロパティは、パーティクルのテクスチャを常に画面側に向けて配置するかどうかを指定します。

注: true に設定した場合 、Particle3D alignMode プロパティは効果を持ちません。

デフォルト値は「false 」です。

blendMode : BlendMode

このプロパティは、パーティクルのレンダリングに使用されるブレンドモードを定義します。

デフォルト値は「SpriteParticle3D.SourceOver 」です。

castsReflections : bool [since 6.4]

このプロパティをtrue に設定すると、スプライトは反射プローブによってレンダリングされ、反射の中にその姿が見えるようになります。

このプロパティは Qt 6.4 で導入されました。

colorTable : Texture

このプロパティは、パーティクルの着色に使用されるTexture を定義します。画像は1次元または2次元のテクスチャであることができます。水平方向のピクセルは、パーティクルのlifeSpan にわたる色を決定します。たとえば、パーティクルがライフサイクルの半ばに達したとき、画像の中央付近で指定された色になります。画像が2次元の場合、各パーティクルに対して垂直方向の行がランダムに選択されます。 たとえば、c {256 x 4} の画像には、4 通りの粒子の着色オプションが含まれます。

lights : list<Light> [since 6.3]

このプロパティには、パーティクルのレンダリングに使用されるlights のリストが含まれています。

注: 最適なパフォーマンスを得るためには 、必要な場合のみライトを定義し、ライトの数を最小限に抑えてください。

このプロパティは Qt 6.3 で導入されました。

offsetX : real [since 6.3]

このプロパティは、X軸方向のパーティクルのオフセットを定義します

このプロパティは Qt 6.3 で導入されました。

offsetY : real [since 6.3]

このプロパティは、Y軸方向のパーティクルのオフセットを定義します

このプロパティは Qt 6.3 で導入されました。

particleScale : real

このプロパティは、パーティクルのスケール倍率を定義します。エミッター内のパーティクルのサイズを調整するには、ParticleEmitter3D 、particleScale 、particleEndScale 、およびparticleScaleVariation のプロパティを使用します。

デフォルト値は5.0 です。

sprite : Texture

このプロパティは、パーティクルに使用されるTexture を定義します。

たとえば、「snowFlake.png」をパーティクルのテクスチャとして使用するには、次のように設定します。

SpriteParticle3D {
    id: snowParticle
    ...
    sprite: Texture {
        source: "images/snowflake.png"
    }
}

spriteSequence : SpriteSequence3D

このプロパティは、パーティクルのスプライトシーケンスのプロパティを定義します。sprite テクスチャにフレームシーケンスが含まれている場合は、このプロパティを設定して、フレーム数やアニメーションの方向などの特性を定義してください。

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