Auf dieser Seite

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.

Dokumentation der Eigenschaften

duration : int

Diese Eigenschaft legt die Dauer in Millisekunden fest, die die Partikel benötigen, um die Aktionsposition 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 der Variation 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 man Partikel in einen zufälligen Punkt innerhalb des Würfels (50, 50, 50) an der Position (100, 0, 0) innerhalb von 2 bis 4 Sekunden anziehen kann:

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 in der Attraktorform gespeichert werden. Standardmäßig entspricht die Anzahl der möglichen Positionen der Partikelanzahl, aber ein geringerer Wert kann für einen kleineren Cache verwendet werden. Ein höherer Wert kann für zusätzliche Randomisierung verwendet werden.

shape : ParticleAbstractShape3D

Diese Eigenschaft definiert eine ParticleAbstractShape3D für die Anziehung von Partikeln. Jedes Teilchen 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 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 legt fest, ob der Attraktor mögliche Positionen innerhalb seiner Form zwischenspeichert. Zwischengespeicherte Positionen führen zu weniger zufälligen Ergebnissen, sind aber besser für die Leistung.

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.