En esta página

AbstractRayCaster QML Type

Una clase base abstracta para el trazado de rayos en escenas 3D. Más información...

Import Statement: import Qt3D.Render 2.12
In C++: QAbstractRayCaster
Status: Deprecated

Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.

Propiedades

Descripción detallada

AbstractRayCaster es una clase base abstracta para lanzar rayos en una escena 3D. AbstractRayCaster 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 en manos de las subclases.

El lanzamiento de rayos se diferencia de la selección (mediante ObjectPicker) en que no requiere eventos del ratón para activarse.

Por defecto, las instancias de `AbstractRayCaster` están desactivadas. Cuando se activan, se comprueba en cada fotograma si el rayo especificado intersecta con algún objeto. La propiedad `AbstractRayCaster.hits` se actualizará con los resultados del lanzamiento de rayos, incluso si no se encuentra ningún objeto.

Se puede utilizar Qt3D.Render::PickingSettings para controlar el lanzamiento de rayos, por ejemplo, qué primitivas se comprueban y cómo se devuelven los resultados.

Además, los componentes Qt3D.Render::Layer pueden utilizarse para controlar cómo reaccionan las entidades, o los subgrafos de entidades, al lanzamiento de rayos.

Nota: los componentes derivados de `AbstractRayCaster` no deben compartirse entre varias entidades.

Véase también Qt3D.Render::RayCaster, Qt3D.Render::ScreenRayCaster, Qt3D.Render::ObjectPicker, Qt3D.Render::PickingSettings y Qt3D.Render::NoPicking.

Documentación de la propiedad

filterMode : enumeration

Almacena el modo de filtro que especifica las entidades que se deben seleccionar para las pruebas de proyección de rayos.

El valor por defecto es « AbstractRayCaster.AcceptMatchingLayers ».

ConstanteDescripción
AcceptAnyMatchingLayersAcepta entidades que hagan referencia a uno o más objetos « Layer » añadidos a este « AbstractRayCaster ». Este es el valor por defecto
AcceptAllMatchingLayersAcepta entidades que hagan referencia a todos los objetos « Layer » añadidos a este AbstractRayCaster
DiscardAnyMatchingLayersDescarta las entidades que hagan referencia a uno o más objetos « Layer » añadidos a este AbstractRayCaster
DiscardAllMatchingLayersDescartar entidades que hagan referencia a todos los objetos Layer añadidos a este AbstractRayCaster

hits : array [read-only]

Almacena los resultados de la última prueba de trazado de rayos como una matriz de objetos JavaScript. A continuación se describen los campos definidos en dichos objetos.

{
    type // enum value of RayCasterHit.HitType
    entity // entity that was intersected
    distance // distance from ray origin to intersection
    localIntersection.x: // coordinate of intersection in the entity's coordinate system
    localIntersection.y
    localIntersection.z
    worldIntersection.x // coordinate of intersection in the model's coordinate system
    worldIntersection.y
    worldIntersection.z
    primitiveIndex // index of the primitive (triangle, line, point) that was intersected;
                   // (undefined if the picking mode is set to bounding volume)
    vertex1Index // index of the first point of the triangle or line that was intersected
                 // (undefined if the picking mode is set to bounding volume or points)
    vertex2Index // index of the second point of the triangle or line that was intersected
                 // (undefined if the picking mode is set to bounding volume or points)
    vertex3Index // index of the second point of the triangle that was intersected
                 // (undefined if the picking mode is set to bounding volume, points or lines)
}

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.

runMode : enumeration

Establece el modo de ejecución que controla la frecuencia con la que se realizan las pruebas de proyección de rayos.

ConstanteDescripción
ContinuousEl ray casting se realiza en cada fotograma siempre que el componente esté activado.
SingleShotEl ray casting se realiza una sola vez y, a continuación, el componente se desactiva automáticamente. Este es el valor predeterminado.

© 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.