- Qt 6.4
- Qt 3D
- QML Types
- Qt3D.Render
- PickingSettings
- Qt 6.4.3 Reference Documentation

# PickingSettings QML Type

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

Import Statement: | import Qt3D.Render 2.4
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.