ImageParticle QML Type
Zur Visualisierung von logischen Partikeln mit Hilfe eines Bildes. Mehr...
| Import Statement: | import QtQuick.Particles |
| Inherits: |
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.
Hinweis: Die maximale Anzahl von Bildpartikeln ist auf 16383 begrenzt.
Eigenschaft Dokumentation
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.
Die Voreinstellung ist 1.0.
alphaVariation : real |
Die Variation im Alphakanal zwischen Partikeln.
Alpha wird im Bereich von 0,0 bis 1,0 gemessen.
Standardwert ist 0.0
autoRotation : bool |
Wenn diese Option auf true gesetzt ist, wird eine Drehung auf die Drehung der Partikel angewendet, so dass sie in Fahrtrichtung zeigen. Um sich also von der Fahrtrichtung abzuwenden, setzen Sie autoRotation auf true und rotation auf 180.
Die Voreinstellung ist false.
blueVariation : real |
Die Variation im blauen Farbkanal zwischen den Partikeln.
Die Farbe wird pro Kanal von 0,0 bis 1,0 gemessen.
Die Vorgabe ist 0.0.
color : color |
Wenn eine Farbe angegeben wird, wird das bereitgestellte 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 über die Lebensdauer zu bestimmen. Wenn das Partikel z.B. die Hälfte seiner Lebensdauer erreicht hat, wird es die Farbe haben, 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 Einstellen von colorVariation ist dasselbe wie das Einstellen 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 bietet einfache und billige Eingangs- und Ausgangseffekte für die Partikel. Für eine feinkörnige Steuerung siehe sizeTable und opacityTable.
Akzeptable Werte sind
| Konstante | Beschreibung |
|---|---|
ImageParticle.None | Partikel erscheinen und verschwinden einfach. |
ImageParticle.Fade | Partikel werden zu Beginn ihrer Lebensdauer mit einer Deckkraft von 0 eingeblendet und am Ende wieder auf 0 ausgeblendet. |
ImageParticle.Scale | Partikel skalieren zu Beginn ihrer Lebensdauer von 0 auf 0 und am Ende wieder auf 0. |
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.
Der 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.
Die Voreinstellung ist 0,0.
rotation : real |
Wenn diese Option gesetzt ist, wird das Bild vor dem Zeichnen um so viele Grad gedreht.
Die Partikelkoordinaten werden nicht transformiert.
rotationVariation : real |
Wenn gesetzt, variiert die Rotation der einzelnen Partikel um diesen Wert zwischen den Partikeln.
rotationVelocity : real |
Wenn gesetzt, rotieren die Partikel mit dieser Geschwindigkeit in Grad/Sekunde.
rotationVelocityVariation : real |
Wenn gesetzt, variiert die rotationVelocity der einzelnen Partikel um bis zu diesem Wert zwischen den Partikeln.
sizeTable : url |
Ein Bild, dessen Deckkraft als 1D-Textur verwendet wird, um die Größe über die Lebensdauer zu bestimmen.
Es wird erwartet, dass diese Eigenschaft in Kürze zugunsten von benutzerdefinierten Lockerungskurven zur Bestimmung der Größe über die Lebensdauer entfernt wird.
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:
| qrc:///particleresources/star.png |  |
| qrc:///particleresources/glowdot.png |  |
| qrc:///particleresources/fuzzydot.png |  |
Beachten Sie, dass die Bilder weiß und halbtransparent sind, damit die Einfärbung und die Alpha-Ebenen maximale Wirkung entfalten können.
Das Sprite oder die Sprites, die zum Zeichnen dieses Partikels verwendet werden.
Beachte, dass das Sprite-Bild auf ein Quadrat skaliert wird, basierend auf der Größe des gerenderten Partikels.
Für weitere Details, siehe die Übersicht über Sprite-Animationen.
spritesInterpolate : bool |
Wenn auf true gesetzt, werden Sprite-Partikel zwischen den Sprite-Frames jedes gerenderten Frames interpoliert, wodurch die Sprites glatter aussehen.
Die Voreinstellung ist true.
status : Status |
Der Status des Ladens des Bildes.
xVector : StochasticDirection |
Ermöglicht es, das Partikelbild beim Zeichnen zu verformen. Das rechteckige Bild wird so deformiert, 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 haben und nicht die Form von (0,1).
© 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.
