Класс QObjectPicker

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

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

Свойства

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

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

Сигналы

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

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

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

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

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

Для обобщённых запросов ray casting см. 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.