pickResult QML Value Type
Contains the results of a pick. More...
| Import Statement: | import QtQuick3D |
Properties
- distance : float
- hitType : enumeration
(since 6.8) - instanceIndex : int
(since 6.5) - itemHit : Item
(since 6.8) - normal : vector3d
- objectHit : Model
- position : vector3d
- sceneNormal : vector3d
- scenePosition : vector3d
- uvPosition : vector2d
Detailed Description
Created as a return object to View3D::pick.
Property Documentation
distance : float |
This property holds the distance between the pick origin and the hit position i.e. the length of the ray. In the case of using viewport coordinates for picking the pick origin will be the active camera's position.
hitType : enumeration |
This property holds the hit type of the pick result.
| Constant | Description |
|---|---|
PickResult.Null | The pick did not hit anything. |
PickResult.Model | The pick hit a Model. |
PickResult.Item | The pick hit a QQuickItem. |
This property was introduced in Qt 6.8.
instanceIndex : int |
This property holds the index in the instance table for the case where the pick hit an instance of an instanced model.
This property was introduced in Qt 6.5.
itemHit : Item |
normal : vector3d |
This property holds the normal of the face that was hit in local coordinate space.
Note: for 2D Items this will always be (0, 0, 1).
objectHit : Model |
position : vector3d |
This property holds the scene position of the hit in local coordinate space.
sceneNormal : vector3d |
This property holds the normal of the face that was hit in scene coordinate space.
scenePosition : vector3d |
This property holds the scene position of the hit.
uvPosition : vector2d |
This property holds the UV position of the hit. The UV position is calculated as the normalized local x and y coordinates of the hit point relative to the bounding volume. Useful for further picking against an offscreen-rendered object.
When hitType is pickResult.Item this value will represent the position of the hit in the coordinate space of itemHit.