PickingSettings QML Type

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

Import Statement:	import Qt3D.Render
Since:	Qt 5.7
Instantiates:	QPickingSettings

• List of all members, including inherited members

Properties

• faceOrientationPickingMode : enumeration
• pickMethod : enumeration
• pickResultMode : enumeration
• worldSpaceTolerance : qreal

Detailed Description

The picking settings determine how the entity picking is handled. For more details about entity picking, see Qt3D.Render::ObjectPicker or Qt3D.Render::RayCaster component documentation.

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

When using RayCaster or ScreenRayCaster 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 ObjectPicker, RayCaster, and ScreenRayCaster.

Property Documentation

faceOrientationPickingMode : enumeration

Specifies how face orientation affects triangle picking

• PickingSettings.FrontFace Only front-facing triangles will be picked (default).
• PickingSettings.BackFace Only back-facing triangles will be picked.
• PickingSettings.FrontAndBackFace Both front- and back-facing triangles will be picked.

pickMethod : enumeration

Holds the current pick method.

• PickingSettings.BoundingVolumePicking
• PickingSettings.TrianglePicking
• PickingSettings.LinePicking
• PickingSettings.PointPicking
• PickingSettings.PrimitivePicking: picks either points, lines or triangles

See also Qt3DRender::QPickingSettings::PickMethod.

pickResultMode : enumeration

Holds the current pick results mode.

• PickingSettings.NearestPick
• PickingSettings.AllPicks
• PickingSettings.NearestPriorityPick

See also Qt3DRender::QPickingSettings::PickResultMode.

worldSpaceTolerance : qreal

Holds the threshold, in model space coordinates, used to evaluate line and point picking.