Auf dieser Seite

Attractor3D QML Type

Zieht Partikel zu einer Position oder einer Form hin. Mehr...

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

Affector3D

Eigenschaften

Ausführliche Beschreibung

Dieses Element zieht Partikel zu einer Position innerhalb der 3D-Ansicht an. Um die Schwerkraft eines massereichen Objekts zu modellieren, dessen Schwerpunkt weit entfernt liegt, verwenden Sie „ Gravity3D “.

Die Anziehungsposition wird entweder über die Parameter „ position “ und „ positionVariation “ oder über „ shape “ definiert. Sind beide definiert, wird „ shape “ verwendet.

Dokumentation der Eigenschaft

duration : int

Diese Eigenschaft legt fest, wie lange es in Millisekunden dauert, bis die Partikel die Anziehungsposition erreichen. Wenn der Wert -1 ist, wird die Lebensdauer der Partikel als Dauer verwendet.

Der Standardwert lautet „ -1 “.

durationVariation : int

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

Der Standardwert ist 0 (keine Schwankung).

hideAtEnd : bool

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

Der Standardwert lautet „ false “.

positionVariation : vector3d

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

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 legt die Anzahl der möglichen Positionen fest, die innerhalb der Attraktorform gespeichert werden. Standardmäßig entspricht diese Anzahl der Partikelanzahl, es kann jedoch eine geringere Anzahl verwendet werden, um den Cache zu verkleinern. Eine höhere Anzahl kann verwendet werden, um zusätzliche Zufälligkeit zu erzeugen.

shape : ParticleAbstractShape3D

Diese Eigenschaft definiert eine „ ParticleAbstractShape3D “ für die Anziehung von Partikeln. Jedes Partikel wird an eine zufällige Position innerhalb dieser Form angezogen. Dies ist eine Alternative zur Definition von „ position “ und „ positionVariation “. Hier ist ein Beispiel, wie Partikel am Ende des Partikel- lifeSpan s an einen zufälligen Punkt innerhalb einer Kugel angezogen werden:

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

Siehe auch Node::position und positionVariation.

useCachedPositions : bool

Diese Eigenschaft legt fest, ob der Attraktor mögliche Positionen innerhalb seiner Form zwischenspeichert. Zwischengespeicherte Positionen führen zu weniger zufälligen Ergebnissen, sind jedoch leistungsstärker.

Der Standardwert ist „ true “.

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