Particle3D QML Type
Abstraktes logisches Teilchen. Mehr...
| Import Statement: | import QtQuick3D.Particles3D |
| Since: | Qt 6.2 |
| Inherits: | |
| Inherited By: | LineParticle3D, ModelBlendParticle3D, ModelParticle3D, and SpriteParticle3D |
Eigenschaften
- AlignMode : enumeration
- FadeType : enumeration
- SortMode : enumeration
- alignMode : AlignMode
- alignTargetPosition : vector3d
- color : color
- colorVariation : vector4d
- fadeInDuration : int
- fadeInEffect : FadeType
- fadeOutDuration : int
- fadeOutEffect : FadeType
- hasTransparency : bool
- maxAmount : int
- sortMode : SortMode
- unifiedColorVariation : bool
Ausführliche Beschreibung
Dieses Element definiert die gemeinsamen Eigenschaften der logischen Partikel. Particle3D ist eine abstrakte Basisklasse für Partikel; verwenden Sie stattdessen „ ModelParticle3D “ oder „ SpriteParticle3D “.
Hinweis: Im Gegensatz zu den bei Modellen verwendeten Materialien werden Partikel standardmäßig unter der Annahme von Halbtransparenz und somit mit aktivierter Überblendung gerendert. Aufgrund von Partikeltexturen, Farb- (Alpha-)Variationen, Überblendungen usw. ist dies in den meisten Fällen das gewünschte Verhalten. Wenn Sie die Überblendung nicht benötigen, setzen Sie „ hasTransparency “ auf „ false “, um mögliche Leistungssteigerungen zu erzielen.
Dokumentation zu den Eigenschaften
AlignMode : enumeration
Legt die Art der Ausrichtung fest.
| Konstante | Beschreibung |
|---|---|
Particle3D.AlignNone | Keine Ausrichtung. Die Partikelrotation kann mit ` particleRotation` definiert werden. |
Particle3D.AlignTowardsTarget | Richte die Partikel in Richtung „ alignTargetPosition “ aus. |
Particle3D.AlignTowardsStartVelocity | Richtet die Partikel in Richtung ihrer ursprünglichen „ velocity “-Richtung aus. |
FadeType : enumeration
Legt die Art des Überblendungseffekts fest.
| Konstante | Beschreibung |
|---|---|
Particle3D.FadeNone | Kein Überblenden. |
Particle3D.FadeOpacity | Die Partikelopazität wird von 0,0 auf 0,0 ausgeblendet. |
Particle3D.FadeScale | Die Partikelgröße wird von 0,0 auf 0,0 ausgeblendet. |
SortMode : enumeration
Legt den Sortiermodus des Partikels fest. Der Sortiermodus bestimmt die Reihenfolge, in der die Partikel gezeichnet werden.
| Konstante | Beschreibung |
|---|---|
Particle3D.SortNone | Keine Sortierung. |
Particle3D.SortNewest | Sortierung nach Partikellebensdauer, neueste zuerst. |
Particle3D.SortOldest | Sortierung nach Partikellebensdauer, älteste zuerst. |
Particle3D.SortDistance | Sortieren nach Entfernung zur Kamera, am weitesten entfernte zuerst. |
alignMode : AlignMode
Diese Eigenschaft legt den für die Partikel verwendeten Ausrichtungsmodus fest. Unter Partikelausrichtung versteht man die Richtung, in die die Partikel zeigen.
Hinweis: Wenn die Eigenschaft „ SpriteParticle3D “ billboard auf „ true “ gesetzt ist, hat „alignMode“ keine Auswirkung.
Der Standardwert ist „ Particle3D.AlignNone “.
Siehe auch „ alignTargetPosition “.
alignTargetPosition : vector3d
Diese Eigenschaft legt fest, an welcher Position die Partikel ausgerichtet werden. Diese Eigenschaft wirkt sich nur aus, wenn die Option „ alignMode “ auf „ Particle3D.AlignTowardsTarget “ gesetzt ist.
Siehe auch „ alignMode “.
color : color
Diese Eigenschaft legt die Grundfarbe fest, die für die Einfärbung der Partikel verwendet wird.
Der Standardwert ist „ "#FFFFFF" “ (weiß).
colorVariation : vector4d
Diese Eigenschaft legt die Farbvariation fest, die für die Einfärbung der Partikel verwendet wird. Die Werte liegen in RGBA-Reihenfolge vor, und jeder Wert sollte zwischen 0,0 (keine Variation) und 1,0 (volle Variation) liegen.
Um beispielsweise Partikel zu erzeugen, die durchscheinende Rottöne zwischen #ff0000 und #e50000 aufweisen, mit einer Deckkraft von 40 % bis 60 %:
ModelParticle3D {
...
color: "#7fff0000"
colorVariation: Qt.vector4d(0.1, 0.0, 0.0, 0.2)
}Der Standardwert ist (0, 0, 0, 0) (keine Variation).
Siehe auch unifiedColorVariation.
fadeInDuration : int
Diese Eigenschaft legt die Dauer des Einblendeffekts in Millisekunden fest.
Hinweis: Die Einblenddauern sind Teil der Partikel- lifeSpan. Wenn also z. B. „ lifeSpan “ 3000, „ fadeInDuration “ 500 und „ fadeOutDuration “ 500 beträgt, beträgt die Zeit, in der das Partikel vollständig sichtbar ist, 2000 ms.
Der Standardwert ist 250.
Siehe auch fadeInEffect und fadeOutDuration.
fadeInEffect : FadeType
Diese Eigenschaft legt den Überblendungseffekt fest, der beim Erscheinen der Partikel verwendet wird.
Der Standardwert ist „ Particle3D.FadeOpacity “.
Siehe auch „ fadeInDuration “ und „ fadeOutEffect “.
fadeOutDuration : int
Diese Eigenschaft legt die Dauer des Ausblendeffekts in Millisekunden fest.
Der Standardwert lautet „ 250 “.
Siehe auch „ fadeOutEffect “ und „ fadeInDuration “.
fadeOutEffect : FadeType
Diese Eigenschaft legt den Überblendungseffekt fest, der angewendet wird, wenn die Partikel ihre „ lifeSpan “ erreichen und verschwinden.
Der Standardwert ist „ Particle3D.FadeOpacity “.
Siehe auch „ fadeOutDuration “ und „ fadeInEffect “.
hasTransparency : bool
Diese Eigenschaft legt fest, ob das Partikel transparent ist und mit dem Hintergrund überblendet werden soll. In der Regel sollte dieser Wert auf „true“ gesetzt sein, beispielsweise wenn die Partikelfarbe nicht vollständig deckend ist, die Textur halbtransparente Pixel enthält oder die Deckkraft des Partikels ein- oder ausgeblendet wird. In bestimmten Fällen kann die Einstellung auf „false“ eine Optimierung darstellen.
Der Standardwert ist „ true “.
Siehe auch „ color “, „ fadeInEffect “ und „ fadeOutEffect “.
maxAmount : int
Diese Eigenschaft legt die maximale Anzahl an Partikeln fest, die gleichzeitig vorhanden sein können. Mit „ particlesUsed “ können Sie überprüfen, wie effizient die zugewiesenen Partikel genutzt werden. Ist der Wert für „maxAmount“ zu klein, werden Partikel wiederverwendet, bevor sie das Ende ihrer Lebensdauer („ lifeSpan “) erreichen. Ist der Wert für „maxAmount“ zu groß, wird unnötiger Speicher für die Partikel zugewiesen.
Hinweis: Durch Ändern des Werts für „maxAmount“ werden alle Partikel im Partikelsystem zurückgesetzt.
Der Standardwert ist „ 100 “.
sortMode : SortMode
Diese Eigenschaft legt den für die Partikel verwendeten Sortiermodus fest.
Der Standardwert lautet „ Particle3D.SortNone “.
unifiedColorVariation : bool
Diese Eigenschaft legt fest, ob die „ colorVariation “ einheitlich auf alle Farbkanäle angewendet werden soll. Das bedeutet, dass alle Abweichungen mit demselben Zufallswert angewendet werden.
Um beispielsweise Partikel zu erstellen, deren Gelbtöne zwischen „ #ffff00 “ und „ #7f7f00 “ liegen, sodass die Werte der Farbkanäle „ R “ und „ G “ immer gleich sind:
ModelParticle3D {
...
color: "#ffff00"
colorVariation: Qt.vector4d(0.5, 0.5, 0.0, 0.0)
unifiedColorVariation: true
}Der Standardwert ist false.
Siehe auch colorVariation.
© 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.