QObjectPicker#

The QObjectPicker class instantiates a component that can be used to interact with a QEntity by a process known as picking. More…

Synopsis#

Properties#

containsMouse
dragEnabled
hoverEnabled
pressed
priority

Functions#

def containsMouse ()
def isDragEnabled ()
def isHoverEnabled ()
def isPressed ()
def priority ()

Slots#

def setDragEnabled (dragEnabled)
def setHoverEnabled (hoverEnabled)
def setPriority (priority)

Signals#

def clicked (pick)
def containsMouseChanged (containsMouse)
def dragEnabledChanged (dragEnabled)
def entered ()
def exited ()
def hoverEnabledChanged (hoverEnabled)
def moved (pick)
def pressed (pick)
def pressedChanged (pressed)
def priorityChanged (priority)
def released (pick)

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description#

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

Note

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

Note

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

See also

QPickingSettings QGeometry QAttribute QPickEvent QPickTriangleEvent QNoPicking

class PySide6.Qt3DRender.Qt3DRender.QObjectPicker([parent=None])#

Parameters:: parent – PySide6.Qt3DCore.Qt3DCore.QNode

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property PᅟySide6.Qt3DRender.Qt3DRender.QObjectPicker.containsMouse: bool#

Specifies if the object picker currently contains the mouse

Access functions:

containsMouse ()
Signal containsMouseChanged (containsMouse)

property PᅟySide6.Qt3DRender.Qt3DRender.QObjectPicker.dragEnabled: bool#

Specifies if drag is enabled

Access functions:

isDragEnabled ()
setDragEnabled (dragEnabled)
Signal dragEnabledChanged (dragEnabled)

property PᅟySide6.Qt3DRender.Qt3DRender.QObjectPicker.hoverEnabled: bool#

Specifies if hover is enabled

Access functions:

isHoverEnabled ()
setHoverEnabled (hoverEnabled)
Signal hoverEnabledChanged (hoverEnabled)

property PᅟySide6.Qt3DRender.Qt3DRender.QObjectPicker.pressed: bool#

Specifies if the object picker is currently pressed

Access functions:

isPressed ()
Signal pressedChanged (pressed)

property PᅟySide6.Qt3DRender.Qt3DRender.QObjectPicker.priority: int#

The priority to be used when filtering pick results by priority when pickResultMode is set to NearestPriorityPick .

Access functions:

priority ()
setPriority (priority)
Signal priorityChanged (priority)

PySide6.Qt3DRender.Qt3DRender.QObjectPicker.clicked(pick)#

Parameters:: pick – PySide6.Qt3DRender.Qt3DRender.QPickEvent

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.

PySide6.Qt3DRender.Qt3DRender.QObjectPicker.containsMouse()#

Return type:: bool

Returns true if the object picker currently contains the mouse

Getter of property containsMouse .

PySide6.Qt3DRender.Qt3DRender.QObjectPicker.containsMouseChanged(containsMouse)#

Parameters:: containsMouse – bool

Notification signal of property containsMouse .

PySide6.Qt3DRender.Qt3DRender.QObjectPicker.dragEnabledChanged(dragEnabled)#

Parameters:: dragEnabled – bool

Notification signal of property dragEnabled .

PySide6.Qt3DRender.Qt3DRender.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.

PySide6.Qt3DRender.Qt3DRender.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.

PySide6.Qt3DRender.Qt3DRender.QObjectPicker.hoverEnabledChanged(hoverEnabled)#

Parameters:: hoverEnabled – bool

Notification signal of property hoverEnabled .

PySide6.Qt3DRender.Qt3DRender.QObjectPicker.isDragEnabled()#

Return type:: bool

Returns true if dragging is enabled

Getter of property dragEnabled .

PySide6.Qt3DRender.Qt3DRender.QObjectPicker.isHoverEnabled()#

Return type:: bool

Returns true if hover enabled

Getter of property hoverEnabled .

PySide6.Qt3DRender.Qt3DRender.QObjectPicker.isPressed()#

Return type:: bool

Getter of property pressed .

PySide6.Qt3DRender.Qt3DRender.QObjectPicker.moved(pick)#

Parameters:: pick – PySide6.Qt3DRender.Qt3DRender.QPickEvent

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.

PySide6.Qt3DRender.Qt3DRender.QObjectPicker.pressed(pick)#

Parameters:: pick – PySide6.Qt3DRender.Qt3DRender.QPickEvent

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.

PySide6.Qt3DRender.Qt3DRender.QObjectPicker.pressedChanged(pressed)#

Parameters:: pressed – bool

Notification signal of property pressed .

PySide6.Qt3DRender.Qt3DRender.QObjectPicker.priority()#

Return type:: int