Emitter QML Type

論理パーティクルを放出します。もっと詳しく...

Import Statement: import QtQuick.Particles

プロパティ

信号

方法

詳細説明

この要素は、与えられた開始属性を持つ論理パーティクルをParticleSystem に放出します。

論理パーティクルは自動的にレンダリングされないので、1つ以上のParticlePainter 要素で視覚化する必要があります。

与えられた開始属性は、パーティクルのライフタイムのどの時点でも、同じParticleSystem 内の Affector 要素によって変更できることに注意してください。これには寿命のような属性も含まれます。

プロパティの説明

acceleration : StochasticDirection

放出されるパーティクルの開始加速度。


emitRate : real

1秒間に放出されるパーティクルの数。

デフォルト値は毎秒10パーティクル。


enabled : bool

falseに設定すると、trueに設定されるまでエミッターは放出を停止します。

デフォルト値はtrueです。


endSize : real

パーティクルの寿命が尽きたときのサイズ(ピクセル単位)。サイズは、パーティクルの寿命の間、この値とサイズから線形補間されます。endSize が -1 の場合、パーティクルのサイズは開始時のサイズのまま一定になります。

デフォルト値は-1です。


group : string

論理的なパーティクルグループです。

デフォルト値は""(空文字列)です。


lifeSpan : int

各パーティクルが放出される時間をミリ秒単位で指定します。

パーティクルを手動で処分する場合など、時間が経過すると自動的に死ぬようにしたくない場合は、lifeSpanをEmitter.InfiniteLifeに設定します。

600000(10分)以上のライフスパンは無限として扱われます。lifeSpanが0以下のパーティクルは死んだ状態でスタートします。

デフォルト値は1000(1秒)です。


lifeSpanVariation : int

パーティクルのライフスパンは最大でこの値だけ左右に変化します。

デフォルト値は0です。


maximumEmitted : int

このエミッタが一度に生存させるパーティクルの最大数。

これはパフォーマンスの最適化(burstとpulseを使用する場合)として、またはエミッションをずらすために設定できます。

これが0以下の数値に設定されている場合、このエミッタが生存させることができるパーティクル数の上限はありません。

デフォルト値は-1です。


shape : Shape

この形状はエミッターのサイズに適用されます。パーティクルはシェイプで覆われた領域からランダムに放出されます。

デフォルトのシェイプは塗りつぶされた長方形で、Emitterのバウンディングボックスに相当します。


size : real

パーティクルのライフ開始時のサイズをピクセルで指定します。

デフォルト値は16です。


sizeVariation : real

パーティクルのサイズは、size/endSize から上下することができます。1つのパーティクルに対してsizeとendSize の両方に同じランダムな加算が行われます。

デフォルト値は 0 です。


startTime : int

エミッタのロード時にこの値を設定すると、startTimeミリ秒前までの過去のパーティクルを放出します。これらのパーティクルはその時に放出されたかのようにシミュレートされますが、アフェクタは適用されません。アフェクターは現在の時間から適用されます。


system : ParticleSystem

これは Emitter が放出する Particle システムです。の直接の子である場合は省略できます。ParticleSystem


velocity : StochasticDirection

放出されるパーティクルの開始速度です。


velocityFromMovement : real

この値が0でない場合、エミッタが移動すると、その移動に基づいてパーティクルに追加の開始速度が提供されます。追加のベクトルはエミッタの動きと同じ角度になり、エミッタの動きの大きさにvelocityFromMovementを掛けた大きさになります。

デフォルト値は0。


シグナルの説明

emitParticles(Array particles)

このシグナルはパーティクルが放出されたときに発せられます。particles はParticleオブジェクトのJavaScript配列です。パーティクルの属性はハンドラ内で直接変更できます。

注意: JavaScriptは実行速度が遅いので、大容量のパーティクルシステムでの使用はお勧めしません。

注意: 対応するハンドラはonEmitParticles です。


メソッド ドキュメント

burst(int count)

このエミッタからcount で指定された数のパーティクルを即座に放出します。


burst(int count, int x, int y)

count で指定された数のパーティクルをこのエミッタから直ちに放出します。パーティクルは、エミッタが (x,y) に配置されているかのように放出されますが、他のすべてのプロパティは同じです。


pulse(int duration)

エミッタが有効になっていない場合、指定されたduration (ミリ秒単位)で有効にし、その後オフに戻します。


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