Sur cette page

Qt3DRender::QRayCasterHit Class

class Qt3DRender::QRayCasterHit

Détails d'une réussite lors de la projection d'un rayon à travers un modèle. Plus d'informations...

En-tête : #include <QRayCasterHit>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake : QT += 3drender
Statut : Déclassé

Types publics

enum HitType { TriangleHit, LineHit, PointHit, EntityHit }

Propriétés

Fonctions publiques

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

Description détaillée

Qt3DRender::QRayCasterHit contient les détails d'une touche réussie lors de la projection d'un rayon à travers un modèle à l'aide d'un composant Qt3DRender::QRayCaster ou Qt3DRender::QScreenRayCaster.

Voir également Qt3DRender::QRayCaster, Qt3DRender::QScreenRayCaster, et Qt3DRender::QPickingSettings.

Documentation sur les types de membres

enum QRayCasterHit::HitType

Spécifie le type de réponse positive renvoyée. Ce paramètre est contrôlé à l'aide de QPickingSettings.

ConstanteValeurDescription
Qt3DRender::QRayCasterHit::TriangleHit0La primitive choisie était un triangle et les indices des sommets font référence aux trois points constituant le triangle.
Qt3DRender::QRayCasterHit::LineHit1La primitive choisie est un segment de ligne, et les deux premiers sommets font référence aux deux points constituant la ligne.
Qt3DRender::QRayCasterHit::PointHit2La primitive choisie était un point unique ; les trois indices de sommet seront indéfinis.
Qt3DRender::QRayCasterHit::EntityHit3Seul le volume délimité a été pris en compte ; les indices de la primitive et des sommets seront indéfinis.

Documentation sur les propriétés

[read-only] distance : const float

Cette propriété indique la distance entre l'origine du rayon et le point d'intersection.

Détient la distance entre l'origine du rayon et le point d'intersection du rayon avec l'entité.

Fonctions d'accès :

float distance() const

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

Cette propriété contient un pointeur sur l'entité qui a été touchée.

Contient un pointeur sur la QEntity qui a été touchée par le rayon.

Fonctions d'accès :

Qt3DCore::QEntity *entity() const

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

Cette propriété contient l'identifiant de l'entité qui a été touchée.

Contient l'identifiant du nœud de l'entité qui a été touchée par le rayon.

Fonctions d'accès :

Qt3DCore::QNodeId entityId() const

[read-only] localIntersection : const QVector3D

Cette propriété contient les coordonnées du point d'intersection dans le système de coordonnées de l'entité.

Détient les coordonnées du point d'intersection dans le système de coordonnées local de l'entité.

Fonctions d'accès :

QVector3D localIntersection() const

[read-only] primitiveIndex : const uint

Cette propriété contient l'index de la primitive choisie.

Contient l'index de la primitive (triangle, ligne ou point) qui a été sélectionnée.

Fonctions d'accès :

uint primitiveIndex() const

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

Cette propriété contient le type de résultat.

Contient le type de résultat, qui peut être TriangleHit, LineHit, PointHit, ou EntityHit.

Fonctions d'accès :

Qt3DRender::QRayCasterHit::HitType type() const

[read-only] vertex1Index : const uint

Cette propriété contient l'index du premier sommet de la primitive choisie.

Détient l'index du premier sommet de la primitive sélectionnée. Pour un triangle, il s'agit de l'un des trois sommets. Dans le cas d'une ligne, il s'agit de l'un des deux sommets.

Fonctions d'accès :

uint vertex1Index() const

[read-only] vertex2Index : const uint

Cette propriété contient l'index du deuxième sommet de la primitive choisie.

Détient l'index du deuxième sommet de la primitive sélectionnée. Pour un triangle, il s'agit de l'un des trois sommets. Dans le cas d'une ligne, il s'agit de l'un des deux sommets.

Fonctions d'accès :

uint vertex2Index() const

[read-only] vertex3Index : const uint

Cette propriété contient l'index du troisième sommet de la primitive choisie.

Détient l'index du troisième sommet de la primitive choisie. Cette propriété n'est valable que pour les frappes de triangles.

Fonctions d'accès :

uint vertex3Index() const

[read-only] worldIntersection : const QVector3D

Cette propriété contient les coordonnées du point d'intersection dans le système de coordonnées du modèle.

Cette propriété contient les coordonnées du point d'intersection dans le système de coordonnées du monde.

Fonctions d'accès :

QVector3D worldIntersection() const

Fonction membre Documentation

float QRayCasterHit::distance() const

Renvoie la distance entre l'origine du rayon et le point d'intersection

Remarque : fonction Getter pour la propriété distance.

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

Renvoie un pointeur sur l'entité qui a été touchée

Note : Fonction Getter pour l'entité property.

Qt3DCore::QNodeId QRayCasterHit::entityId() const

Renvoie l'identifiant de l'entité qui a été touchée

Remarque : fonction Getter pour la propriété entityId.

QVector3D QRayCasterHit::localIntersection() const

Renvoie les coordonnées du point d'intersection dans le système de coordonnées de l'entité.

Note : Fonction Getter pour la propriété localIntersection.

uint QRayCasterHit::primitiveIndex() const

Renvoie l'index de la primitive sélectionnée

Note : Fonction Getter pour la propriété primitiveIndex.

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

Renvoie le type du résultat

Note : Fonction d'obtention pour le type de propriété.

uint QRayCasterHit::vertex1Index() const

Renvoie l'index du premier sommet de la primitive sélectionnée

Note : Fonction Getter pour la propriété vertex1Index.

uint QRayCasterHit::vertex2Index() const

Renvoie l'index du deuxième sommet de la primitive sélectionnée

Note : Fonction Getter pour la propriété vertex2Index.

uint QRayCasterHit::vertex3Index() const

Renvoie l'index du troisième sommet de la primitive sélectionnée

Note : Fonction Getter pour la propriété vertex3Index.

QVector3D QRayCasterHit::worldIntersection() const

Renvoie les coordonnées du point d'intersection dans le système de coordonnées du modèle.

Note : Fonction Getter pour la propriété 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.