En esta página

Qt3DRender::QRayCasterHit Class

class Qt3DRender::QRayCasterHit

Detalles de un impacto al lanzar un rayo a través de un modelo. Más...

Cabecera: #include <QRayCasterHit>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
Status: Obsoleto

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 acierto al lanzar un rayo a través de un modelo utilizando un componente Qt3DRender::QRayCaster o Qt3DRender::QScreenRayCaster.

Ver también Qt3DRender::QRayCaster, Qt3DRender::QScreenRayCaster, y Qt3DRender::QPickingSettings.

Documentación de tipos de miembros

enum QRayCasterHit::HitType

Especifica el tipo de resultado obtenido. Se controla mediante QPickingSettings.

ConstanteValorDescripción
Qt3DRender::QRayCasterHit::TriangleHit0La primitiva elegida era un triángulo y los índices de los vértices se refieren a los tres puntos que forman el triángulo
Qt3DRender::QRayCasterHit::LineHit1La primitiva elegida era un segmento de línea, y los dos primeros vértices se refieren a los dos puntos que forman la línea
Qt3DRender::QRayCasterHit::PointHit2La primitiva elegida era un único punto; los 3 índices de vértice serán indefinidos
Qt3DRender::QRayCasterHit::EntityHit3Sólo se ha considerado el volumen delimitador; los índices de primitiva y vértice serán indefinidos

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.

Contiene la distancia entre el origen del rayo y el punto de intersección del rayo 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 golpeada.

Contiene un puntero a la QEntidad que fue golpeada por el rayo.

Funciones de acceso:

Qt3DCore::QEntity *entity() const

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

Esta propiedad contiene el id de la entidad que fue golpeada.

Mantiene el id del nodo de la entidad que fue golpeada 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.

Mantiene 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 primitiva elegida.

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

Funciones de acceso:

uint primitiveIndex() const

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

Esta propiedad contiene el tipo de resultado.

Contiene el tipo de resultado, 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 elegida.

Mantiene el índice del primer vértice de la primitiva elegida. En el caso de un triángulo, es uno de los tres vértices. En el caso de una línea, es 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 elegida.

Mantiene el índice del segundo vértice de la primitiva elegida. En el caso de un triángulo, es uno de los tres vértices. En el caso de una línea, es 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 elegida.

Mantiene el índice del tercer vértice de la primitiva elegida. Sólo es válida para los 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.

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

Funciones de acceso:

QVector3D worldIntersection() const

Documentación de funciones miembro

float QRayCasterHit::distance() const

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

Nota: Función Getter para la propiedad distancia.

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

Devuelve un puntero a la entidad que fue golpeada

Nota: Función Getter para la propiedad entidad.

Qt3DCore::QNodeId QRayCasterHit::entityId() const

Devuelve el id de la entidad que fue golpeada

Nota: Función Getter 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ón Getter para la propiedad localIntersection.

uint QRayCasterHit::primitiveIndex() const

Devuelve el índice de la primitiva elegida

Nota: Función Getter para la propiedad primitiveIndex.

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

Devuelve el tipo del golpe

Nota: Función Getter para el tipo de propiedad.

uint QRayCasterHit::vertex1Index() const

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

Nota: Función Getter para la propiedad vertex1Index.

uint QRayCasterHit::vertex2Index() const

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

Nota: Función Getter para la propiedad vertex2Index.

uint QRayCasterHit::vertex3Index() const

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

Nota: Función Getter 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ón Getter 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.