Класс QAxisAccumulator
класс Qt3DInput::QAxisAccumulatorКласс QAxisAccumulator обрабатывает данные скорости или ускорения, получаемые от QAxis. Подробнее...
| Заголовок: | #include <QAxisAccumulator> |
| CMake: | find_package(Qt6 COMPONENTS 3dinput REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::3dinput) |
| qmake: | QT += 3dinput |
| С момента: | Qt 5.8 |
| Инициализируется: | AxisAccumulator |
| Наследует: | Qt3DCore::QComponent |
Типы публичного интерфейса
| Перечисление | SourceAxisType { Скорость, Ускорение } |
Свойства
- value : const float
Публичные функции
| QAxisAccumulator(Qt3DCore::QNode *parent = nullptr) | |
| float | scale() const |
| Qt3DInput::QAxis * | sourceAxis() const |
| Qt3DInput::QAxisAccumulator::SourceAxisType | sourceAxisType() const |
| float | value() const |
| float | velocity() const |
Публичные слоты
| void | setScale(float scale) |
| void | setSourceAxis(Qt3DInput::QAxis *sourceAxis) |
| void | setSourceAxisType(QAxisAccumulator::SourceAxisType sourceAxisType) |
Сигналы
| void | scaleChanged(float scale) |
| void | sourceAxisChanged(Qt3DInput::QAxis *sourceAxis) |
| void | sourceAxisTypeChanged(QAxisAccumulator::SourceAxisType sourceAxisType) |
| void | valueChanged(float value) |
| void | velocityChanged(float value) |
Подробное описание
Создаёт новый экземпляр QAxisAccumulator с parent.
Qt3DInput::QAxis сообщает о текущем положении оси на устройстве ввода. Когда ось возвращается в нейтральное положение, значение этой оси возвращается к 0. Часто требуется, чтобы входной сигнал от оси управлял переменной другими способами, например, рассматривая значение от Qt3DInput::QAxis как скорость (первая производная относительно времени) или как ускорение (вторая производная относительно времени). Это можно сделать с помощью пользовательского кода или с помощью Qt3DLogic::QFrameAction, но эти подходы не идеальны, так как они добавляют больше работы в основной поток и по своей сути императивны. Класс Qt3DInput::QAxisAccumulator позволяет выполнять эту распространённую задачу на бэкенде Qt 3D и задавать её декларативным способом.
Документация по типам членов
Перечисление QAxisAccumulator::SourceAxisType
| Константа | Значение |
|---|---|
Qt3DInput::QAxisAccumulator::Velocity |
0 |
Qt3DInput::QAxisAccumulator::Acceleration |
1 |
Документация по свойствам
[read-only] value : const float
Возвращает накопленное (интегрированное) значение.
Функции доступа:
| float | value() const |
Сигнал уведомления:
| void | valueChanged(float value) |
Документация по функциям-членам
QAxisAccumulator::QAxisAccumulator(Qt3DCore::QNode *parent = nullptr)
Создаёт новый экземпляр QAxisAccumulator с родителем parent.
[slot] void QAxisAccumulator::setSourceAxis(Qt3DInput::QAxis *sourceAxis)
Устанавливает источник оси, от которого накопитель должен получать значения, на sourceAxis. Способ обработки этих значений регулируется свойствами sourceAxisType и scale.
Примечание: Функция-сеттер для свойства sourceAxis.
См. также sourceAxis().
[slot] void QAxisAccumulator::setSourceAxisType(QAxisAccumulator::SourceAxisType sourceAxisType)
Устанавливает способ, которым накопитель обрабатывает значения, поступающие от sourceAxisType.
Примечание: Функция-сеттер для свойства sourceAxisType.
См. также sourceAxisType().
float QAxisAccumulator::scale() const
Значение, на которое масштабируются значения оси при накоплении. Можно рассматривать как максимальную скорость или ускорение, которое ось может контролировать.
Возвращает значение, на которое масштабируются значения вводимых осей.
Примечание: Функция-геттер для свойства scale.
См. также setScale().
Qt3DInput::QAxis *QAxisAccumulator::sourceAxis() const
Возвращает QAxis, для которой накопитель должен интегрировать значения осей.
Примечание: Функция-геттер для свойства sourceAxis.
См. также setSourceAxis().
Qt3DInput::QAxisAccumulator::SourceAxisType QAxisAccumulator::sourceAxisType() const
Возвращает способ, которым накопитель обрабатывает значение sourceAxis.
Примечание: Функция-геттер для свойства sourceAxisType.
См. также setSourceAxisType().
float QAxisAccumulator::velocity() const
Возвращает скорость. Если sourceAxisType установлено в Скорость, это просто значение оси источника, умноженное на scale. Если sourceAxisType установлено в Ускорение, скорость интегрируется с использованием значения оси источника в качестве ускорения.
Примечание: Функция-геттер для свойства velocity.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.1/qt3dinput-qaxisaccumulator.html