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
- filterMode : enumeration
- hits : array
- runMode : enumeration
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 ».
| Constante | Descripción |
|---|---|
AcceptAnyMatchingLayers | Acepta entidades que hagan referencia a uno o más objetos « Layer » añadidos a este « AbstractRayCaster ». Este es el valor por defecto |
AcceptAllMatchingLayers | Acepta entidades que hagan referencia a todos los objetos « Layer » añadidos a este AbstractRayCaster |
DiscardAnyMatchingLayers | Descarta las entidades que hagan referencia a uno o más objetos « Layer » añadidos a este AbstractRayCaster |
DiscardAllMatchingLayers | Descartar 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.
| Constante | Descripción |
|---|---|
Continuous | El ray casting se realiza en cada fotograma siempre que el componente esté activado. |
SingleShot | El 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.