Qt3DRender.QObjectPicker ¶

概要 ¶

详细描述 ¶

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 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 QRayCaster and 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.

另请参阅

QPickingSettings QGeometry QAttribute QPickEvent QPickTriangleEvent QNoPicking

class PySide2.Qt3DRender.Qt3DRender. QObjectPicker ( [ parent=None ] ) ¶

参数

parent – QNode

PySide2.Qt3DRender.Qt3DRender.QObjectPicker. clicked ( pick ) ¶

参数

pick – QPickEvent

PySide2.Qt3DRender.Qt3DRender.QObjectPicker. containsMouse ( ) ¶

返回类型

bool

Returns true if the object picker currently contains the mouse

PySide2.Qt3DRender.Qt3DRender.QObjectPicker. containsMouseChanged ( containsMouse ) ¶

参数

containsMouse – bool

PySide2.Qt3DRender.Qt3DRender.QObjectPicker. dragEnabledChanged ( dragEnabled ) ¶

参数

dragEnabled – bool

PySide2.Qt3DRender.Qt3DRender.QObjectPicker. entered ( ) ¶

PySide2.Qt3DRender.Qt3DRender.QObjectPicker. exited ( ) ¶

PySide2.Qt3DRender.Qt3DRender.QObjectPicker. hoverEnabledChanged ( hoverEnabled ) ¶

参数

hoverEnabled – bool

PySide2.Qt3DRender.Qt3DRender.QObjectPicker. isDragEnabled ( ) ¶

返回类型

bool

Returns true if dragging is enabled

PySide2.Qt3DRender.Qt3DRender.QObjectPicker. isHoverEnabled ( ) ¶

返回类型

bool

Returns true if hover enabled

PySide2.Qt3DRender.Qt3DRender.QObjectPicker. isPressed ( ) ¶

返回类型

bool

PySide2.Qt3DRender.Qt3DRender.QObjectPicker. moved ( pick ) ¶

参数

pick – QPickEvent

PySide2.Qt3DRender.Qt3DRender.QObjectPicker. pressed ( pick ) ¶

参数

pick – QPickEvent

PySide2.Qt3DRender.Qt3DRender.QObjectPicker. pressedChanged ( pressed ) ¶

参数

pressed – bool

PySide2.Qt3DRender.Qt3DRender.QObjectPicker. priority ( ) ¶

返回类型

int

另请参阅

setPriority()

PySide2.Qt3DRender.Qt3DRender.QObjectPicker. priorityChanged ( priority ) ¶

参数

priority – int

PySide2.Qt3DRender.Qt3DRender.QObjectPicker. released ( pick ) ¶

参数

pick – QPickEvent

PySide2.Qt3DRender.Qt3DRender.QObjectPicker. setDragEnabled ( dragEnabled ) ¶

参数

dragEnabled – bool

设置 dragEnabled Property to dragEnabled

另请参阅

isDragEnabled()

PySide2.Qt3DRender.Qt3DRender.QObjectPicker. setHoverEnabled ( hoverEnabled ) ¶

参数

hoverEnabled – bool

设置 hoverEnabled Property to hoverEnabled

另请参阅

isHoverEnabled()

PySide2.Qt3DRender.Qt3DRender.QObjectPicker. setPriority ( priority ) ¶

参数

priority – int

Sets the picker’s priority to priority . This is used when the pick result mode on QPickingSettings is set to NearestPriorityPick . Picking results are sorted by highest priority and shortest picking distance.

另请参阅

priority()