Emitter QML Type

Sendet logische Partikel aus. Mehr...

Import Statement: import QtQuick.Particles

Eigenschaften

Signale

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.

Eigenschaft Dokumentation

acceleration : StochasticDirection

Die Startbeschleunigung der emittierten Partikel.


emitRate : real

Anzahl der emittierten Partikel pro Sekunde.

Der Standardwert ist 10 Partikel pro Sekunde.


enabled : bool

Bei false hört der Emitter auf zu emittieren, 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 linear aus diesem Wert und der Größe 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 der Partikel emittieren wird.

Der Standardwert ist "" (leerer String).


lifeSpan : int

Die Zeit in Millisekunden, die jedes emittierte Partikel dauern soll.

Wenn du nicht möchtest, dass die Partikel nach einer bestimmten Zeit automatisch sterben, z. B. wenn du sie manuell entsorgen möchtest, setze 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 Lebensspanne der Partikel kann in beide Richtungen um diesen Wert variieren.

Der Standardwert ist 0.


maximumEmitted : int

Die maximale Anzahl von Partikeln, die dieser Emitter zu einem Zeitpunkt aktiv hat.

Dies kann zur Leistungsoptimierung (bei Verwendung von Burst und Pulse) oder zur Staffelung der Emissionen eingestellt 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 in Pixeln zu Beginn ihres Lebens.

Der Standardwert ist 16.


sizeVariation : real

Die Größe eines Partikels kann um diesen Wert nach oben oder unten von size/endSize abweichen. Die gleiche zufällige Addition wird zu Größe und endSize für ein einzelnes Partikel vorgenommen.

Der Standardwert ist 0.


startTime : int

Wenn dieser Wert beim Laden des Emitters gesetzt wird, dann wird er Partikel aus der Vergangenheit emittieren, bis zu startTime Millisekunden zurück. 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 Partikelsystems ist. ParticleSystem


velocity : StochasticDirection

Die Startgeschwindigkeit der emittierten Partikel.


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 ausgegeben, wenn Partikel emittiert werden. particles ist ein JavaScript-Array von Partikelobjekten. 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

burst(int count)

Sendet eine Anzahl von Partikeln, angegeben durch count, von diesem Emitter sofort aus.


burst(int count, int x, int y)

Sendet sofort eine durch count festgelegte Anzahl von Partikeln von diesem Emitter aus. Die Partikel werden so emittiert, als ob der Emitter auf (x, y) positioniert wäre, aber alle anderen Eigenschaften sind die gleichen.


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.


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