Back to Qt.io
Contact Us Blog Download Qt
Auf dieser Seite

Qt3DInput::QAxisAccumulator Class

class Qt3DInput::QAxisAccumulator

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

Überschrift: #include <qaxisaccumulator.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dinput)
target_link_libraries(mytarget PRIVATE Qt6::3dinput)
qmake: QT += 3dinput
In QML: AxisAccumulator
Erbt von: Qt3DCore::QComponent
Status: Veraltet

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Ö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)

Ausführliche Beschreibung

Erstellt eine neue QAxisAccumulator-Instanz mit dem Parameter „ parent “.

Ein „ Qt3DInput::QAxis “ meldet die aktuelle Position einer Achse auf einem Eingabegerät. Wenn die Achse in ihre Neutralposition zurückkehrt, kehrt der Wert dieser Achse auf 0 zurück. Häufig ist es erforderlich, dass die Eingabe einer Achse eine Variable auf andere Weise steuert, beispielsweise indem der Wert des „ 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 einem „ Qt3DLogic::QFrameAction “ erfolgen, doch diese Ansätze sind nicht ideal, da sie den Hauptthread zusätzlich belasten und von Natur aus imperativ sind. Die Klasse „ Qt3DInput::QAxisAccumulator “ ermöglicht es, diese häufige Aufgabe auf dem „ Qt 3D “-Backend auszuführen und auf deklarative Weise zu spezifizieren.

Dokumentation zu Mitgliedstypen

enum QAxisAccumulator::SourceAxisType

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

Dokumentation der Eigenschaft

scale : float

Enthält den Wert, um den der Achsenwert bei der Akkumulation skaliert wird. Dies kann als die maximale Geschwindigkeit oder Beschleunigung betrachtet werden, die die Achse steuern kann.

Zugriffsfunktionen:

float scale() const
void setScale(float scale)

Benachrichtigungssignal:

void scaleChanged(float scale)

sourceAxis : Qt3DInput::QAxis*

Enthält die QAxis, für die der Akkumulator die Achsenwerte integrieren soll.

Zugriffsfunktionen:

Qt3DInput::QAxis *sourceAxis() const
void setSourceAxis(Qt3DInput::QAxis *sourceAxis)

Benachrichtigungssignal:

void sourceAxisChanged(Qt3DInput::QAxis *sourceAxis)

sourceAxisType : SourceAxisType

Enthält den Typ, der festlegt, wie der Akkumulator die Werte der Quellachse verarbeitet.

Zugriffsfunktionen:

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

Benachrichtigungssignal:

void sourceAxisTypeChanged(Qt3DInput::QAxisAccumulator::SourceAxisType sourceAxisType)

[read-only] value : float

Gibt den kumulierten (integrierten) Wert zurück.

Zugriffsfunktionen:

float value() const

Benachrichtigungssignal:

void valueChanged(float value)

[read-only] velocity : float

Behält die Geschwindigkeit bei.

Wenn die „ sourceAxisType “ auf „Velocity“ eingestellt ist, entspricht dies einfach dem Wert der Quellachse multipliziert mit dem Skalierungsfaktor. Wenn die „ sourceAxisType “ auf „Acceleration“ eingestellt ist, wird die Geschwindigkeit unter Verwendung des Werts der Quellachse als Beschleunigung integriert.

Zugriffsfunktionen:

float velocity() const

Benachrichtigungssignal:

void velocityChanged(float value)

Dokumentation der Member-Funktionen

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

Erstellt eine neue Instanz von „QAxisAccumulator“ mit dem übergeordneten „ parent “.

float QAxisAccumulator::scale() const

Der Faktor, um den die Achsenwerte beim Akkumulieren skaliert werden sollen. Dies kann als die maximale Geschwindigkeit oder Beschleunigung betrachtet werden, die die Achse steuern kann.

Gibt den Skalierungsfaktor zurück, mit dem die Eingangswerte der Achse skaliert werden.

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

Siehe auch „ setScale()“.

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

Legt die Quellachse fest, von der der Akkumulator Werte erhalten soll: 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 aus der Eigenschaft „ sourceAxisType “ stammen.

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

Siehe auch „ sourceAxisType()“.

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

Gibt die QAxis zurück, für die der Akkumulator die 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 die „ sourceAxisType “ auf „Velocity“ gesetzt ist, entspricht dies einfach dem Wert der Quellachse multipliziert mit dem Skalierungsfaktor. Wenn die „ sourceAxisType “ auf „Acceleration“ gesetzt ist, wird die Geschwindigkeit unter Verwendung des Werts der Quellachse als Beschleunigung integriert.

Hinweis: Getter -Funktion für die Eigenschaft „velocity“.

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