En esta página

Qt3DRender::QAbstractRayCaster Class

class Qt3DRender::QAbstractRayCaster

Una 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:

Qt3DRender::QRayCaster y Qt3DRender::QScreenRayCaster

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.

ConstanteValorDescripción
Qt3DRender::QAbstractRayCaster::AcceptAnyMatchingLayers0Acepta 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::AcceptAllMatchingLayers1Acepta las entidades que hagan referencia a todos los objetos ` QLayer ` añadidos a este QAbstractRayCaster
Qt3DRender::QAbstractRayCaster::DiscardAnyMatchingLayers2Descartar entidades que hagan referencia a uno o más objetos QLayer añadidos a este QAbstractRayCaster
Qt3DRender::QAbstractRayCaster::DiscardAllMatchingLayers3Descartar 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

ConstanteValorDescripción
Qt3DRender::QAbstractRayCaster::Continuous0El ray casting se realiza en cada fotograma siempre que el componente esté habilitado.
Qt3DRender::QAbstractRayCaster::SingleShot1El 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.