Emitter QML Type
論理パーティクルを放出します。もっと詳しく...
| Import Statement: | import QtQuick.Particles |
| Inherited By: |
プロパティ
- acceleration : StochasticDirection
- emitRate : real
- enabled : bool
- endSize : real
- group : string
- lifeSpan : int
- lifeSpanVariation : int
- maximumEmitted : int
- shape : Shape
- size : real
- sizeVariation : real
- startTime : int
- system : ParticleSystem
- velocity : StochasticDirection
- velocityFromMovement : real
信号
- emitParticles(Array 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
このエミッタが1回に放出するパーティクルの最大数。
これはパフォーマンスの最適化(burstとpulseの使用時)として、またはエミッションをずらすために設定できます。
これがゼロ以下の数値に設定されている場合、このエミッタが生存させることができるパーティクル数の上限はありません。
デフォルト値は-1です。
shape : Shape
このシェイプはエミッターのサイズと一緒に適用されます。パーティクルは、シェイプで覆われた領域からランダムに放出されます。
デフォルトのシェイプは塗りつぶされた長方形で、Emitterのバウンディングボックスに対応しています。
size : real
パーティクルのライフ開始時のピクセルサイズ。
デフォルト値は16。
sizeVariation : real
粒子のサイズは、サイズ/endSize から上下にこれだけ変化する可能性がある。ひとつの粒子に対して、size とendSize の両方に同じランダムな加算が行われます。
デフォルト値は 0 です。
startTime : int
エミッタのロード時にこの値が設定されていると、startTimeミリ秒前までの過去のパーティクルを放出します。これらのパーティクルはその時に放出されたかのようにシミュレートされますが、アフェクタは適用されません。アフェクターは現在時刻から有効になります。
system : ParticleSystem
これはEmitterが放出するParticleシステムです。Emitterの直接の子である場合は省略できます。ParticleSystem
velocity : StochasticDirection
放出される粒子の初速。
velocityFromMovement : real
この値が0でない場合、エミッタの移動は、その移動に基づいてパーティクルに追加の開始速度を提供します。追加ベクトルはエミッタの動きと同じ角度になり、エミッタの動きの大きさにvelocityFromMovementを掛けた大きさになります。
デフォルト値は0。
シグナルのドキュメント
emitParticles(Array particles)
particles 。パーティクルオブジェクトのJavaScript配列です。ハンドラ内でパーティクルの属性を直接変更できます。
注意: JavaScriptは実行速度が遅いので、大容量のパーティクルシステムで使用することはお勧めしません。
注意: 対応するハンドラはonEmitParticles です。
メソッドのドキュメント
void burst(int count)
count で指定された数のパーティクルを、このエミッタから直ちに放出します。
void burst(int count, int x, int y)
count で指定された数のパーティクルを、このエミッタから即座に放出します。パーティクルは、エミッタが (x,y) に配置されているかのように放出されますが、他のすべてのプロパティは同じです。
void pulse(int duration)
エミッタが有効でない場合、指定されたduration (ミリ秒単位) の間有効にし、その後オフに戻す。
© 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.