このページでは

Particle QML Type

エミッターやアフェクターによって操作されるパーティクルを表します。詳細...

Import Statement: import QtQuick.Particles

プロパティ

詳細な説明

パーティクル要素は常にParticleSystem によって内部的に管理されており、QML内で作成することはできません。ただし、パーティクルの状態を任意に変更できるようにするため、シグナルを介して公開される場合があります

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

alpha : real

ImageParticle 色付きのパーティクルを描画できます。その際、alphaは、ソース画像に適用される色のアルファチャンネルとして使用されます。

値の範囲は 0.0 から 1.0 です。

autoRotate : bool

autoRotate が true の場合、パーティクルの回転は、進行方向を向くように設定され、さらに rotation またはrotationVelocity プロパティによる回転が加算されます。

ax : real

粒子の現在のx方向の加速度。

ay : real

粒子の瞬間的なy方向の加速度。

blue : real

ImageParticle 色付きのパーティクルを描画できます。その際、ソース画像に適用される色の青チャンネルとして青色が使用されます。

値の範囲は 0.0 から 1.0 です。

currentSize : real

パーティクルの currentSize。currentTime に基づいて、startSize とendSize の間で補間されます。

endSize : real

パーティクルの寿命が尽きた時点での、その画像のピクセルサイズ。この値が 0 未満の場合、この値は無視され、パーティクルはその存続期間全体を通じて「startSize 」のサイズを維持します。

green : real

ImageParticle 色付きのパーティクルを描画できます。その際、ソース画像に適用される色の緑チャンネルとして緑色が使用されます。

値の範囲は 0.0 から 1.0 です。

initialAX : real

粒子の寿命の開始時点におけるx方向の加速度。

このシミュレーション手法では、特定の時点での値を算出して変更するよりも、初期値を変更する方が好ましい。現在の値ではなく、CustomEmittersで初期値を変更してください。

initialAY : real

粒子の寿命の開始時点におけるy方向の加速度。

このシミュレーション手法では、特定の時点での値を算出して変更するよりも、初期値を変更する方が好ましい。現在の値ではなく、CustomEmittersで初期値を変更してください。

initialVX : real

粒子の寿命の開始時点におけるx方向の速度。

このシミュレーション手法では、特定の時点での値を算出して変更するよりも、初期値を変更することを推奨しています。現在の値ではなく、CustomEmitters で初期値を変更してください。

initialVY : real

粒子の寿命の開始時点におけるy方向の速度。

このシミュレーション手法では、特定の時点での値を算出して変更するよりも、初期値を変更する方が好ましい。現在の値ではなく、CustomEmittersで初期値を変更してください。

initialX : real

粒子の寿命の開始時点におけるx座標。

このシミュレーション手法では、特定の時点での値を算出して変更するよりも、初期値を変更することを推奨しています。現在の値ではなく、CustomEmitters で初期値を変更してください。

initialY : real

パーティクルの寿命の開始時点における y 座標。

このシミュレーション手法では、特定の時点での値を算出して変更するよりも、初期値を変更することを推奨しています。現在の値ではなく、CustomEmitters で初期値を変更してください。

lifeLeft : real

現在の時点から、その粒子が存続する残り時間(秒単位)。

lifeSpan : real

粒子が存続する時間(秒単位)。

red : real

ImageParticle 色付きのパーティクルを描画することができます。その際、赤はソース画像に適用される色の赤チャンネルとして使用されます。

値の範囲は 0.0 から 1.0 です。

rotation : real

粒子画像が生成開始時に時計回りに回転する角度(度)。

rotationVelocity : real

粒子画像が「生存中」の間に、1秒あたり時計回りに回転する角度(度)。

startSize : real

パーティクル画像がライフサイクルの開始時に持つピクセル単位のサイズ。

t : real

シミュレーション開始から、その粒子が生成された時点までの経過時間(秒単位)。

update : bool

アフェクター内部では、particle に対して行われた変更は、update が true に設定されている場合にのみ適用されます。

vx : real

粒子の現在のx方向の速度。

vy : real

粒子の現在のy方向の速度。

x : real

粒子の現在の x 座標。

xDeformationVectorX : real

X軸に沿った変形ベクトルのx成分です。ImageParticle は、正方形以外の形状にまたがってパーティクルを描画できます。これにより、xおよびyの変形ベクトルで描かれた平行四辺形にまたがるように、テクスチャの矩形が描画されます。

xDeformationVectorY : real

X軸に沿った変形ベクトルのx成分です。ImageParticle は、正方形以外の形状にまたがってパーティクルを描画できます。この関数は、xおよびyの変形ベクトルで描かれた平行四辺形にまたがるように、テクスチャの矩形を描画します。

y : real

粒子の現在の y 座標。

yDeformationVectorX : real

X軸に沿った変形ベクトルのy成分です。ImageParticle は、正方形以外の形状にまたがってパーティクルを描画できます。この関数は、xおよびyの変形ベクトルで描かれた平行四辺形全体に、テクスチャの矩形を描画します。

yDeformationVectorY : real

Y軸に沿った変形ベクトルのy成分です。『ImageParticle 』では、正方形以外の形状にまたがってパーティクルを描画することができます。この機能では、xおよびyの変形ベクトルで描かれた平行四辺形にまたがるように、テクスチャの矩形が描画されます。

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