Qt3DInput::QAxisAccumulator Class
class Qt3DInput::QAxisAccumulatorQAxisAccumulator traite les données de vitesse ou d'accélération provenant d'un QAxis. Plus....
| En-tête : | #include <QAxisAccumulator> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS 3dinput)target_link_libraries(mytarget PRIVATE Qt6::3dinput) |
| qmake : | QT += 3dinput |
| En QML : | AxisAccumulator |
| Hérite : | Qt3DCore::QComponent |
| Statut : | Déclassé |
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
Construit une nouvelle instance de QAxisAccumulator avec parent.
Un site Qt3DInput::QAxis indique la position actuelle d'un axe sur un dispositif d'entrée. Lorsque l'axe est ramené à sa position neutre, la valeur de cet axe revient à 0. Souvent, il est nécessaire que l'entrée d'un axe contrôle une variable d'une autre manière, par exemple en traitant la valeur de 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 fait avec du code utilisateur ou avec Qt3DLogic::QFrameAction, mais ces approches ne sont pas idéales car elles ajoutent plus de travail au thread principal et sont intrinsèquement impératives. La classe Qt3DInput::QAxisAccumulator permet d'effectuer cette tâche commune sur le backend Qt 3D et de la spécifier de manière déclarative.
Documentation sur les types de membres
enum QAxisAccumulator::SourceAxisType
| Constante | Valeur |
|---|---|
Qt3DInput::QAxisAccumulator::Velocity | 0 |
Qt3DInput::QAxisAccumulator::Acceleration | 1 |
Documentation sur les propriétés
scale : float
Contient le montant à mettre à l'échelle de la valeur de l'axe lors de l'accumulation. Il s'agit de la vitesse ou de 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'adresse QAxis pour laquelle l'accumulateur doit intégrer les valeurs des axes.
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 comment l'accumulateur traite les valeurs 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 accumulé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'adresse sourceAxisType est définie sur Velocity, il s'agit simplement de la valeur de l'axe source multipliée par l'échelle. Si sourceAxisType est réglé 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 Notificateur :
| void | velocityChanged(float value) |
Member Function Documentation
QAxisAccumulator::QAxisAccumulator(Qt3DCore::QNode *parent = nullptr)
Construit une nouvelle instance de QAxisAccumulator avec le parent parent.
float QAxisAccumulator::scale() const
Le montant à mettre à l'échelle de la valeur de l'axe lors de l'accumulation. Il s'agit de la vitesse ou de l'accélération maximale que l'axe peut contrôler.
Renvoie la valeur de la mise à l'échelle des valeurs de l'axe d'entrée.
Remarque : fonction Getter pour l'échelle des propriétés.
Voir également setScale().
[slot] void QAxisAccumulator::setSourceAxis(Qt3DInput::QAxis *sourceAxis)
Définit l'axe source à partir duquel l'accumulateur doit recevoir des valeurs à sourceAxis. Le traitement de ces valeurs est contrôlé par les propriétés sourceAxisType et scale.
Remarque : fonction de 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 sourceAxisType.
Remarque : fonction de définition de la propriété sourceAxisType.
Voir aussi sourceAxisType().
Qt3DInput::QAxis *QAxisAccumulator::sourceAxis() const
Renvoie QAxis pour lequel l'accumulateur doit intégrer les valeurs des axes.
Remarque : fonction Getter 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 sourceAxis.
Note : Fonction Getter pour la propriété sourceAxisType.
Voir également setSourceAxisType().
float QAxisAccumulator::velocity() const
Renvoie la vitesse. Si l'adresse sourceAxisType est définie sur Velocity, il s'agit simplement de la valeur de l'axe source multipliée par l'échelle. Si sourceAxisType est défini sur Acceleration, la vitesse est intégrée en utilisant la valeur de l'axe source comme accélération.
Remarque : fonction d'obtention de la propriété "vitesse".
© 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.
