QAxisAccumulator Class

class Qt3DInput::QAxisAccumulator

QAxisAccumulator verarbeitet Geschwindigkeits- oder Beschleunigungsdaten von einem QAxis. Mehr....

Kopfzeile: #include <QAxisAccumulator>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dinput)
target_link_libraries(mytarget PRIVATE Qt6::3dinput)
qmake: QT += 3dinput
In QML: AxisAccumulator
Vererbt: Qt3DCore::QComponent
Status: Veraltet

Öffentliche Typen

enum SourceAxisType { Velocity, Acceleration }

Eigenschaften

Öffentliche Funktionen

QAxisAccumulator(Qt3DCore::QNode *parent = nullptr)
float scale() const
Qt3DInput::QAxis *sourceAxis() const
Qt3DInput::QAxisAccumulator::SourceAxisType sourceAxisType() const
float value() const
float velocity() const

Öffentliche Slots

void setScale(float scale)
void setSourceAxis(Qt3DInput::QAxis *sourceAxis)
void setSourceAxisType(Qt3DInput::QAxisAccumulator::SourceAxisType sourceAxisType)

Signale

void scaleChanged(float scale)
void sourceAxisChanged(Qt3DInput::QAxis *sourceAxis)
void sourceAxisTypeChanged(Qt3DInput::QAxisAccumulator::SourceAxisType sourceAxisType)
void valueChanged(float value)
void velocityChanged(float value)

Detaillierte Beschreibung

Konstruiert eine neue QAxisAccumulator-Instanz mit parent.

Ein Qt3DInput::QAxis meldet die aktuelle Position einer Achse auf einem Eingabegerät. Wenn die Achse in ihre neutrale Position zurückkehrt, kehrt der Wert dieser Achse auf 0 zurück. Oft ist es erforderlich, dass die Eingabe von einer Achse eine Variable auf andere Weise steuert, z. B. indem der Wert von Qt3DInput::QAxis als Geschwindigkeit (erste Ableitung nach der Zeit) oder als Beschleunigung (zweite Ableitung nach der Zeit) behandelt wird. Dies kann mit Benutzercode oder mit Qt3DLogic::QFrameAction geschehen, aber diese Ansätze sind nicht ideal, da sie dem Hauptthread mehr Arbeit hinzufügen und von Natur aus zwingend sind. Mit der Klasse Qt3DInput::QAxisAccumulator kann diese allgemeine Aufgabe im Backend von Qt 3D durchgeführt und deklarativ festgelegt werden.

Dokumentation der Mitgliedstypen

enum QAxisAccumulator::SourceAxisType

KonstanteWert
Qt3DInput::QAxisAccumulator::Velocity0
Qt3DInput::QAxisAccumulator::Acceleration1

Eigenschaft Dokumentation

[read-only] value : const float

Gibt den kumulierten (integrierten) Wert zurück.

Zugriffsfunktionen:

float value() const

Melder-Signal:

void valueChanged(float value)

Member Function Dokumentation

QAxisAccumulator::QAxisAccumulator(Qt3DCore::QNode *parent = nullptr)

Konstruiert eine neue QAxisAccumulator-Instanz mit übergeordnetem parent.

float QAxisAccumulator::scale() const

Der Betrag, um den der Achsenwert beim Akkumulieren skaliert wird. Dies kann man sich als die maximale Geschwindigkeit oder Beschleunigung vorstellen, die die Achse steuern kann.

Gibt den Betrag zurück, um den die eingegebenen Achsenwerte skaliert werden.

Hinweis: Getter-Funktion für die Eigenschaft scale.

Siehe auch setScale().

[slot] void QAxisAccumulator::setSourceAxis(Qt3DInput::QAxis *sourceAxis)

Setzt die Quellachse, von der der Akkumulator Werte erhalten soll, auf sourceAxis. Wie diese Werte behandelt werden, wird durch die Eigenschaften sourceAxisType und scale gesteuert.

Hinweis: Setter-Funktion für die Eigenschaft sourceAxis.

Siehe auch sourceAxis().

[slot] void QAxisAccumulator::setSourceAxisType(Qt3DInput::QAxisAccumulator::SourceAxisType sourceAxisType)

Legt fest, wie der Akkumulator die Werte behandelt, die von sourceAxisType stammen.

Hinweis: Setter-Funktion für die Eigenschaft sourceAxisType.

Siehe auch sourceAxisType().

Qt3DInput::QAxis *QAxisAccumulator::sourceAxis() const

Gibt QAxis zurück, für die der Akkumulator Achsenwerte integrieren soll.

Hinweis: Getter-Funktion für die Eigenschaft sourceAxis.

Siehe auch setSourceAxis().

Qt3DInput::QAxisAccumulator::SourceAxisType QAxisAccumulator::sourceAxisType() const

Gibt zurück, wie der Akkumulator den Wert von sourceAxis behandelt.

Hinweis: Getter-Funktion für die Eigenschaft sourceAxisType.

Siehe auch setSourceAxisType().

float QAxisAccumulator::velocity() const

Gibt die Geschwindigkeit zurück. Wenn sourceAxisType auf Velocity eingestellt ist, ist dies einfach der Wert der Quellachse multipliziert mit der Skala. Wenn sourceAxisType auf Acceleration eingestellt ist, wird die Geschwindigkeit unter Verwendung des Wertes der Quellachse als Beschleunigung integriert.

Hinweis: Getter-Funktion für die Eigenschaft Velocity.

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