ImageParticle QML Type

Zur Visualisierung von logischen Partikeln mit Hilfe 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

Detaillierte Beschreibung

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

• eingefärbt
• gedreht
• deformiert
• eine Sprite-basierte Animation

ImageParticles teilen sich implizit Daten über Partikel, wenn mehrere ImageParticles dieselbe logische Partikelgruppe malen. Dies wird entlang der vier oben aufgeführten Fähigkeiten aufgeteilt. Wenn also ein ImageParticle Daten für das Rendering der Partikel in einer dieser Fähigkeiten definiert und das andere nicht, dann zeichnen beide die Partikel in diesem Aspekt automatisch gleich. Dies ist vor allem dann nützlich, wenn es eine zufällige Variation der Partikel gibt, die beim Wechsel des Malers erhalten bleiben soll. Wenn beide ImageParticles definieren, wie sie für diesen Aspekt erscheinen sollen, weichen sie voneinander ab und jedes erscheint so, wie es definiert ist.

Diese gemeinsame Nutzung von Daten erfolgt hinter den Kulissen, je nachdem, ob die Eigenschaften implizit oder explizit festgelegt wurden. Ein Nachteil der derzeitigen Implementierung ist, dass es nur möglich ist, die Fähigkeiten als Ganzes zurückzusetzen. Wenn Sie also ein Attribut, das sich auf die Farbe auswirkt, wie z. B. redVariation, explizit setzen und es dann zurücksetzen (indem Sie redVariation auf undefiniert setzen), werden alle Farbdaten zurückgesetzt und es beginnt, einen impliziten Wert einer gemeinsam genutzten Farbe von anderen ImageParticles zu haben.

Dokumentation der Eigenschaft

alpha : real

Ein Alphawert, der auf das Bild angewendet wird. Dieser Wert wird mit dem Wert im Bild und dem Wert in der Farbeigenschaft multipliziert.

Partikel haben eine additive Überblendung, so dass ein niedrigerer Alphawert für einzelne Partikel zu stärkeren Effekten führt, wenn sich mehrere Partikel überlappen.

Alpha wird von 0,0 bis 1,0 gemessen.

Standardwert ist 1.0

alphaVariation : real

Die Variation im Alphakanal zwischen den Partikeln.

Alpha wird von 0,0 bis 1,0 gemessen.

Standard ist 0.0

autoRotation : bool

Bei true wird eine Drehung auf die Partikeldrehung angewendet, so dass sie in Fahrtrichtung zeigt. Um also entgegen der Fahrtrichtung zu drehen, setzen Sie autoRotation auf true und rotation auf 180.

Standard ist false

blueVariation : real

Die Variation im blauen Farbkanal zwischen den Partikeln.

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

Standardwert ist 0.0

color : color

Wenn eine Farbe angegeben wird, wird das angegebene Bild mit dieser Farbe eingefärbt.

Die Vorgabe ist weiß (keine Änderung).

colorTable : url

Ein Bild, dessen Farbe als 1D-Textur verwendet wird, um die Farbe während der Lebensdauer zu bestimmen. Wenn das Partikel z. B. die Hälfte seiner Lebensdauer erreicht hat, hat es die Farbe, die in der Mitte des Bildes angegeben ist.

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

colorVariation : real

Diese Zahl steht für die Farbvariation, die auf einzelne Partikel angewendet wird. Das Setzen von colorVariation ist dasselbe wie das Setzen von redVariation, greenVariation und blueVariation auf dieselbe Zahl.

Jeder Kanal kann zwischen den Partikeln um bis zu colorVariation von seiner normalen Farbe abweichen.

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

Voreinstellung ist 0.0

entryEffect : EntryEffect

Diese Eigenschaft ermöglicht einfache und kostengünstige Ein- und Ausstiegseffekte für die Partikel. Für eine feinkörnige Steuerung siehe sizeTable und opacityTable.

Akzeptable Werte sind

Der Standardwert ist ImageParticle.Fade.

greenVariation : real

Die Variation im grünen Farbkanal zwischen den Partikeln.

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

Standardwert ist 0.0

opacityTable : url

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

Diese Eigenschaft wird voraussichtlich in Kürze zugunsten von benutzerdefinierten Lockerungskurven zur Bestimmung der Deckkraft über die Lebensdauer entfernt werden.

redVariation : real

Die Variation im roten Farbkanal zwischen den Partikeln.

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

Standardwert ist 0.0

rotation : real

Wenn diese Option gesetzt ist, wird das Bild um so viele Grad gedreht, bevor es gezeichnet wird.

Die Partikelkoordinaten werden nicht transformiert.

rotationVariation : real

Wenn diese Option aktiviert ist, variiert die Rotation einzelner Partikel um bis zu diesem Wert.

rotationVelocity : real

Wenn diese Option gesetzt ist, rotieren die Partikel mit dieser Geschwindigkeit in Grad/Sekunde.

rotationVelocityVariation : real

Bei dieser Einstellung variiert rotationVelocity zwischen den einzelnen Partikeln um bis zu diesem Wert.

sizeTable : url

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

Diese Eigenschaft wird voraussichtlich in Kürze zugunsten von benutzerdefinierten Erleichterungskurven zur Bestimmung der Größe über die Lebensdauer entfernt werden.

source : url

Das zu verwendende Quellbild.

Wenn das Bild eine Sprite-Animation ist, verwenden Sie stattdessen die Eigenschaft sprite.

Seit Qt 5.2 werden einige Standardbilder als Ressourcen bereitgestellt, um das Prototyping zu erleichtern:

Beachten Sie, dass die Bilder weiß und halbtransparent sind, damit die Einfärbung und die Alpha-Ebenen maximale Wirkung entfalten können.

sprites : list<Sprite> [read-only]

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

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

Für weitere Details siehe die Übersicht über Sprite-Animationen.

spritesInterpolate : bool

Wenn diese Option auf true gesetzt ist, werden die Sprite-Partikel bei jedem gerenderten Frame zwischen den Sprite-Frames interpoliert, wodurch die Sprites glatter aussehen.

Die Voreinstellung ist true.

status : Status [read-only]

Der Status des Ladens des Bildes.

xVector : StochasticDirection

Ermöglicht es Ihnen, das Partikelbild beim Zeichnen zu verformen. Das rechteckige Bild wird so verformt, dass die horizontalen Seiten die Form dieses Vektors anstelle von (1,0) haben.

yVector : StochasticDirection

Ermöglicht es, das Partikelbild beim Zeichnen zu deformieren. Das rechteckige Bild wird so verformt, dass die vertikalen Seiten die Form dieses Vektors anstelle von (0,1) haben.