Qt3DRender::QPickingSettings Class
class Qt3DRender::QPickingSettingsLa clase QPickingSettings especifica cómo se gestiona la selección de entidades. Más información...
| Encabezado: | #include <qpickingsettings.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| En QML: | PickingSettings |
| Heredado de: | Qt3DCore::QNode |
| Estado: | Obsoleto |
Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.
Tipos públicos
| enum | FaceOrientationPickingMode { FrontFace, BackFace, FrontAndBackFace } |
| enum | PickMethod { BoundingVolumePicking, TrianglePicking, LinePicking, PointPicking, PrimitivePicking } |
| enum | PickResultMode { NearestPick, AllPicks, NearestPriorityPick } |
Propiedades
- faceOrientationPickingMode : FaceOrientationPickingMode
- pickMethod : PickMethod
- pickResultMode : PickResultMode
- worldSpaceTolerance : float
Funciones públicas
| Qt3DRender::QPickingSettings::FaceOrientationPickingMode | faceOrientationPickingMode() const |
| Qt3DRender::QPickingSettings::PickMethod | pickMethod() const |
| Qt3DRender::QPickingSettings::PickResultMode | pickResultMode() const |
| float | worldSpaceTolerance() const |
Ranuras públicas
| void | setFaceOrientationPickingMode(Qt3DRender::QPickingSettings::FaceOrientationPickingMode faceOrientationPickingMode) |
| void | setPickMethod(Qt3DRender::QPickingSettings::PickMethod pickMethod) |
| void | setPickResultMode(Qt3DRender::QPickingSettings::PickResultMode pickResultMode) |
| void | setWorldSpaceTolerance(float worldSpaceTolerance) |
Señales
| void | faceOrientationPickingModeChanged(Qt3DRender::QPickingSettings::FaceOrientationPickingMode faceOrientationPickingMode) |
| void | pickMethodChanged(Qt3DRender::QPickingSettings::PickMethod pickMethod) |
| void | pickResultModeChanged(Qt3DRender::QPickingSettings::PickResultMode pickResult) |
| void | worldSpaceToleranceChanged(float worldSpaceTolerance) |
Descripción detallada
Los ajustes de selección determinan cómo se gestiona la selección de entidades. Para obtener más detalles sobre la selección de entidades, consulta la documentación de los componentes QObjectPicker y QRayCaster.
Al utilizar los componentes QObjectPicker, la selección se activa mediante eventos del ratón.
Al utilizar los componentes QRayCaster o QScreenRayCaster, la selección puede activarse explícitamente desde la aplicación.
En ambos casos, se proyectará un rayo a través de la escena para encontrar la geometría que se cruce con dicho rayo.
Véase también QObjectPicker, QPickEvent, QPickTriangleEvent, QRayCaster y QScreenRayCaster.
Documentación sobre tipos de miembros
enum QPickingSettings::FaceOrientationPickingMode
Especifica cómo afecta la orientación de las caras a la selección de triángulos
| Constante | Valor | Descripción |
|---|---|---|
Qt3DRender::QPickingSettings::FrontFace | 0x01 | Solo se seleccionarán los triángulos orientados hacia delante (valor por defecto). |
Qt3DRender::QPickingSettings::BackFace | 0x02 | Solo se seleccionarán los triángulos orientados hacia atrás. |
Qt3DRender::QPickingSettings::FrontAndBackFace | 0x03 | Se seleccionarán tanto los triángulos orientados hacia delante como hacia atrás. |
enum QPickingSettings::PickMethod
Especifica el método de preparación de pedidos.
| Constante | Valor | Descripción |
|---|---|---|
Qt3DRender::QPickingSettings::BoundingVolumePicking | 0x00 | Se considera que una entidad ha sido seleccionada si el rayo de selección intersecta el volumen delimitador de la entidad (por defecto). |
Qt3DRender::QPickingSettings::TrianglePicking | 0x01 | Se considera que una entidad ha sido seleccionada si el rayo de selección se cruza con cualquier triángulo del componente de malla de la entidad. |
Qt3DRender::QPickingSettings::LinePicking | 0x02 | Se considera que una entidad ha sido seleccionada si el rayo de selección se cruza con cualquier arista del componente de malla de la entidad. |
Qt3DRender::QPickingSettings::PointPicking | 0x04 | Se considera que una entidad ha sido seleccionada si el rayo de selección se cruza con cualquier punto del componente de malla de la entidad. |
Qt3DRender::QPickingSettings::PrimitivePicking | TrianglePicking | LinePicking | PointPicking | Se considera que una entidad ha sido seleccionada si el rayo de selección se cruza con cualquier punto, arista o triángulo del componente de malla de la entidad. |
enum QPickingSettings::PickResultMode
Especifica qué se incluye en los resultados de la preparación de pedidos.
| Constante | Valor | Descripción |
|---|---|---|
Qt3DRender::QPickingSettings::NearestPick | 0 | Solo se selecciona la entidad más cercana al origen del rayo de selección con la que este se cruza (por defecto). |
Qt3DRender::QPickingSettings::AllPicks | 1 | Se seleccionan todas las entidades que se cruzan con el rayo de selección. |
Qt3DRender::QPickingSettings::NearestPriorityPick | 2 | Selecciona la entidad cuyo selector de objetos tenga el valor más alto. Si varios selectores de objetos tienen la misma prioridad, se selecciona el más cercano al rayo. |
Véase también Qt3DRender::QPickEvent.
Documentación de propiedades
faceOrientationPickingMode : FaceOrientationPickingMode
Especifica cómo afecta la orientación de las caras a la selección de triángulos
Funciones de acceso:
| Qt3DRender::QPickingSettings::FaceOrientationPickingMode | faceOrientationPickingMode() const |
| void | setFaceOrientationPickingMode(Qt3DRender::QPickingSettings::FaceOrientationPickingMode faceOrientationPickingMode) |
Señal de notificación:
| void | faceOrientationPickingModeChanged(Qt3DRender::QPickingSettings::FaceOrientationPickingMode faceOrientationPickingMode) |
pickMethod : PickMethod
Almacena el método de selección actual.
Por defecto, por motivos de rendimiento, el ray casting utilizará la selección por volumen delimitador. Sin embargo, esto puede dar lugar a resultados inesperados si un objeto pequeño queda englobado en la esfera delimitadora de un objeto grande situado detrás de él.
La selección por triángulos producirá resultados exactos, pero requiere un mayor esfuerzo computacional.
Funciones de acceso:
| Qt3DRender::QPickingSettings::PickMethod | pickMethod() const |
| void | setPickMethod(Qt3DRender::QPickingSettings::PickMethod pickMethod) |
Señal de notificación:
| void | pickMethodChanged(Qt3DRender::QPickingSettings::PickMethod pickMethod) |
pickResultMode : PickResultMode
Mantenía el modo de resultados de selección actual.
Por defecto, solo se generarán resultados de selección para la entidad más cercana a la cámara.
Al configurar el método de selección en « AllPicks », se activarán eventos para todas las entidades con un QObjectPicker a lo largo del rayo.
Al establecer el método de selección en « NearestPriorityPick », se activarán eventos para el selector más cercano con mayor prioridad. Esto puede utilizarse cuando un elemento determinado deba seleccionarse siempre, incluso si hay otros delante de él.
Si se asigna un QObjectPicker a una entidad con varios hijos, se activará un evento para cada entidad hija que se cruce con el rayo.
Funciones de acceso:
| Qt3DRender::QPickingSettings::PickResultMode | pickResultMode() const |
| void | setPickResultMode(Qt3DRender::QPickingSettings::PickResultMode pickResultMode) |
Señal del notificador:
| void | pickResultModeChanged(Qt3DRender::QPickingSettings::PickResultMode pickResult) |
worldSpaceTolerance : float
Almacena el umbral, en coordenadas del espacio del modelo, que se utiliza para evaluar la selección de líneas y puntos.
Funciones de acceso:
| float | worldSpaceTolerance() const |
| void | setWorldSpaceTolerance(float worldSpaceTolerance) |
Señal de notificación:
| void | worldSpaceToleranceChanged(float worldSpaceTolerance) |
Documentación de las funciones de miembro
[slot] void QPickingSettings::setWorldSpaceTolerance(float worldSpaceTolerance)
Establece el umbral utilizado para la selección de líneas y puntos en worldSpaceTolerance.
Nota: Funciónde asignación para la propiedad ` worldSpaceTolerance`.
Véase también ` worldSpaceTolerance()`.
float QPickingSettings::worldSpaceTolerance() const
Devuelve la precisión de líneas y puntos «worldSpaceTolerance»
Nota: Funcióngetter para la propiedad worldSpaceTolerance.
Véase también setWorldSpaceTolerance().
© 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.