Qt3DInput::QAxisAccumulator Class
class Qt3DInput::QAxisAccumulatorQAxisAccumulator procesa los datos de velocidad o aceleración de un QAxis. Más...
| Cabecera: | #include <QAxisAccumulator> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3dinput)target_link_libraries(mytarget PRIVATE Qt6::3dinput) |
| qmake: | QT += 3dinput |
| En QML: | AxisAccumulator |
| Hereda: | Qt3DCore::QComponent |
| Status: | Obsoleto |
Tipos públicos
| enum | SourceAxisType { Velocity, Acceleration } |
Propiedades
|
Funciones públicas
| QAxisAccumulator(Qt3DCore::QNode *parent = nullptr) | |
| float | scale() const |
| Qt3DInput::QAxis * | sourceAxis() const |
| Qt3DInput::QAxisAccumulator::SourceAxisType | sourceAxisType() const |
| float | value() const |
| float | velocity() const |
Ranuras públicas
| void | setScale(float scale) |
| void | setSourceAxis(Qt3DInput::QAxis *sourceAxis) |
| void | setSourceAxisType(Qt3DInput::QAxisAccumulator::SourceAxisType sourceAxisType) |
Señales
| void | scaleChanged(float scale) |
| void | sourceAxisChanged(Qt3DInput::QAxis *sourceAxis) |
| void | sourceAxisTypeChanged(Qt3DInput::QAxisAccumulator::SourceAxisType sourceAxisType) |
| void | valueChanged(float value) |
| void | velocityChanged(float value) |
Descripción detallada
Construye una nueva instancia de QAxisAccumulator con parent.
Un Qt3DInput::QAxis informa de la posición actual de un eje en un dispositivo de entrada. Cuando el eje vuelve a su posición neutra, el valor de ese eje vuelve a 0. A menudo, se requiere que la entrada de un eje controle una variable de otras maneras, por ejemplo tratando el valor de Qt3DInput::QAxis como una velocidad (primera derivada con respecto al tiempo) o como una aceleración (segunda derivada con respecto al tiempo). Esto se puede hacer con código de usuario o con un Qt3DLogic::QFrameAction pero estos enfoques no son ideales ya que añaden más trabajo al hilo principal y son inherentemente imperativos. La clase Qt3DInput::QAxisAccumulator permite realizar esta tarea común en el backend Qt 3D y especificarla de forma declarativa.
Documentación de tipos de miembros
enum QAxisAccumulator::SourceAxisType
| Constante | Valor |
|---|---|
Qt3DInput::QAxisAccumulator::Velocity | 0 |
Qt3DInput::QAxisAccumulator::Acceleration | 1 |
Documentación de propiedades
scale : float
Contiene la cantidad a escalar el valor del eje cuando se acumula. Puede considerarse como la velocidad o aceleración máxima que puede controlar el eje.
Funciones de acceso:
| float | scale() const |
| void | setScale(float scale) |
Señal notificadora:
| void | scaleChanged(float scale) |
sourceAxis : Qt3DInput::QAxis*
Contiene la dirección QAxis para la que el acumulador debe integrar los valores de los ejes.
Funciones de acceso:
| Qt3DInput::QAxis * | sourceAxis() const |
| void | setSourceAxis(Qt3DInput::QAxis *sourceAxis) |
Señal del notificador:
| void | sourceAxisChanged(Qt3DInput::QAxis *sourceAxis) |
sourceAxisType : SourceAxisType
Contiene el tipo que especifica cómo trata el acumulador los valores del eje de origen.
Funciones de acceso:
| Qt3DInput::QAxisAccumulator::SourceAxisType | sourceAxisType() const |
| void | setSourceAxisType(Qt3DInput::QAxisAccumulator::SourceAxisType sourceAxisType) |
Señal del notificador:
| void | sourceAxisTypeChanged(Qt3DInput::QAxisAccumulator::SourceAxisType sourceAxisType) |
[read-only] value : float
Devuelve el valor acumulado (integrado).
Funciones de acceso:
| float | value() const |
Señal del notificador:
| void | valueChanged(float value) |
[read-only] velocity : float
Contiene la velocidad.
Si sourceAxisType está configurado como Velocidad, es simplemente el valor del eje de origen multiplicado por la escala. Si sourceAxisType está configurado como Aceleración, la velocidad se integra utilizando el valor del eje de origen como aceleración.
Funciones de acceso:
| float | velocity() const |
Señal del notificador:
| void | velocityChanged(float value) |
Documentación de funciones miembro
QAxisAccumulator::QAxisAccumulator(Qt3DCore::QNode *parent = nullptr)
Construye una nueva instancia de QAxisAccumulator con el padre parent.
float QAxisAccumulator::scale() const
La cantidad a escalar el valor del eje cuando se acumula. Puede considerarse como la velocidad o aceleración máxima que puede controlar el eje.
Devuelve la cantidad por la que se escalan los valores del eje de entrada.
Nota: Función Getter para la propiedad scale.
Véase también setScale().
[slot] void QAxisAccumulator::setSourceAxis(Qt3DInput::QAxis *sourceAxis)
Establece el eje fuente del que el acumulador debe recibir valores en sourceAxis. El tratamiento de estos valores se controla mediante las propiedades sourceAxisType y scale.
Nota: Función setter para la propiedad sourceAxis.
Véase también sourceAxis().
[slot] void QAxisAccumulator::setSourceAxisType(Qt3DInput::QAxisAccumulator::SourceAxisType sourceAxisType)
Establece cómo trata el acumulador los valores procedentes de sourceAxisType.
Nota: Función Setter para la propiedad sourceAxisType.
Véase también sourceAxisType().
Qt3DInput::QAxis *QAxisAccumulator::sourceAxis() const
Devuelve QAxis para el cual el acumulador debe integrar los valores de los ejes.
Nota: Función Getter para la propiedad sourceAxis.
Véase también setSourceAxis().
Qt3DInput::QAxisAccumulator::SourceAxisType QAxisAccumulator::sourceAxisType() const
Devuelve cómo trata el acumulador el valor de sourceAxis.
Nota: Función Getter para la propiedad sourceAxisType.
Véase también setSourceAxisType().
float QAxisAccumulator::velocity() const
Devuelve la velocidad. Si sourceAxisType está configurado como Velocity, es simplemente el valor del eje de origen multiplicado por la escala. Si sourceAxisType está configurado como Acceleration, la velocidad se integra utilizando el valor del eje de origen como aceleración.
Nota: Función Getter para la propiedad 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.
