Auf dieser Seite

Emitter QML Type

Gibt logische Partikel ab. Mehr...

Import Statement: import QtQuick.Particles
Inherited By:

TrailEmitter

Eigenschaften

Signale

Methoden

  • void burst(int count)
  • void burst(int count, int x, int y)
  • void pulse(int duration)

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.