QObjectPicker Class

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
Since: Qt 5.6
实例化: ObjectPicker
继承: Qt3DCore::QComponent

该类在 Qt 5.6 引入。

特性

公共函数

bool containsMouse () const
bool isDragEnabled () const
bool isHoverEnabled () const
bool isPressed () const
int priority () const

公共槽

void setDragEnabled (bool dragEnabled )
void setHoverEnabled (bool hoverEnabled )
void setPriority (int priority )

信号

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 priorityChanged (int priority )
void released (Qt3DRender::QPickEvent * pick )

详细描述

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 (),和 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.

For generalised ray casting queries, see Qt3DRender::QRayCaster and Qt3DRender::QScreenRayCaster .

注意: Instances of this component shouldn't be shared, not respecting that condition will most likely result in undefined behavior.

注意: The camera far plane value affects picking and produces incorrect results due to floating-point precision if it is greater than ~100 000.

另请参阅 Qt3DRender::QPickingSettings , Qt3DRender::QGeometry , Qt3DRender::QAttribute , Qt3DRender::QPickEvent , Qt3DRender::QPickTriangleEvent ,和 Qt3DRender::QNoPicking .

特性文档编制

containsMouse : const bool

Specifies if the object picker currently contains the mouse

访问函数:

bool containsMouse () const

通知程序信号:

void containsMouseChanged (bool containsMouse )

dragEnabled : bool

Specifies if drag is enabled

访问函数:

bool isDragEnabled () const
void setDragEnabled (bool dragEnabled )

通知程序信号:

void dragEnabledChanged (bool dragEnabled )

hoverEnabled : bool

Specifies if hover is enabled

访问函数:

bool isHoverEnabled () const
void setHoverEnabled (bool hoverEnabled )

通知程序信号:

void hoverEnabledChanged (bool hoverEnabled )

pressed : const bool

Specifies if the object picker is currently pressed

访问函数:

bool isPressed () const

通知程序信号:

void pressedChanged (bool pressed )

priority : int

The priority to be used when filtering pick results by priority when QPickingSettings::pickResultMode 被设为 QPickingSettings::NearestPriorityPick .

访问函数:

int priority () const
void setPriority (int priority )

通知程序信号:

void priorityChanged (int priority )

成员函数文档编制

[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.

[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.

[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 )

设置 dragEnabled Property to dragEnabled

注意: setter 函数对于特性 dragEnabled .

另请参阅 isDragEnabled ().

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

设置 hoverEnabled Property to hoverEnabled

注意: setter 函数对于特性 hoverEnabled .

另请参阅 isHoverEnabled ().

[slot] void QObjectPicker:: setPriority ( int priority )

Sets the picker's priority to priority . This is used when the pick result mode on QPickingSettings 被设为 QPickingSettings::NearestPriorityPick . Picking results are sorted by highest priority and shortest picking distance.

注意: setter 函数对于特性 priority .

该函数在 Qt 5.13 引入。

另请参阅 priority ().

bool QObjectPicker:: containsMouse () const

Returns true if the object picker currently contains the mouse

注意: Getter function for property containsMouse.

bool QObjectPicker:: isDragEnabled () const

Returns true if dragging is enabled

注意: getter 函数对于特性 dragEnabled .

bool QObjectPicker:: isHoverEnabled () const

Returns true if hover enabled

注意: getter 函数对于特性 hoverEnabled .