QObjectPicker Class
(Qt3DRender::QObjectPicker)The QObjectPicker class instantiates a component that can be used to interact with a QEntity by a process known as picking. 更多...
| 头文件: | #include <QObjectPicker> |
| qmake: | QT += 3drender |
| 开始支持版本: | Qt 5.6 |
| Instantiated By: | ObjectPicker |
| 基类: | Qt3DCore::QComponent |
属性
- containsMouse : const bool
- dragEnabled : bool
- hoverEnabled : bool
- pressed : const bool
- 1 个属性继承自 Qt3DCore::QComponent
- 3 个属性继承自 Qt3DCore::QNode
- 1 个属性继承自 QObject
公有函数
| QObjectPicker(QNode *parent = nullptr) | |
| bool | containsMouse() const |
| bool | isDragEnabled() const |
| bool | isHoverEnabled() const |
| bool | isPressed() const |
- 2 个公有函数继承自 Qt3DCore::QComponent
- 11 个公有函数继承自 Qt3DCore::QNode
- 32 个公有函数继承自 QObject
公有槽函数
| void | setDragEnabled(bool dragEnabled) |
| void | setHoverEnabled(bool hoverEnabled) |
- 1 个公有槽函数继承自 Qt3DCore::QComponent
- 3 个公有槽函数继承自 Qt3DCore::QNode
- 1 个公有槽函数继承自 QObject
信号
| void | clicked(Qt3DRender::QPickEvent *pick) |
| void | containsMouseChanged(bool containsMouse) |
| void | dragEnabledChanged(bool dragEnabled) |
| void | entered() |
| void | exited() |
| void | hoverEnabledChanged(bool hoverEnabled) |
| void | moved(Qt3DRender::QPickEvent *pick) |
| void | pressed(Qt3DRender::QPickEvent *pick) |
| void | pressedChanged(bool pressed) |
| void | released(Qt3DRender::QPickEvent *pick) |
- 3 个信号继承自 Qt3DCore::QComponent
- 4 个信号继承自 Qt3DCore::QNode
- 2 个信号继承自 QObject
其他继承的成员
- 1 个公有变量继承自 QObject
- 10 个静态公有成员继承自 QObject
- 2 个受保护的函数继承自 Qt3DCore::QNode
- 9 个受保护的函数继承自 QObject
- 2 个受保护的变量继承自 QObject
详细描述
The QObjectPicker class instantiates a component that can be used to interact with a QEntity by a process known as picking.
For every combination of viewport and camera, picking casts a ray through the scene to find entities who's bounding volume intersects the ray. The bounding volume is computed using the values in the attribute buffer specified by the boundingVolumePositionAttribute of the geometry.
The signals pressed(), released(), clicked(), moved(), entered(), and exited() are emitted when the bounding volume defined by the pickAttribute property intersects with a ray.
Most signals carry a QPickEvent instance. If QPickingSettings::pickMode() is set to QPickingSettings::TrianglePicking, the actual type of the pick parameter will be QPickTriangleEvent.
Pick queries are performed on mouse press and mouse release. If drag is enabled, queries also happen on each mouse move while any button is pressed. If hover is enabled, queries happen on every mouse move even if no button is pressed.
Note: Instances of this component shouldn't be shared, not respecting that condition will most likely result in undefined behavior.
参见 Qt3DRender::QPickingSettings, Qt3DRender::QGeometry, Qt3DRender::QAttribute, Qt3DRender::QPickEvent, and Qt3DRender::QPickTriangleEvent.
属性
containsMouse : const bool
Specifies if the object picker currently contains the mouse
访问函数:
| bool | containsMouse() const |
Notifier signal:
| void | containsMouseChanged(bool containsMouse) |
dragEnabled : bool
Specifies if drag is enabled
访问函数:
| bool | isDragEnabled() const |
| void | setDragEnabled(bool dragEnabled) |
Notifier signal:
| void | dragEnabledChanged(bool dragEnabled) |
hoverEnabled : bool
Specifies if hover is enabled
访问函数:
| bool | isHoverEnabled() const |
| void | setHoverEnabled(bool hoverEnabled) |
Notifier signal:
| void | hoverEnabledChanged(bool hoverEnabled) |
pressed : const bool
Specifies if the object picker is currently pressed
访问函数:
| bool | isPressed() const |
Notifier signal:
| void | pressedChanged(bool pressed) |
成员函数
QObjectPicker::QObjectPicker(QNode *parent = nullptr)
Default constructs an instance of QObjectPicker.
[signal] void QObjectPicker::clicked(Qt3DRender::QPickEvent *pick)
This signal is emitted when the bounding volume defined by the pickAttribute property intersects with a ray on a mouse click the QPickEvent pick contains details of the event.
bool QObjectPicker::containsMouse() const
Returns true if the object picker currently contains the mouse
Note: Getter function for property containsMouse.
[signal] void QObjectPicker::entered()
This signal is emitted when the bounding volume defined by the pickAttribute property intersects with a ray on the mouse entering the volume.
[signal] void QObjectPicker::exited()
This signal is emitted when the bounding volume defined by the pickAttribute property intersects with a ray on the ray exiting the volume.
bool QObjectPicker::isDragEnabled() const
Returns true if dragging is enabled
Note: Getter function for property dragEnabled.
bool QObjectPicker::isHoverEnabled() const
Returns true if hover enabled
Note: Getter function for property hoverEnabled.
[signal] void QObjectPicker::moved(Qt3DRender::QPickEvent *pick)
This signal is emitted when the bounding volume defined by the pickAttribute property intersects with a ray on a mouse move with a button pressed the QPickEvent pick contains details of the event.
[signal] void QObjectPicker::pressed(Qt3DRender::QPickEvent *pick)
This signal is emitted when the bounding volume defined by the pickAttribute property intersects with a ray on a mouse press the QPickEvent pick contains details of the event.
[signal] void QObjectPicker::released(Qt3DRender::QPickEvent *pick)
This signal is emitted when the bounding volume defined by the pickAttribute property intersects with a ray on a mouse release the QPickEvent pick contains details of the event.
[slot] void QObjectPicker::setDragEnabled(bool dragEnabled)
Sets the dragEnabled Property to dragEnabled
Note: Setter function for property dragEnabled.
参见 isDragEnabled().
[slot] void QObjectPicker::setHoverEnabled(bool hoverEnabled)
Sets the hoverEnabled Property to hoverEnabled
Note: Setter function for property hoverEnabled.
参见 isHoverEnabled().