Emitter QML Type
Sendet logische Partikel aus. Mehr...
| Import Statement: | import QtQuick.Particles |
| Inherited By: |
Eigenschaften
- 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
Signale
- emitParticles(Array particles)
Methoden
Detaillierte Beschreibung
Dieses Element sendet logische Partikel mit den angegebenen Startattributen in die ParticleSystem aus.
Beachten Sie, dass logische Partikel nicht automatisch gerendert werden, Sie müssen ein oder mehrere ParticlePainter Elemente haben, die sie visualisieren.
Beachten Sie, dass die angegebenen Startattribute zu jedem Zeitpunkt der Lebensdauer des Partikels durch ein beliebiges Affector-Element im selben ParticleSystem geändert werden können. Dies schließt Attribute wie lifespan ein.
Dokumentation der Eigenschaft
acceleration : StochasticDirection
Die Ausgangsbeschleunigung der emittierten Teilchen.
emitRate : real
Anzahl der pro Sekunde emittierten Partikel.
Der Standardwert ist 10 Partikel pro Sekunde.
enabled : bool
Wird dieser Wert auf "false" gesetzt, stellt der Emitter seine Emissionen ein, bis er auf "true" gesetzt wird.
Der Standardwert ist true.
endSize : real
Die Größe der Partikel in Pixeln am Ende ihrer Lebensdauer. Die Größe wird während der Lebensdauer des Partikels aus diesem Wert und der Größe linear interpoliert. Wenn endSize -1 ist, bleibt die Größe des Partikels konstant bei der Startgröße.
Der Standardwert ist -1.
group : string
Dies ist die logische Partikelgruppe, in die es emittiert wird.
Der Standardwert ist "" (leere Zeichenkette).
lifeSpan : int
Die Zeit in Millisekunden, die jedes emittierte Partikel dauern soll.
Wenn Sie nicht möchten, dass die Partikel nach einer bestimmten Zeit automatisch sterben, z. B. wenn Sie sie manuell entsorgen möchten, setzen Sie lifeSpan auf Emitter.InfiniteLife.
Lebensspannen, die größer oder gleich 600000 (10 Minuten) sind, werden als unendlich behandelt. Partikel mit einer Lebensspanne kleiner oder gleich 0 sind von Anfang an tot.
Der Standardwert ist 1000 (eine Sekunde).
lifeSpanVariation : int
Die Lebensdauer der Partikel variiert in beide Richtungen um bis zu diesem Wert.
Der Standardwert ist 0.
maximumEmitted : int
Die maximale Anzahl von Partikeln, die dieser Emitter zu einem Zeitpunkt aktiv haben wird.
Dies kann zur Leistungsoptimierung (bei Verwendung von Burst und Pulse) oder zur Staffelung der Emissionen festgelegt werden.
Wird dieser Wert auf eine Zahl unter Null gesetzt, gibt es keine Obergrenze für die Anzahl der Partikel, die dieser Emitter aktiv haben kann.
Der Standardwert ist -1.
shape : Shape
Diese Form wird mit der Größe des Emitters angewendet. Die Partikel werden nach dem Zufallsprinzip aus jedem von der Form abgedeckten Bereich emittiert.
Die Standardform ist ein ausgefülltes Rechteck, das dem gesamten Begrenzungsrahmen des Emitters entspricht.
size : real
Die Größe der Partikel zu Beginn ihres Lebens in Pixeln.
Der Standardwert ist 16.
sizeVariation : real
Die Größe eines Partikels kann um diesen Betrag nach oben oder unten von der Größe/endSize abweichen. Für ein einzelnes Partikel wird die gleiche zufällige Addition zu Größe und endSize vorgenommen.
Der Standardwert ist 0.
startTime : int
Wenn dieser Wert beim Laden des Emitters gesetzt wird, emittiert er Partikel aus der Vergangenheit, die bis zu startTime Millisekunden zurückliegen. Diese werden so simuliert, als ob sie zu diesem Zeitpunkt emittiert worden wären, aber es werden keine Affektoren auf sie angewendet. Affektoren werden ab der Gegenwart wirksam.
system : ParticleSystem
Dies ist das Partikelsystem, in das der Emitter emittieren wird. Dies kann weggelassen werden, wenn der Emitter ein direktes Kind des ParticleSystem
velocity : StochasticDirection
Die Anfangsgeschwindigkeit der emittierten Teilchen.
velocityFromMovement : real
Wenn dieser Wert ungleich Null ist, dann wird jede Bewegung des Emitters den Partikeln eine zusätzliche Startgeschwindigkeit geben, die auf der Bewegung basiert. Der zusätzliche Vektor hat den gleichen Winkel wie die Bewegung des Emitters, mit einer Größe, die der Größe der Bewegung des Emitters multipliziert mit velocityFromMovement entspricht.
Der Standardwert ist 0.
Signal-Dokumentation
emitParticles(Array particles)
Dieses Signal wird ausgesendet, wenn Partikel ausgesendet werden. particles ist ein JavaScript-Array von Partikel-Objekten. Sie können die Partikelattribute direkt im Handler ändern.
Hinweis: JavaScript ist langsamer in der Ausführung, daher ist es nicht empfehlenswert, dies in Partikelsystemen mit hohem Volumen zu verwenden.
Hinweis: Der entsprechende Handler ist onEmitParticles.
Dokumentation der Methode
void burst(int count)
Gibt eine durch count festgelegte Anzahl von Partikeln sofort aus diesem Emitter aus.
void burst(int count, int x, int y)
Sendet sofort eine durch count festgelegte Anzahl von Partikeln aus diesem Emitter aus. Die Partikel werden so emittiert, als ob der Emitter bei (x, y) positioniert wäre, aber alle anderen Eigenschaften sind die gleichen.
void pulse(int duration)
Wenn der Emitter nicht aktiviert ist, schaltet er ihn für die angegebene Zeit duration (in Millisekunden) ein und schaltet ihn dann wieder aus.
© 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.