Qt3DInput::QAxisAccumulator Class
class Qt3DInput::QAxisAccumulatorQAxisAccumulator procesa datos de velocidad o aceleración procedentes de un QAxis. Más información...
| Encabezado: | #include <qaxisaccumulator.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3dinput) target_link_libraries(mytarget PRIVATE Qt6::3dinput) |
| qmake: | QT += 3dinput |
| En QML: | AxisAccumulator |
| Heredado de: | Qt3DCore::QComponent |
| Estado: | Obsoleto |
Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.
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
Crea una nueva instancia de QAxisAccumulator con un 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 dicho eje vuelve a 0. A menudo, es necesario que la entrada de un eje controle una variable de otras formas, por ejemplo, tratando el valor del « 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 esos enfoques no son ideales, ya que añaden más trabajo al hilo principal y son intrínsecamente imperativos. La clase « Qt3DInput::QAxisAccumulator » permite que esta tarea habitual se realice en el backend « Qt 3D » y se especifique de forma declarativa.
Documentación sobre tipos de miembros
enum QAxisAccumulator::SourceAxisType
| Constante | Valor |
|---|---|
Qt3DInput::QAxisAccumulator::Velocity | 0 |
Qt3DInput::QAxisAccumulator::Acceleration | 1 |
Documentación de la propiedad
scale : float
Almacena el valor por el que se escala el valor del eje al acumular datos. Se puede considerar como la velocidad o aceleración máxima que el eje puede controlar.
Funciones de acceso:
| float | scale() const |
| void | setScale(float scale) |
Señal de notificación:
| void | scaleChanged(float scale) |
sourceAxis : Qt3DInput::QAxis*
Almacena el QAxis para el que el acumulador debe integrar los valores del eje.
Funciones de acceso:
| Qt3DInput::QAxis * | sourceAxis() const |
| void | setSourceAxis(Qt3DInput::QAxis *sourceAxis) |
Señal de notificación:
| 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 de notificación:
| void | sourceAxisTypeChanged(Qt3DInput::QAxisAccumulator::SourceAxisType sourceAxisType) |
[read-only] value : float
Devuelve el valor acumulado (integrado).
Funciones de acceso:
| float | value() const |
Señal de notificación:
| void | valueChanged(float value) |
[read-only] velocity : float
Mantiene la velocidad.
Si la opción « sourceAxisType » está configurada en «Velocity», se trata simplemente del valor del eje de origen multiplicado por la escala. Si la opción « sourceAxisType » está configurada en «Acceleration», la velocidad se integra utilizando el valor del eje de origen como aceleración.
Funciones de acceso:
| float | velocity() const |
Señal de notificación:
| void | velocityChanged(float value) |
Documentación de funciones de miembro
QAxisAccumulator::QAxisAccumulator(Qt3DCore::QNode *parent = nullptr)
Crea una nueva instancia de QAxisAccumulator con el padre parent.
float QAxisAccumulator::scale() const
La cantidad por la que se escala el valor del eje al acumular. Se puede considerar como la velocidad o aceleración máxima que el eje puede controlar.
Devuelve el factor por el que se escalan los valores del eje de entrada.
Nota: Funcióngetter para la propiedad scale.
Véase también setScale().
[slot] void QAxisAccumulator::setSourceAxis(Qt3DInput::QAxis *sourceAxis)
Establece el eje de origen del que el acumulador debe recibir valores en sourceAxis. El tratamiento de estos valores viene determinado por las propiedades « sourceAxisType » y «scale».
Nota: Funciónde asignación 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ónde asignación para la propiedad sourceAxisType.
Véase también sourceAxisType().
Qt3DInput::QAxis *QAxisAccumulator::sourceAxis() const
Devuelve el QAxis sobre el que el acumulador debe integrar los valores del eje.
Nota: Funcióngetter para la propiedad sourceAxis.
Véase también setSourceAxis().
Qt3DInput::QAxisAccumulator::SourceAxisType QAxisAccumulator::sourceAxisType() const
Devuelve cómo trata el acumulador el valor de la propiedad ` sourceAxis`.
Nota: Funcióngetter para la propiedad sourceAxisType.
Véase también setSourceAxisType().
float QAxisAccumulator::velocity() const
Devuelve la velocidad. Si el parámetro « sourceAxisType » está configurado en «Velocity», se trata simplemente del valor del eje de origen multiplicado por la escala. Si el parámetro « sourceAxisType » está configurado en «Acceleration», la velocidad se integra utilizando el valor del eje de origen como aceleración.
Nota: Funcióngetter 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.