En esta página

Qt3DRender::QPickingSettings Class

class Qt3DRender::QPickingSettings

La 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

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

ConstanteValorDescripción
Qt3DRender::QPickingSettings::FrontFace0x01Solo se seleccionarán los triángulos orientados hacia delante (valor por defecto).
Qt3DRender::QPickingSettings::BackFace0x02Solo se seleccionarán los triángulos orientados hacia atrás.
Qt3DRender::QPickingSettings::FrontAndBackFace0x03Se 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.

ConstanteValorDescripción
Qt3DRender::QPickingSettings::BoundingVolumePicking0x00Se considera que una entidad ha sido seleccionada si el rayo de selección intersecta el volumen delimitador de la entidad (por defecto).
Qt3DRender::QPickingSettings::TrianglePicking0x01Se 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::LinePicking0x02Se 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::PointPicking0x04Se 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::PrimitivePickingTrianglePicking | LinePicking | PointPickingSe 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.

ConstanteValorDescripción
Qt3DRender::QPickingSettings::NearestPick0Solo se selecciona la entidad más cercana al origen del rayo de selección con la que este se cruza (por defecto).
Qt3DRender::QPickingSettings::AllPicks1Se seleccionan todas las entidades que se cruzan con el rayo de selección.
Qt3DRender::QPickingSettings::NearestPriorityPick2Selecciona 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.