Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

Qt3DInput::QAxisAccumulator Class

class Qt3DInput::QAxisAccumulator

QAxisAccumulator traite les données de vitesse ou d'accélération provenant d'un capteur de mouvement ( QAxis). En savoir plus...

En-tête : #include <qaxisaccumulator.h>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3dinput)
target_link_libraries(mytarget PRIVATE Qt6::3dinput)
qmake : QT += 3dinput
En QML : AxisAccumulator
Hérite de : Qt3DCore::QComponent
Statut : Obsolète

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Types publics

enum SourceAxisType { Velocity, Acceleration }

Propriétés

Fonctions publiques

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

Emplacements publics

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

Signaux

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

Description détaillée

Crée une nouvelle instance de QAxisAccumulator avec l'parent.

Un Qt3DInput::QAxis indique la position actuelle d’un axe sur un périphérique d’entrée. Lorsque l’axe revient à sa position neutre, la valeur de cet axe revient à 0. Il est souvent nécessaire que l’entrée provenant d’un axe contrôle une variable d’autres manières, par exemple en traitant la valeur de l’ Qt3DInput::QAxis comme une vitesse (dérivée première par rapport au temps) ou comme une accélération (dérivée seconde par rapport au temps). Cela peut être réalisé à l’aide d’un code utilisateur ou d’un « Qt3DLogic::QFrameAction », mais ces approches ne sont pas idéales car elles alourdissent la charge de travail du thread principal et sont intrinsèquement impératives. La classe ` Qt3DInput::QAxisAccumulator ` permet d’effectuer cette tâche courante au niveau du backend d’ Qt 3D, tout en la spécifiant de manière déclarative.

Documentation sur les types de membres

enum QAxisAccumulator::SourceAxisType

ConstanteValeur
Qt3DInput::QAxisAccumulator::Velocity0
Qt3DInput::QAxisAccumulator::Acceleration1

Documentation sur les propriétés

scale : float

Stocke la valeur par laquelle la valeur de l'axe doit être mise à l'échelle lors de l'accumulation. On peut considérer cela comme la vitesse ou l'accélération maximale que l'axe peut contrôler.

Fonctions d’accès :

float scale() const
void setScale(float scale)

Signal de notification :

void scaleChanged(float scale)

sourceAxis : Qt3DInput::QAxis*

Contient l'axe QAxis pour lequel l'accumulateur doit intégrer les valeurs de l'axe.

Fonctions d'accès :

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

Signal de notification :

void sourceAxisChanged(Qt3DInput::QAxis *sourceAxis)

sourceAxisType : SourceAxisType

Contient le type qui spécifie la manière dont l'accumulateur traite les valeurs provenant de l'axe source.

Fonctions d'accès :

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

Signal de notification :

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

[read-only] value : float

Renvoie la valeur cumulée (intégrée).

Fonctions d’accès :

float value() const

Signal de notification :

void valueChanged(float value)

[read-only] velocity : float

Contient la vitesse.

Si l’ sourceAxisType est réglée sur « Velocity », il s’agit simplement de la valeur de l’axe source multipliée par l’échelle. Si l’ sourceAxisType est réglée sur « Acceleration », la vitesse est intégrée en utilisant la valeur de l’axe source comme accélération.

Fonctions d'accès :

float velocity() const

Signal de notification :

void velocityChanged(float value)

Documentation des fonctions membres

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

Crée une nouvelle instance de QAxisAccumulator dont le parent est parent.

float QAxisAccumulator::scale() const

Facteur de mise à l'échelle des valeurs de l'axe lors de l'accumulation. On peut considérer ce paramètre comme la vitesse ou l'accélération maximale que l'axe peut contrôler.

Renvoie le facteur de mise à l'échelle appliqué aux valeurs d'entrée de l'axe.

Remarque : fonctiongetter pour la propriété scale.

Voir également setScale().

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

Définit l'axe source à partir duquel l'accumulateur doit recevoir des valeurs sur sourceAxis. Le traitement de ces valeurs est contrôlé par les propriétés « sourceAxisType » et « scale ».

Remarque : fonctionde définition de la propriété ` sourceAxis`.

Voir également ` sourceAxis()`.

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

Définit la manière dont l'accumulateur traite les valeurs provenant de la propriété sourceAxisType.

Remarque : fonctionde définition pour la propriété sourceAxisType.

Voir aussi ` sourceAxisType()`.

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

Renvoie l'axe QAxis sur lequel l'accumulateur doit intégrer les valeurs de l'axe.

Remarque : fonctiongetter pour la propriété sourceAxis.

Voir également setSourceAxis().

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

Renvoie la manière dont l'accumulateur traite la valeur de la propriété ` sourceAxis`.

Remarque : fonctiongetter pour la propriété sourceAxisType.

Voir également setSourceAxisType().

float QAxisAccumulator::velocity() const

Renvoie la vitesse. Si l'sourceAxisType est définie sur « Velocity », il s'agit simplement de la valeur de l'axe source multipliée par l'échelle. Si l'sourceAxisType est définie sur « Acceleration », la vitesse est intégrée en utilisant la valeur de l'axe source comme accélération.

Remarque : fonction de lecture (getter ) pour la propriété « 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.