ImageParticle QML Type

Zur Visualisierung logischer Partikel mithilfe eines Bildes. Mehr…

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• alpha : real
• alphaVariation : real
• autoRotation : bool
• blueVariation : real
• color : color
• colorTable : url
• colorVariation : real
• entryEffect : EntryEffect
• greenVariation : real
• opacityTable : url
• redVariation : real
• rotation : real
• rotationVariation : real
• rotationVelocity : real
• rotationVelocityVariation : real
• sizeTable : url
• source : url
• sprites : list<Sprite>
• spritesInterpolate : bool
• status : Status
• xVector : StochasticDirection
• yVector : StochasticDirection

Ausführliche Beschreibung

Dieses Element stellt ein logisches Partikel als Bild dar. Das Bild kann

• eingefärbt
• gedreht
• verzerrt
• eine spritebasierte Animation

„ImageParticles“ tauschen implizit Daten über Partikel aus, wenn mehrere „ImageParticles“ dieselbe logische Partikelgruppe darstellen. Dies erfolgt anhand der vier oben aufgeführten Eigenschaften. Wenn also ein „ImageParticle“ Daten für die Darstellung der Partikel in einer dieser Eigenschaften definiert und das andere nicht, werden die Partikel in diesem Aspekt automatisch von beiden gleich dargestellt. Dies ist vor allem dann nützlich, wenn es eine zufällige Variation des Partikels gibt, die beim Wechsel des Zeichners erhalten bleiben soll. Wenn beide ImageParticles festlegen, wie sie in diesem Aspekt erscheinen sollen, weichen sie voneinander ab und jedes wird so dargestellt, wie es definiert ist.

Diese gemeinsame Nutzung von Daten erfolgt im Hintergrund, je nachdem, ob Eigenschaften implizit oder explizit festgelegt wurden. Ein Nachteil der aktuellen Implementierung besteht darin, dass die Funktionen nur als Ganzes zurückgesetzt werden können. Wenn Sie also ein Attribut, das die Farbe beeinflusst, wie beispielsweise „ redVariation “, explizit festlegen und es anschließend zurücksetzen (indem Sie „ redVariation “ auf „undefined“ setzen), werden alle Farbdaten zurückgesetzt und es erhält einen impliziten Wert, der einer gemeinsam genutzten Farbe aus anderen ImageParticles entspricht.

Dokumentation zu den Eigenschaften

alpha : real

Ein Alpha-Wert, der auf das Bild angewendet werden soll. Dieser Wert wird mit dem Wert im Bild und dem Wert in der Farbeigenschaft multipliziert.

Partikel werden additiv gemischt, sodass ein niedrigerer Alpha-Wert bei einzelnen Partikeln zu stärkeren Effekten führt, wenn sich mehrere Partikel überlappen.

Der Alpha-Wert wird auf einer Skala von 0,0 bis 1,0 gemessen.

Der Standardwert ist 1,0.

alphaVariation : real

Die Abweichung im Alpha-Kanal zwischen den Partikeln.

Der Alpha-Wert wird auf einer Skala von 0,0 bis 1,0 gemessen.

Der Standardwert ist 0,0.

autoRotation : bool

Wenn dieser Wert auf „true“ gesetzt ist, wird zusätzlich zur Partikelrotation eine Drehung angewendet, sodass das Partikel in Fahrtrichtung ausgerichtet ist. Um das Partikel von der Fahrtrichtung weg auszurichten, setzen Sie „autoRotation“ auf „true“ und „rotation“ auf 180.

Die Standardeinstellung ist „false“.

blueVariation : real

Die Abweichung im blauen Farbkanal zwischen den Partikeln.

Die Farbe wird pro Kanal auf einer Skala von 0,0 bis 1,0 gemessen.

Der Standardwert ist 0,0.

color : color

Wenn eine Farbe angegeben wird, wird das bereitgestellte Bild damit eingefärbt.

Standardmäßig ist Weiß eingestellt (keine Änderung).

colorTable : url

Ein Bild, dessen Farbe als eindimensionale Textur verwendet wird, um die Farbveränderung im Laufe der Lebensdauer zu bestimmen. Wenn sich das Partikel beispielsweise in der Mitte seiner Lebensdauer befindet, nimmt es die Farbe an, die in der Mitte des Bildes festgelegt ist.

Diese Farbe wird mit der Farbeigenschaft und der Farbe des Quellbildes gemischt.

colorVariation : real

Diese Zahl steht für die Farbabweichung, die auf einzelne Partikel angewendet wird. Die Einstellung von „colorVariation“ entspricht der Einstellung von „ redVariation “, „ greenVariation “ und „ blueVariation “ auf denselben Wert.

Jeder Kanal kann je nach Partikel um bis zu „colorVariation“ von seiner üblichen Farbe abweichen.

Die Farbe wird pro Kanal auf einer Skala von 0,0 bis 1,0 gemessen.

Der Standardwert ist 0,0

entryEffect : EntryEffect

Diese Eigenschaft bietet einfache und kostengünstige Ein- und Ausblendeffekte für die Partikel. Informationen zur detaillierten Steuerung finden Sie unter sizeTable und opacityTable.

Zulässige Werte sind

Der Standardwert lautet „ ImageParticle.Fade “.

greenVariation : real

Die Abweichung im grünen Farbkanal zwischen den Partikeln.

Die Farbe wird pro Kanal auf einer Skala von 0,0 bis 1,0 gemessen.

Der Standardwert ist 0,0.

opacityTable : url

Ein Bild, dessen Deckkraft als 1D-Textur verwendet wird, um die Größe im Laufe der Lebensdauer zu bestimmen.

Diese Eigenschaft wird voraussichtlich in Kürze entfernt, zugunsten benutzerdefinierter Beschleunigungskurven zur Steuerung der Deckkraft im Verlauf der Lebensdauer.

redVariation : real

Die Abweichung im roten Farbkanal zwischen den Partikeln.

Die Farbe wird pro Kanal auf einer Skala von 0,0 bis 1,0 gemessen.

Der Standardwert ist 0,0.

rotation : real

Wenn diese Option aktiviert ist, wird das Bild um diesen Winkel gedreht, bevor es gezeichnet wird.

Die Partikelkoordinaten werden nicht transformiert.

rotationVariation : real

Wenn diese Option aktiviert ist, variiert die Rotation der einzelnen Partikel um bis zu diesen Wert von Partikel zu Partikel.

rotationVelocity : real

Wenn diese Option aktiviert ist, drehen sich die Partikel mit dieser Geschwindigkeit in Grad pro Sekunde.

rotationVelocityVariation : real

Wenn diese Option aktiviert ist, weicht die „ rotationVelocity “ einzelner Partikel um bis zu diesen Wert voneinander ab.

sizeTable : url

Ein Bild, dessen Deckkraft als 1D-Textur verwendet wird, um die Größe im Laufe der Lebensdauer zu bestimmen.

Diese Eigenschaft wird voraussichtlich in Kürze entfernt, zugunsten benutzerdefinierter Beschleunigungskurven zur Bestimmung der Größe im Laufe der Lebensdauer.

source : url

Das zu verwendende Quellbild.

Wenn es sich bei dem Bild um eine Sprite-Animation handelt, verwenden Sie stattdessen die Eigenschaft „sprite“.

Seit Qt 5.2 werden einige Standardbilder als Ressourcen bereitgestellt, um die Prototypenerstellung zu erleichtern:

Beachten Sie, dass die Bilder weiß und halbtransparent sind, damit die Farbgebung und die Alpha-Stufen ihre maximale Wirkung entfalten können.

sprites : list<Sprite> [read-only]

Das Sprite bzw. die Sprites, die zum Zeichnen dieses Partikels verwendet werden.

Beachten Sie, dass das Sprite-Bild entsprechend der Größe des gerenderten Partikels auf ein Quadrat skaliert wird.

Ausführliche Informationen finden Sie in der Übersicht zu Sprite-Animationen.

spritesInterpolate : bool

Wenn dieser Wert auf „true“ gesetzt ist, werden Sprite-Partikel bei jedem gerenderten Frame zwischen den Sprite-Frames interpoliert, wodurch die Sprites flüssiger wirken.

Die Standardeinstellung ist „true“.

status : Status [read-only]

Der Status des Ladevorgangs des Bildes.

xVector : StochasticDirection

Ermöglicht es Ihnen, das Partikelbild beim Zeichnen zu verzerren. Das rechteckige Bild wird so verzerrt, dass die horizontalen Seiten die Form dieses Vektors annehmen statt (1,0).

yVector : StochasticDirection

Ermöglicht es Ihnen, das Partikelbild beim Zeichnen zu verzerren. Das rechteckige Bild wird so verzerrt, dass die vertikalen Seiten die Form dieses Vektors annehmen statt (0,1).