Qt3DRender::QAbstractRayCaster Class
class Qt3DRender::QAbstractRayCasterUna clase base abstracta para el trazado de rayos en escenas 3D. Más...
| Encabezado: | #include <qabstractraycaster.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| En QML: | AbstractRayCaster |
| Heredado de: | Qt3DCore::QComponent |
| Heredado por: | |
| Estado: | Obsoleto |
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
Tipos públicos
| enum | FilterMode { AcceptAnyMatchingLayers, AcceptAllMatchingLayers, DiscardAnyMatchingLayers, DiscardAllMatchingLayers } |
| enum | RunMode { Continuous, SingleShot } |
Propiedades
- filterMode : Qt3DRender::QAbstractRayCaster::FilterMode
- hits : Qt3DRender::QAbstractRayCaster::Hits
- runMode : Qt3DRender::QAbstractRayCaster::RunMode
Funciones públicas
| void | addLayer(Qt3DRender::QLayer *layer) |
| Qt3DRender::QAbstractRayCaster::FilterMode | filterMode() const |
| Qt3DRender::QAbstractRayCaster::Hits | hits() const |
| QList<Qt3DRender::QLayer *> | layers() const |
| void | removeLayer(Qt3DRender::QLayer *layer) |
| Qt3DRender::QAbstractRayCaster::RunMode | runMode() const |
Ranuras públicas
| void | setFilterMode(Qt3DRender::QAbstractRayCaster::FilterMode filterMode) |
| void | setRunMode(Qt3DRender::QAbstractRayCaster::RunMode runMode) |
Señales
| void | filterModeChanged(Qt3DRender::QAbstractRayCaster::FilterMode filterMode) |
| void | hitsChanged(const Qt3DRender::QAbstractRayCaster::Hits &hits) |
| void | runModeChanged(Qt3DRender::QAbstractRayCaster::RunMode runMode) |
Descripción detallada
Qt3DRender::QAbstractRayCaster es una clase base abstracta para lanzar rayos en una escena 3D. Qt3DRender::QAbstractRayCaster no se puede instanciar directamente, sino a través de sus subclases. QAbstractRayCaster especifica propiedades comunes para todos los lanzadores de rayos, como el modo de ejecución y la gestión de capas, mientras que deja los detalles concretos del lanzamiento de rayos a las subclases.
El lanzamiento de rayos se diferencia de la selección (mediante Qt3DRender::QObjectPicker) en que no requiere eventos del ratón para activarse.
Por defecto, las instancias de ` Qt3DRender::QAbstractRayCaster ` están desactivadas. Cuando se activan, el rayo especificado se comprueba en cada fotograma para detectar objetos con los que se cruce. La propiedad ` QAbstractRayCaster::hits ` se actualizará con los resultados del lanzamiento de rayos, incluso si no se encuentran objetos.
El ` Qt3DRender::QPickingSettings ` se puede utilizar para controlar el trazado de rayos, por ejemplo, qué primitivas se comprueban y cómo se devuelven los resultados.
Además, los componentes de « Qt3DRender::QLayer » pueden utilizarse para controlar cómo reaccionan las entidades, o los subgrafos de entidades, al lanzamiento de rayos.
Nota: Los componentes derivados de `QAbstractRayCaster` no deben compartirse entre varias entidades.
Véase también Qt3DRender::QRayCaster, Qt3DRender::QScreenRayCaster, Qt3DRender::QObjectPicker, Qt3DRender::QPickingSettings y Qt3DRender::QNoPicking.
Documentación sobre los tipos de miembro
enum QAbstractRayCaster::FilterMode
Especifica las reglas para seleccionar las entidades que se van a someter a la prueba de raycasting.
| Constante | Valor | Descripción |
|---|---|---|
Qt3DRender::QAbstractRayCaster::AcceptAnyMatchingLayers | 0 | Acepta las entidades que hacen referencia a uno o más objetos ` QLayer ` añadidos a este ` QAbstractRayCaster`. Este es el valor por defecto |
Qt3DRender::QAbstractRayCaster::AcceptAllMatchingLayers | 1 | Acepta las entidades que hagan referencia a todos los objetos ` QLayer ` añadidos a este QAbstractRayCaster |
Qt3DRender::QAbstractRayCaster::DiscardAnyMatchingLayers | 2 | Descartar entidades que hagan referencia a uno o más objetos QLayer añadidos a este QAbstractRayCaster |
Qt3DRender::QAbstractRayCaster::DiscardAllMatchingLayers | 3 | Descartar entidades que hagan referencia a todos los objetos QLayer añadidos a este QAbstractRayCaster |
enum QAbstractRayCaster::RunMode
Esta enumeración especifica la frecuencia con la que se lleva a cabo el trazado de rayos
| Constante | Valor | Descripción |
|---|---|---|
Qt3DRender::QAbstractRayCaster::Continuous | 0 | El ray casting se realiza en cada fotograma siempre que el componente esté habilitado. |
Qt3DRender::QAbstractRayCaster::SingleShot | 1 | El ray casting se realiza una sola vez y, a continuación, el componente se desactiva. Este es el valor predeterminado. |
Documentación de la propiedad
filterMode : Qt3DRender::QAbstractRayCaster::FilterMode
Almacena el modo de filtro que especifica las entidades que se deben seleccionar para las pruebas de ray casting.
El valor por defecto es AcceptMatchingLayers.
Funciones de acceso:
| Qt3DRender::QAbstractRayCaster::FilterMode | filterMode() const |
| void | setFilterMode(Qt3DRender::QAbstractRayCaster::FilterMode filterMode) |
Señal de notificación:
| void | filterModeChanged(Qt3DRender::QAbstractRayCaster::FilterMode filterMode) |
[read-only] hits : Qt3DRender::QAbstractRayCaster::Hits
Almacena los resultados de la última prueba de proyección de rayos como un vector de instancias de Qt3DRender::QRayCasterHit.
Ten en cuenta que, aunque las pruebas sucesivas devuelvan exactamente los mismos resultados (o resultados vacíos), se emitirá una notificación de cambio en cada prueba.
Funciones de acceso:
| Qt3DRender::QAbstractRayCaster::Hits | hits() const |
Señal del notificador:
| void | hitsChanged(const Qt3DRender::QAbstractRayCaster::Hits &hits) |
runMode : Qt3DRender::QAbstractRayCaster::RunMode
Establece el modo de ejecución que controla la frecuencia con la que se realizan las pruebas de lanzamiento de rayos.
Si se establece en « SingleShot » (el valor predeterminado), cuando el componente esté activado, se realizará una única prueba de proyección de rayos y el componente se desactivará automáticamente.
Si se establece en «Continuous», las pruebas de proyección de rayos se realizarán en cada fotograma mientras el componente esté activado.
Funciones de acceso:
| Qt3DRender::QAbstractRayCaster::RunMode | runMode() const |
| void | setRunMode(Qt3DRender::QAbstractRayCaster::RunMode runMode) |
Señal de notificación:
| void | runModeChanged(Qt3DRender::QAbstractRayCaster::RunMode runMode) |
Documentación de funciones de miembro
void QAbstractRayCaster::addLayer(Qt3DRender::QLayer *layer)
Añadir « layer » a la lista actual de capas
QList<Qt3DRender::QLayer *> QAbstractRayCaster::layers() const
Devuelve la lista actual de capas
void QAbstractRayCaster::removeLayer(Qt3DRender::QLayer *layer)
Eliminar « layer » de la lista actual de capas
© 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.