QPickingSettings Class

(Qt3DRender::QPickingSettings)

The QPickingSettings class specifies how entity picking is handled. More...

Header:	#include <QPickingSettings>
qmake:	QT += 3drender
Since:	Qt 5.7
Instantiated By:	PickingSettings
Inherits:	Qt3DCore::QNode

• List of all members, including inherited members
• Obsolete members

Public Types

enum	FaceOrientationPickingMode { FrontFace, BackFace, FrontAndBackFace }
enum	PickMethod { BoundingVolumePicking, TrianglePicking, LinePicking, PointPicking, PrimitivePicking }
enum	PickResultMode { NearestPick, AllPicks }

Properties

• faceOrientationPickingMode : FaceOrientationPickingMode
• pickMethod : PickMethod
• pickResultMode : PickResultMode
• worldSpaceTolerance : float

• 3 properties inherited from Qt3DCore::QNode
• 1 property inherited from QObject

Public Functions

	QPickingSettings(Qt3DCore::QNode *parent = nullptr)
Qt3DRender::QPickingSettings::FaceOrientationPickingMode	faceOrientationPickingMode() const
Qt3DRender::QPickingSettings::PickMethod	pickMethod() const
Qt3DRender::QPickingSettings::PickResultMode	pickResultMode() const
float	worldSpaceTolerance() const

• 13 public functions inherited from Qt3DCore::QNode
• 31 public functions inherited from QObject

Public Slots

void	setFaceOrientationPickingMode(Qt3DRender::QPickingSettings::FaceOrientationPickingMode faceOrientationPickingMode)
void	setPickMethod(Qt3DRender::QPickingSettings::PickMethod pickMethod)
void	setPickResultMode(Qt3DRender::QPickingSettings::PickResultMode pickResultMode)
void	setWorldSpaceTolerance(float worldSpaceTolerance)

• 3 public slots inherited from Qt3DCore::QNode
• 1 public slot inherited from QObject

Signals

void	faceOrientationPickingModeChanged(QPickingSettings::FaceOrientationPickingMode faceOrientationPickingMode)
void	pickMethodChanged(QPickingSettings::PickMethod pickMethod)
void	pickResultModeChanged(QPickingSettings::PickResultMode pickResult)
void	worldSpaceToleranceChanged(float worldSpaceTolerance)

• 4 signals inherited from Qt3DCore::QNode
• 2 signals inherited from QObject

Static Public Members

const QMetaObject

staticMetaObject

• 9 static public members inherited from QObject

Additional Inherited Members

• 2 protected functions inherited from Qt3DCore::QNode
• 9 protected functions inherited from QObject

Detailed Description

The QPickingSettings class specifies how entity picking is handled.

The picking settings determine how the entity picking is handled. For more details about entity picking, see QObjectPicker and QRayCaster component documentation.

When using QObjectPicker components, picking is triggered by mouse events.

When using QRayCaster or QScreenRayCaster components, picking can be explicitly triggered by the application.

In both cases, a ray will be cast through the scene to find geometry intersecting the ray.

See also QObjectPicker, QPickEvent, QPickTriangleEvent, QRayCaster, and QScreenRayCaster.

Member Type Documentation

enum QPickingSettings::FaceOrientationPickingMode

Specifies how face orientation affects triangle picking

Constant	Value	Description
Qt3DRender::QPickingSettings::FrontFace	0x01	Only front-facing triangles will be picked (default).
Qt3DRender::QPickingSettings::BackFace	0x02	Only back-facing triangles will be picked.
Qt3DRender::QPickingSettings::FrontAndBackFace	0x03	Both front- and back-facing triangles will be picked.

enum QPickingSettings::PickMethod

Specifies the picking method.

Constant	Value	Description
Qt3DRender::QPickingSettings::BoundingVolumePicking	0x00	An entity is considered picked if the picking ray intersects the bounding volume of the entity (default).
Qt3DRender::QPickingSettings::TrianglePicking	0x01	An entity is considered picked if the picking ray intersects with any triangle of the entity's mesh component.
Qt3DRender::QPickingSettings::LinePicking	0x02	An entity is considered picked if the picking ray intersects with any edge of the entity's mesh component.
Qt3DRender::QPickingSettings::PointPicking	0x04	An entity is considered picked if the picking ray intersects with any point of the entity's mesh component.
Qt3DRender::QPickingSettings::PrimitivePicking	TrianglePicking | LinePicking | PointPicking	An entity is considered picked if the picking ray intersects with any point, edge or triangle of the entity's mesh component.

enum QPickingSettings::PickResultMode

Specifies what is included into the picking results.

Constant	Value	Description
Qt3DRender::QPickingSettings::NearestPick	0	Only the nearest entity to picking ray origin intersected by the picking ray is picked (default).
Qt3DRender::QPickingSettings::AllPicks	1	All entities that intersect the picking ray are picked.

See also Qt3DRender::QPickEvent.

Member Function Documentation

QPickingSettings::QPickingSettings(Qt3DCore::QNode *parent = nullptr)

Default constructs an instance of QPickingSettings.

[slot] void QPickingSettings::setWorldSpaceTolerance(float worldSpaceTolerance)

Sets the threshold used for line and point picking to worldSpaceTolerance.

Note: Setter function for property worldSpaceTolerance.

See also worldSpaceTolerance().

float QPickingSettings::worldSpaceTolerance() const

Returns the line and point precision worldSpaceTolerance

Note: Getter function for property worldSpaceTolerance.

See also setWorldSpaceTolerance().