En esta página

Qt3DRender::QRayCasterHit Class

class Qt3DRender::QRayCasterHit

Detalles de una coincidencia al proyectar un rayo a través de un modelo. Más información...

Encabezado: #include <qraycasterhit.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
Estado: Obsoleta

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Tipos públicos

enum HitType { TriangleHit, LineHit, PointHit, EntityHit }

Propiedades

Funciones públicas

float distance() const
Qt3DCore::QEntity *entity() const
Qt3DCore::QNodeId entityId() const
QVector3D localIntersection() const
uint primitiveIndex() const
Qt3DRender::QRayCasterHit::HitType type() const
uint vertex1Index() const
uint vertex2Index() const
uint vertex3Index() const
QVector3D worldIntersection() const

Descripción detallada

Qt3DRender::QRayCasterHit contiene los detalles de un impacto correcto al lanzar un rayo a través de un modelo utilizando un componente Qt3DRender::QRayCaster o Qt3DRender::QScreenRayCaster.

Véase también Qt3DRender::QRayCaster, Qt3DRender::QScreenRayCaster y Qt3DRender::QPickingSettings.

Documentación sobre tipos de miembros

enum QRayCasterHit::HitType

Especifica el tipo de resultado devuelto. Esto se controla mediante QPickingSettings.

ConstanteValorDescripción
Qt3DRender::QRayCasterHit::TriangleHit0La figura seleccionada era un triángulo y los índices de los vértices hacen referencia a los tres puntos que lo componen
Qt3DRender::QRayCasterHit::LineHit1La primitiva seleccionada era un segmento de recta, y los dos primeros vértices se refieren a los dos puntos que forman la recta
Qt3DRender::QRayCasterHit::PointHit2La primitiva seleccionada era un punto único; los tres índices de vértices quedarán sin definir
Qt3DRender::QRayCasterHit::EntityHit3Solo se ha tenido en cuenta el volumen delimitador; los índices de la primitiva y de los vértices quedarán sin definir

Documentación de propiedades

[read-only] distance : const float

Esta propiedad contiene la distancia entre el origen del rayo y el punto de intersección.

Almacena la distancia desde el origen del rayo hasta el punto en el que el rayo se cruzó con la entidad.

Funciones de acceso:

float distance() const

[read-only] entity : Qt3DCore::QEntity* const

Esta propiedad contiene un puntero a la entidad que fue alcanzada.

Contiene un puntero a la QEntity que ha sido alcanzada por el rayo.

Funciones de acceso:

Qt3DCore::QEntity *entity() const

[read-only] entityId : const Qt3DCore::QNodeId

Esta propiedad contiene el identificador de la entidad que ha sido alcanzada.

Contiene el identificador del nodo de la entidad que ha sido alcanzada por el rayo.

Funciones de acceso:

Qt3DCore::QNodeId entityId() const

[read-only] localIntersection : const QVector3D

Esta propiedad contiene las coordenadas del punto de intersección en el sistema de coordenadas de la entidad.

Contiene las coordenadas del punto de intersección en el sistema de coordenadas local de la entidad.

Funciones de acceso:

QVector3D localIntersection() const

[read-only] primitiveIndex : const uint

Esta propiedad contiene el índice de la figura seleccionada.

Contiene el índice de la primitiva (triángulo, línea o punto) que se ha seleccionado.

Funciones de acceso:

uint primitiveIndex() const

[read-only] type : const QRayCasterHit::HitType

Esta propiedad contiene el tipo del resultado.

Contiene el tipo de la visita, que puede ser « TriangleHit », « LineHit », « PointHit » o « EntityHit ».

Funciones de acceso:

Qt3DRender::QRayCasterHit::HitType type() const

[read-only] vertex1Index : const uint

Esta propiedad contiene el índice del primer vértice de la primitiva seleccionada.

Contiene el índice del primer vértice de la primitiva seleccionada. En el caso de un triángulo, se trata de uno de los tres vértices. En el caso de una línea, se trata de uno de los dos vértices.

Funciones de acceso:

uint vertex1Index() const

[read-only] vertex2Index : const uint

Esta propiedad contiene el índice del segundo vértice de la primitiva seleccionada.

Contiene el índice del segundo vértice de la primitiva seleccionada. En el caso de un triángulo, se trata de uno de los tres vértices. En el caso de una línea, se trata de uno de los dos vértices.

Funciones de acceso:

uint vertex2Index() const

[read-only] vertex3Index : const uint

Esta propiedad contiene el índice del tercer vértice de la primitiva seleccionada.

Contiene el índice del tercer vértice de la primitiva seleccionada. Esto solo es válido para coincidencias con triángulos.

Funciones de acceso:

uint vertex3Index() const

[read-only] worldIntersection : const QVector3D

Esta propiedad contiene las coordenadas del punto de intersección en el sistema de coordenadas del modelo.

Contiene las coordenadas del punto de intersección en el sistema de coordenadas global.

Funciones de acceso:

QVector3D worldIntersection() const

Documentación de las funciones miembro

float QRayCasterHit::distance() const

Devuelve la distancia entre el origen del rayo y el punto de intersección

Nota: Funcióngetter para la propiedad «distance».

Qt3DCore::QEntity *QRayCasterHit::entity() const

Devuelve un puntero a la entidad que ha sido alcanzada

Nota: Funcióngetter para la propiedad «entity».

Qt3DCore::QNodeId QRayCasterHit::entityId() const

Devuelve el identificador de la entidad a la que se ha accedido

Nota: Funcióngetter para la propiedad entityId.

QVector3D QRayCasterHit::localIntersection() const

Devuelve las coordenadas del punto de intersección en el sistema de coordenadas de la entidad

Nota: Funcióngetter para la propiedad localIntersection.

uint QRayCasterHit::primitiveIndex() const

Devuelve el índice de la primitiva seleccionada

Nota: Funcióngetter para la propiedad primitiveIndex.

Qt3DRender::QRayCasterHit::HitType QRayCasterHit::type() const

Devuelve el tipo del resultado

Nota: Funcióngetter para la propiedad «type».

uint QRayCasterHit::vertex1Index() const

Devuelve el índice del primer vértice de la primitiva seleccionada

Nota: Funcióngetter para la propiedad vertex1Index.

uint QRayCasterHit::vertex2Index() const

Devuelve el índice del segundo vértice de la primitiva seleccionada

Nota: Funciónde lectura para la propiedad vertex2Index.

uint QRayCasterHit::vertex3Index() const

Devuelve el índice del tercer vértice de la primitiva seleccionada

Nota: Funcióngetter para la propiedad vertex3Index.

QVector3D QRayCasterHit::worldIntersection() const

Devuelve las coordenadas del punto de intersección en el sistema de coordenadas del modelo

Nota: Funcióngetter para la propiedad worldIntersection.

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