Emitter QML Type
Gibt logische Partikel ab. 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
Ausführliche Beschreibung
Dieses Element sendet logische Partikel mit den angegebenen Startattributen an die „ ParticleSystem “.
Beachten Sie, dass logische Partikel nicht automatisch gerendert werden; Sie benötigen ein oder mehrere „ ParticlePainter “-Elemente, um sie darzustellen.
Beachten Sie, dass die angegebenen Startattribute zu jedem Zeitpunkt während der Lebensdauer des Partikels von jedem „Affector“-Element im selben „ ParticleSystem “ geändert werden können. Dies umfasst auch Attribute wie die Lebensdauer.
Dokumentation zu den Eigenschaften
acceleration : StochasticDirection
Die Anfangsbeschleunigung der emittierten Teilchen.
emitRate : real
Anzahl der pro Sekunde emittierten Partikel.
Der Standardwert beträgt 10 Partikel pro Sekunde.
enabled : bool
Wird dieser Wert auf „false“ gesetzt, stellt der Emitter die Emissionen ein, bis er wieder 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 linear zwischen diesem Wert und der Startgröße interpoliert. Ist endSize gleich -1, bleibt die Größe des Partikels konstant auf der Startgröße.
Der Standardwert ist -1.
group : string
Dies ist die logische Partikelgruppe, in die sie emittiert wird.
Der Standardwert ist „“ (leere Zeichenfolge).
lifeSpan : int
Die Zeit in Millisekunden, die jedes emittierte Teilchen bestehen bleiben soll.
Wenn Sie nicht möchten, dass Partikel nach einer bestimmten Zeit automatisch verschwinden – beispielsweise, wenn Sie sie manuell entfernen möchten –, setzen Sie „lifeSpan“ auf „Emitter.InfiniteLife“.
„lifeSpan“-Werte größer oder gleich 600000 (10 Minuten) werden als unendlich behandelt. Partikel mit einem „lifeSpan“-Wert kleiner oder gleich 0 sind von Anfang an erloschen.
Der Standardwert beträgt 1000 (eine Sekunde).
lifeSpanVariation : int
Die Lebensdauer der Teilchen kann um diesen Wert in beide Richtungen variieren.
Der Standardwert ist 0.
maximumEmitted : int
Die maximale Anzahl an Partikeln, die dieser Emitter gleichzeitig aktiv haben kann.
Dies kann zur Leistungsoptimierung (bei Verwendung von „Burst“ und „Pulse“) oder zur zeitlichen Staffelung der Emissionen eingestellt werden.
Wird hier ein Wert unter Null eingestellt, gibt es keine Obergrenze für die Anzahl der Partikel, die dieser Emitter gleichzeitig aktiv haben kann.
Der Standardwert ist -1.
shape : Shape
Diese Form wird mit der Größe des Emitters angewendet. Partikel werden zufällig aus jedem Bereich emittiert, der von der Form abgedeckt wird.
Die Standardform ist ein ausgefülltes Rechteck, das dem gesamten Begrenzungsrahmen des Emitters entspricht.
size : real
Die Größe der Partikel in Pixeln zu Beginn ihrer Lebensdauer.
Der Standardwert beträgt 16.
sizeVariation : real
Die Größe eines Partikels kann um diesen Wert nach oben oder unten von „size/endSize “ abweichen. Für ein einzelnes Partikel wird sowohl an „size“ als auch an „ endSize “ derselbe Zufallswert addiert.
Der Standardwert ist 0.
startTime : int
Wird dieser Wert beim Laden des Emitters festgelegt, sendet dieser Partikel aus der Vergangenheit aus, und zwar bis zu startTime Millisekunden zurück. Diese werden so simuliert, als wären sie zu diesem Zeitpunkt ausgesendet worden, es werden jedoch keine Effekte auf sie angewendet. Effekte werden erst ab dem aktuellen Zeitpunkt wirksam.
system : ParticleSystem
Dies ist das Partikelsystem, in das der Emitter Partikel aussendet. Dies kann weggelassen werden, wenn der Emitter ein direktes untergeordnetes Element des ParticleSystem
velocity : StochasticDirection
Die Anfangsgeschwindigkeit der emittierten Teilchen.
velocityFromMovement : real
Ist dieser Wert ungleich Null, wird den Partikeln bei jeder Bewegung des Emitters eine zusätzliche Anfangsgeschwindigkeit verliehen, die auf dieser Bewegung basiert. Der zusätzliche Vektor hat denselben Winkel wie die Bewegung des Emitters, wobei seine Größe dem Produkt aus der Größe der Emitterbewegung und dem Wert „velocityFromMovement“ entspricht.
Der Standardwert ist 0.
Signal-Dokumentation
emitParticles(Array particles)
Dieses Signal wird ausgelöst, wenn Partikel emittiert werden. „ particles “ ist ein JavaScript-Array aus Particle-Objekten. Sie können die Partikelattribute direkt innerhalb des Handlers ändern.
Hinweis: Da die Ausführungvon JavaScript langsamer ist, wird davon abgeraten, dies in Partikelsystemen mit hohem Durchsatz zu verwenden.
Hinweis: Der entsprechende Handler ist onEmitParticles.
Methodendokumentation
void burst(int count)
Gibt sofort eine durch „ count “ festgelegte Anzahl von Partikeln von diesem Emitter ab.
void burst(int count, int x, int y)
Gibt sofort eine Anzahl von Partikeln aus diesem Emitter ab, die durch ` count` festgelegt ist. Die Partikel werden so emittiert, als befände sich der Emitter an der Position (x, y), wobei alle anderen Eigenschaften unverändert bleiben.
void pulse(int duration)
Wenn der Emitter nicht aktiviert ist, wird er für eine angegebene Dauer ( duration, in Millisekunden) aktiviert und anschließend wieder deaktiviert.
© 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.