Класс QObjectPicker

Класс QObjectPicker создаёт компонент, который может использоваться для взаимодействия с QEntity посредством процесса, известного как выбор. Подробнее...

• Список всех членов, включая унаследованные

Свойства

Открытые функции

Открытые слоты

Сигналы

Подробное описание

Для каждой комбинации области просмотра и камеры выбор выполняет вычисление луча через сцену, чтобы найти сущности, чей ограничивающий объём пересекает луч. Ограничивающий объём вычисляется с использованием значений в буфере атрибутов, указанных атрибутом boundingVolumePositionAttribute геометрии.

Сигналы pressed(), released(), clicked(), moved(), entered() и exited() генерируются при пересечении ограничивающего объёма, определённого свойством pickAttribute, с лучом.

Большинство сигналов передают экземпляр QPickEvent. Если QPickingSettings::pickMode() задано как QPickingSettings::TrianglePicking, фактический тип параметра pick будет QPickTriangleEvent.

Запросы выбора выполняются при нажатии и отпускании кнопки мыши. Если включён режим перетаскивания, запросы также выполняются при каждом движении мыши, пока нажата любая кнопка. Если включён режим наведения, запросы выполняются при каждом движении мыши, даже если ни одна кнопка не нажата.

Для обобщённых запросов вычисления луча см. Qt3DRender::QRayCaster и Qt3DRender::QScreenRayCaster.

Примечание: Экземпляры этого компонента не должны быть объявлены общими, не соблюдение этого условия, скорее всего, приведёт к неопределённому поведению.

Примечание: Значение дальнего плоскости камеры влияет на выбор и даёт некорректные результаты из-за точности с плавающей запятой, если оно больше ~100 000.

См. также Qt3DRender::QPickingSettings, Qt3DCore::QGeometry, Qt3DCore::QAttribute, Qt3DRender::QPickEvent, Qt3DRender::QPickTriangleEvent и Qt3DRender::QNoPicking.

Документация функций-членов

[signal] void QObjectPicker::clicked(Qt3DRender::QPickEvent *pick)

Этот сигнал испускается, когда ограничивающая область, определенная свойством pickAttribute, пересекается с лучом при щелчке мыши. QPickEvent pick содержит детали события.

[signal] void QObjectPicker::entered()

Этот сигнал испускается, когда ограничивающая область, определенная свойством pickAttribute, пересекается с лучом при входе указателя мыши в область.

[signal] void QObjectPicker::exited()

Этот сигнал испускается, когда ограничивающая область, определенная свойством pickAttribute, пересекается с лучом при выходе указателя мыши из области.

[signal] void QObjectPicker::moved(Qt3DRender::QPickEvent *pick)

Этот сигнал испускается, когда ограничивающая область, определенная свойством pickAttribute, пересекается с лучом при перемещении мыши с нажатой кнопкой. QPickEvent pick содержит детали события.

[signal] void QObjectPicker::pressed(Qt3DRender::QPickEvent *pick)

Этот сигнал испускается, когда ограничивающая область, определенная свойством pickAttribute, пересекается с лучом при нажатии кнопки мыши. QPickEvent pick содержит детали события.

[signal] void QObjectPicker::released(Qt3DRender::QPickEvent *pick)

Этот сигнал испускается, когда ограничивающая область, определенная свойством pickAttribute, пересекается с лучом при отпускании кнопки мыши. QPickEvent pick содержит детали события.

[slot] void QObjectPicker::setDragEnabled(bool dragEnabled)

Устанавливает свойство dragEnabled в значение dragEnabled

Примечание: Функция-сеттер для свойства dragEnabled.

См. также isDragEnabled().

[slot] void QObjectPicker::setHoverEnabled(bool hoverEnabled)

Устанавливает свойство hoverEnabled в значение hoverEnabled

Примечание: Функция-сеттер для свойства hoverEnabled.

См. также isHoverEnabled().

[slot, since 5.13] void QObjectPicker::setPriority(int priority)

Устанавливает приоритет пикера в значение priority. Это используется, когда режим результата выбора в QPickingSettings установлен в QPickingSettings::NearestPriorityPick. Результаты выбора сортируются по наивысшему приоритету и наименьшему расстоянию выбора.

Примечание: Функция-сеттер для свойства priority.

Эта функция была добавлена в Qt 5.13.

См. также priority().

bool QObjectPicker::containsMouse() const

Возвращает true, если объект пикер в данный момент содержит указатель мыши

Примечание: Функция-геттер для свойства containsMouse.

bool QObjectPicker::isDragEnabled() const

Возвращает true, если перенос разрешен

Примечание: Функция-геттер для свойства dragEnabled.

bool QObjectPicker::isHoverEnabled() const

Возвращает true, если наведение разрешено

Примечание: Функция-геттер для свойства hoverEnabled.