pickResult QML Value Type
Contient les résultats d'une sélection. En savoir plus...
| Import Statement: | import QtQuick3D |
Propriétés
- distance : real
- 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
Description détaillée
Objet créé en réponse à View3D::pick.
Documentation des propriétés
distance : real [read-only]
Cette propriété contient la distance entre l'origine de sélection et la position de collision, c'est-à-dire la longueur du rayon. Si l'on utilise les coordonnées de la fenêtre d'affichage pour la sélection, l'origine de sélection correspondra à la position de la caméra active.
hitType : enumeration [read-only, since 6.8]
Cette propriété contient le type de résultat de la sélection.
| Constante | Description |
|---|---|
PickResult.Null | La sélection n'a rien touché. |
PickResult.Model | La sélection a touché un modèle. |
PickResult.Item | La sélection a touché un « QQuickItem ». |
Cette propriété a été introduite dans Qt 6.8.
instanceIndex : int [read-only, since 6.5]
Cette propriété contient l'index dans la table des instances lorsque la sélection porte sur une instance d'un modèle instancié.
Cette propriété a été introduite dans Qt 6.5.
itemHit : Item [read-only, since 6.8]
Cette propriété contient l'élément « Qt Quick » sélectionné par le curseur. Cette valeur sera nulle si hitType n'est pas pickResult.Item.
Cette propriété a été introduite dans Qt 6.8.
Voir aussi ` objectHit`.
normal : vector3d [read-only]
Cette propriété contient la normale de la face qui a été touchée dans l'espace de coordonnées locales.
Remarque : il s'agit de la normale géométrique de la face ; pour une face touchée sur sa face arrière, celle-ci est orientée dans la direction opposée au rayon. Les faces arrière ne sont sélectionnées que si l'cull mode, du matériau ne les exclut pas.
Remarque : pour les éléments 2D, cette valeur sera toujours (0, 0, 1).
objectHit : Model [read-only]
Cette propriété contient l'objet modèle sélectionné par le curseur. Cette valeur sera nulle si hitType n'est pas pickResult.Model.
Voir également itemHit.
position : vector3d [read-only]
Cette propriété contient la position de la collision dans l'espace de coordonnées local de la scène.
sceneNormal : vector3d [read-only]
Cette propriété contient la normale de la face qui a été touchée, dans l'espace de coordonnées de la scène.
scenePosition : vector3d [read-only]
Cette propriété contient la position de la scène au moment de l'impact.
uvPosition : vector2d [read-only]
Cette propriété contient la position UV du point d'impact. La position UV est calculée à partir des coordonnées x et y locales normalisées du point d'impact par rapport au volume englobant. Utile pour effectuer un sélectionnement ultérieur par rapport à un objet rendu hors écran.
Lorsque l’option « hitType » est définie sur « pickResult.Item », cette valeur représente la position du point d’impact dans l’espace de coordonnées de itemHit.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
