Particle3D QML Type

Abstraktes logisches Teilchen. Mehr...

Import Statement: import QtQuick3D.Particles3D
Since: Qt 6.2
Inherits:

Object3D

Inherited By:

ModelBlendParticle3D, ModelParticle3D, and SpriteParticle3D

Eigenschaften

Detaillierte Beschreibung

Dieses Element definiert die gemeinsamen Eigenschaften der logischen Partikel. Particle3D ist eine abstrakte Basisklasse von Partikeln, verwenden Sie stattdessen ModelParticle3D oder SpriteParticle3D.

Hinweis: Im Gegensatz zu den Materialien, die mit den Modellen verwendet werden, werden Partikel standardmäßig mit angenommener Semitransparenz gerendert, also mit aktiviertem Blending. Dies ist aufgrund von Partikeltexturen, Farbvariationen (Alpha), Überblendungen usw. in den meisten Fällen das gewünschte Verhalten. Wenn Sie die Überblendung nicht benötigen, setzen Sie hasTransparency auf false, um die Leistung zu verbessern.

Eigenschaft Dokumentation

AlignMode : enumeration

Definiert den Typ der Ausrichtung.

KonstanteBeschreibung
Particle3D.AlignNoneKeine Ausrichtung. Die Partikeldrehung kann mit particleRotation definiert werden.
Particle3D.AlignTowardsTargetAusrichtung der Partikel in alignTargetPosition Richtung.
Particle3D.AlignTowardsStartVelocityRichtet die Partikel in ihre Ausgangsrichtung velocity aus.

FadeType : enumeration

Definiert die Art des Fading-Effekts.

KonstanteBeschreibung
Particle3D.FadeNoneKeine Überblendung.
Particle3D.FadeOpacityÜberblendung der Partikeldurchsichtigkeit von/auf 0,0.
Particle3D.FadeScaleÜberblendung der Partikelskala von/auf 0,0.

SortMode : enumeration

Definiert den Sortiermodus der Partikel. Der Sortiermodus bestimmt die Reihenfolge, in der die Partikel gezeichnet werden.

KonstanteBeschreibung
Particle3D.SortNoneKeine Sortierung.
Particle3D.SortNewestSortierung nach der Lebensdauer der Partikel, die neuesten zuerst.
Particle3D.SortOldestSortierung nach der Lebensdauer der Partikel, die ältesten zuerst.
Particle3D.SortDistanceSortierung nach dem Abstand zur Kamera, am weitesten entfernt zuerst.

alignMode : AlignMode

Diese Eigenschaft definiert den Ausrichtungsmodus für die Partikel. Partikelausrichtung bedeutet die Richtung, in die die Partikel zeigen.

Hinweis: Wenn die Eigenschaft SpriteParticle3D billboard auf true eingestellt ist, hat alignMode keine Auswirkung.

Der Standardwert ist Particle3D.AlignNone.

Siehe auch alignTargetPosition.


alignTargetPosition : vector3d

Diese Eigenschaft definiert die Position, an der die Partikel ausgerichtet werden. Diese Eigenschaft wirkt sich nur aus, wenn die Eigenschaft alignMode auf Particle3D.AlignTowardsTarget eingestellt ist.

Siehe auch alignMode.


color : color

Diese Eigenschaft definiert die Grundfarbe, die für die Einfärbung der Partikel verwendet wird.

Der Standardwert ist "#FFFFFF" (weiß).


colorVariation : vector4d

Diese Eigenschaft definiert die Farbvariation, die für die Einfärbung der Partikel verwendet wird. Die Werte sind in RGBA-Reihenfolge und jeder Wert sollte zwischen 0,0 (keine Variation) und 1,0 (volle Variation) liegen.

Um beispielsweise Partikel zu erstellen, die durchscheinende rote Farben zwischen #ff0000 und #e50000 haben, 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 definiert die Dauer in Millisekunden für den Einblendeffekt.

Hinweis: Die Überblendungsdauern sind Teil der Partikel lifeSpan. Wenn also z.B. lifeSpan 3000, fadeInDuration 500 und fadeOutDuration 500 ist, ist die vollständig sichtbare Zeit des Partikels 2000ms.

Der Standardwert ist 250.

Siehe auch fadeInEffect und fadeOutDuration.


fadeInEffect : FadeType

Diese Eigenschaft definiert den Fading-Effekt, der verwendet wird, wenn die Partikel erscheinen.

Der Standardwert ist Particle3D.FadeOpacity.

Siehe auch fadeInDuration und fadeOutEffect.


fadeOutDuration : int

Diese Eigenschaft definiert die Dauer in Millisekunden für den Ausblendeffekt.

Der Standardwert ist 250.

Siehe auch fadeOutEffect und fadeInDuration.


fadeOutEffect : FadeType

Diese Eigenschaft legt den Ausblendeffekt fest, der verwendet 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 eine Transparenz hat und mit dem Hintergrund überblendet werden soll. Normalerweise sollte dies true sein, z.B. wenn die Partikelfarbe nicht volles Alpha hat, die Textur halbtransparente Pixel enthält oder die Deckkraft der Partikel ein- oder ausgeblendet ist. Die Einstellung false kann in bestimmten Fällen eine Optimierung darstellen.

Der Standardwert ist true.

Siehe auch color, fadeInEffect, und fadeOutEffect.


maxAmount : int

Diese Eigenschaft definiert die maximale Anzahl von Partikeln, die gleichzeitig existieren können. Sie können particlesUsed verwenden, um zu überprüfen, wie effizient die zugewiesenen Partikel genutzt werden. Ist maxAmount zu klein, werden Partikel wiederverwendet, bevor sie das Ende ihrer lifeSpan erreichen. Ist maxAmount zu groß, wird unnötiger Speicher für die Partikel zugewiesen.

Hinweis: Das Ändern von maxAmount setzt alle Partikel im Partikelsystem zurück.

Der Standardwert ist 100.


sortMode : SortMode

Diese Eigenschaft definiert den für die Partikel verwendeten Sortiermodus.

Der Standardwert ist Particle3D.SortNone.


unifiedColorVariation : bool

Diese Eigenschaft legt fest, ob die colorVariation gleichmäßig auf alle Farbkanäle angewendet werden soll. Das bedeutet, dass alle Variationen mit der gleichen Zufallsmenge angewendet werden.

Zum Beispiel, um Partikel zu erstellen, die gelbe Farben zwischen #ffff00 und #7f7f00 haben werden, so dass die Werte der Farbkanäle R und G immer die gleichen sind:

ModelParticle3D {
    ...
    color: "#ffff00"
    colorVariation: Qt.vector4d(0.5, 0.5, 0.0, 0.0)
    unifiedColorVariation: true
}

Der Standardwert ist false.

Siehe auch colorVariation.


© 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.