Attractor3D QML Type

Zieht Partikel in Richtung einer Position oder einer Form an. Mehr...

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

Affector3D

Eigenschaften

Detaillierte Beschreibung

Dieses Element zieht Partikel in Richtung einer Position innerhalb der 3D-Ansicht an. Um die Schwerkraft eines massiven Objekts zu modellieren, dessen Schwerpunkt weit entfernt ist, verwenden Sie Gravity3D.

Die Anziehungsposition wird entweder mit position und positionVariation oder mit shape definiert. Wenn beide definiert sind, wird shape verwendet.

Eigenschaft Dokumentation

duration : int

Diese Eigenschaft definiert die Dauer in Millisekunden, wie lange die Partikel brauchen, um die Anziehungsposition zu erreichen. Wenn der Wert -1 ist, wird die Lebensdauer der Partikel als Dauer verwendet.

Der Standardwert ist -1.


durationVariation : int

Diese Eigenschaft definiert die Dauer in Millisekunden. Die tatsächliche Dauer bis zum Erreichen des Attraktors liegt zwischen duration - durationVariation und duration + durationVariation.

Der Standardwert ist 0 (keine Variation).


hideAtEnd : bool

Diese Eigenschaft legt fest, ob das Teilchen verschwinden soll, wenn es den Attraktor erreicht.

Der Standardwert ist false.


positionVariation : vector3d

Diese Eigenschaft definiert die Variation der Anziehungsposition. Sie kann verwendet werden, um nicht in einen einzelnen Punkt zu locken, sondern zufällig in einen größeren Bereich. Hier ist ein Beispiel, wie Partikel innerhalb von 2 bis 4 Sekunden in einen zufälligen Punkt innerhalb des Würfels (50, 50, 50) an der Position (100, 0, 0) angezogen werden können:

Attractor3D {
    position: Qt.vector3d(100, 0, 0)
    positionVariation: Qt.vector3d(50, 50, 50)
    duration: 3000
    durationVariation: 1000
}

Der Standardwert ist (0, 0, 0) (keine Variation).

Siehe auch Node::position und shape.


positionsAmount : int

Diese Eigenschaft definiert die Anzahl der möglichen Positionen, die innerhalb der Attraktorform gespeichert werden. Standardmäßig entspricht die Anzahl der möglichen Positionen der Anzahl der Partikel, aber ein geringerer Wert kann für einen kleineren Cache verwendet werden. Ein höherer Wert kann für eine zusätzliche Randomisierung verwendet werden.


Diese Eigenschaft definiert eine ParticleAbstractShape3D für die Anziehung der Partikel. Jedes Partikel wird in eine zufällige Position innerhalb dieser Form angezogen. Dies ist eine Alternative zur Definition von position und positionVariation. Hier ist ein Beispiel, wie Partikel in einen zufälligen Punkt innerhalb der Kugel durch das Ende der Partikel lifeSpan angezogen werden können:

Attractor3D {
    position: Qt.vector3d(100, 0, 0)
    shape: ParticleShape3D {
        type: ParticleShape3D.Sphere
        fill: true
    }
}

Siehe auch Node::position und positionVariation.


useCachedPositions : bool

Diese Eigenschaft definiert, ob der Attraktor mögliche Positionen innerhalb seiner Form zwischenspeichert. Gepufferte Positionen führen zu weniger zufälligen Ergebnissen, sind aber besser für die Leistung.

Der Standardwert ist true.


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