pickResult QML Value Type
Contiene los resultados de una selección. Más...
| Import Statement: | import QtQuick3D |
Propiedades
- 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
Descripción detallada
Creado como objeto de respuesta a View3D::pick.
Documentación de propiedades
distance : real [read-only]
Esta propiedad almacena la distancia entre el origen de selección y la posición de impacto, es decir, la longitud del rayo. En caso de utilizar coordenadas de la ventana de visualización para la selección, el origen de selección será la posición de la cámara activa.
hitType : enumeration [read-only, since 6.8]
Esta propiedad contiene el tipo de acierto del resultado de la selección.
| Constante | Descripción |
|---|---|
PickResult.Null | La selección no ha dado en ningún objetivo. |
PickResult.Model | La selección ha dado en un modelo. |
PickResult.Item | La selección ha dado en un « QQuickItem ». |
Esta propiedad se introdujo en Qt 6.8.
instanceIndex : int [read-only, since 6.5]
Esta propiedad contiene el índice de la tabla de instancias en el caso de que la selección haya dado en una instancia de un modelo instanciado.
Esta propiedad se introdujo en Qt 6.5.
itemHit : Item [read-only, since 6.8]
Esta propiedad contiene el elemento « Qt Quick » seleccionado. Este valor será nulo si « hitType » no es « pickResult.Item ».
Esta propiedad se introdujo en Qt 6.8.
Véase también ` objectHit`.
normal : vector3d [read-only]
Esta propiedad contiene la normal de la cara que ha sido impactada en el espacio de coordenadas locales.
Nota: Se trata de la normal geométrica de la cara, que, en el caso de una cara impactada por su cara posterior, apunta en dirección opuesta al rayo. Las caras posteriores solo se seleccionan cuando la función « cull mode » del material no las descarta.
Nota: en el caso de los elementos 2D, este valor siempre será (0, 0, 1).
objectHit : Model [read-only]
Esta propiedad contiene el objeto del modelo seleccionado por la selección. Este valor será nulo si hitType no es pickResult.Model.
Véase también itemHit.
position : vector3d [read-only]
Esta propiedad contiene la posición del impacto en la escena en el espacio de coordenadas local.
sceneNormal : vector3d [read-only]
Esta propiedad contiene la normal de la cara que ha recibido el impacto en el espacio de coordenadas de la escena.
scenePosition : vector3d [read-only]
Esta propiedad contiene la posición de la escena en la que se produjo el impacto.
uvPosition : vector2d [read-only]
Esta propiedad contiene la posición UV del impacto. La posición UV se calcula como las coordenadas x e y locales normalizadas del punto de impacto en relación con el volumen delimitador. Resulta útil para realizar selecciones posteriores sobre un objeto renderizado fuera de pantalla.
Cuando ` hitType ` es ` pickResult.Item `, este valor representará la posición del impacto en el espacio de coordenadas 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.