En esta página

Qt3DInput::QAxisAccumulator Class

class Qt3DInput::QAxisAccumulator

QAxisAccumulator 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

ConstanteValor
Qt3DInput::QAxisAccumulator::Velocity0
Qt3DInput::QAxisAccumulator::Acceleration1

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.