ObjectPicker QML Type
La clase ObjectPicker instancia un componente que puede ser utilizado para interactuar con una Entidad mediante un proceso conocido como picking. Más...
| Import Statement: | import Qt3D.Render 2.11 |
| In C++: | QObjectPicker |
| Status: | Deprecated |
Propiedades
- containsMouse : bool
- dragEnabled : bool
- hoverEnabled : bool
- pressed : bool
- priority : int
Señales
- clicked(PickEvent pick)
- entered()
- exited()
- moved(PickEvent pick)
- pressed(PickEvent pick)
- released(PickEvent pick)
Descripción detallada
Para cada combinación de vista y cámara, picking lanza un rayo a través de la escena para encontrar entidades cuyo volumen límite intersecte el rayo. El volumen delimitador se calcula utilizando los valores del búfer de atributos especificado por el atributo boundingVolumePositionAttribute de la geometría.
Las señales pressed(), released(), clicked(), moved(), entered() y exited() se emiten cuando el volumen delimitador definido por la propiedad pickAttribute se cruza con un rayo.
La mayoría de las señales llevan una instancia PickEvent. Si PickingSettings.pickMode se establece en PickingSettings.TrianglePicking, el tipo real del parámetro pick será PickTriangleEvent.
Las consultas de selección se realizan al pulsar y soltar el ratón. Si la opción de arrastrar está activada, las consultas también se realizan en cada movimiento del ratón mientras cualquier botón está pulsado. Si está activado el hover, las consultas se realizan en cada movimiento del ratón, incluso si no hay ningún botón pulsado.
Nota: Para recibir eventos hover en QtQuick, la propiedad hoverEnabled de Scene3D también debe estar activada.
Nota: Las instancias de este componente no deben ser compartidas, el no respetar esta condición muy probablemente resultará en un comportamiento indefinido.
Nota: El valor del plano lejano de la cámara afecta al picking y produce resultados incorrectos debido a la precisión en coma flotante si es mayor de ~100 000.
Ver también PickingSettings, Geometry, Attribute, PickEvent, PickTriangleEvent, y NoPicking.
Documentación de propiedades
containsMouse : bool [read-only]
Especifica si el selector de objetos contiene actualmente el ratón
dragEnabled : bool
hoverEnabled : bool
Especifica si el hover está activado
pressed : bool [read-only]
Especifica si el selector de objetos está actualmente pulsado
priority : int
La prioridad que se utilizará al filtrar los resultados de la selección por prioridad cuando PickingSettings.pickResultMode esté establecido en PickingSettings.PriorityPick.
Documentación de señales
clicked(PickEvent pick)
Esta señal se emite cuando el volumen delimitador definido por la propiedad pickAttribute se cruza con un rayo al hacer clic con el ratón. La información sobre la intersección es accesible a través del parámetro pick.
Nota: El manejador correspondiente es onClicked.
entered()
Esta señal se emite cuando el volumen delimitador definido por la propiedad pickAttribute se cruza con un rayo del ratón que entra en el volumen.
Nota: El manejador correspondiente es onEntered.
exited()
Esta señal se emite cuando el volumen delimitador definido por la propiedad pickAttribute se cruza con un rayo en el rayo que sale del volumen.
Nota: El manejador correspondiente es onExited.
moved(PickEvent pick)
Esta señal se emite cuando el volumen delimitador definido por la propiedad pickAttribute se cruza con un rayo en un movimiento del ratón con un botón pulsado. La información sobre la intersección es accesible a través del parámetro pick.
Nota: El manejador correspondiente es onMoved.
pressed(PickEvent pick)
Esta señal se emite cuando el volumen delimitador definido por la propiedad pickAttribute se cruza con un rayo al pulsar el ratón. La información sobre la intersección es accesible a través del parámetro pick.
Nota: El manejador correspondiente es onPressed.
released(PickEvent pick)
Esta señal se emite cuando el volumen delimitador definido por la propiedad pickAttribute se cruza con un rayo al soltar el ratón. La información sobre la intersección es accesible a través del parámetro pick.
Nota: El manejador correspondiente es onReleased.
© 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.
