Qt3DRender::QRayCasterHit Class
class Qt3DRender::QRayCasterHitDétails d'une collision lors de la projection d'un rayon à travers un modèle. En savoir plus...
| En-tête : | #include <qraycasterhit.h> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake : | QT += 3drender |
| Statut : | Obsolète |
Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
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’un résultat positif obtenu lors du lancer 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ésultat renvoyé. Ce paramètre est contrôlé via QPickingSettings.
| Constante | Valeur | Description |
|---|---|---|
Qt3DRender::QRayCasterHit::TriangleHit | 0 | La primitive sélectionnée était un triangle et les indices des sommets font référence aux trois points qui le composent |
Qt3DRender::QRayCasterHit::LineHit | 1 | La primitive sélectionnée était un segment de droite, et les deux premiers sommets font référence aux deux points qui composent ce segment |
Qt3DRender::QRayCasterHit::PointHit | 2 | La primitive sélectionnée était un point unique ; les trois indices de sommet seront indéfinis |
Qt3DRender::QRayCasterHit::EntityHit | 3 | Seul le volume englobant a été pris en compte ; les indices de primitive et de sommet seront indéfinis |
Documentation des propriétés
[read-only] distance : const float
Cette propriété contient la distance entre l'origine du rayon et le point d'intersection.
Contient la distance entre l'origine du rayon et le point d'intersection avec l'entité.
Fonctions d'accès :
| float | distance() const |
[read-only] entity : Qt3DCore::QEntity* const
Cette propriété contient un pointeur vers l'entité qui a été touchée.
Contient un pointeur vers 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é.
Contient 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 sélectionnée.
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 du résultat.
Contient le type de l'accès, 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 sélectionnée.
Contient l'index du premier sommet de la primitive sélectionnée. Dans le cas d'un triangle touché, il s'agit de l'un des trois sommets. Dans le cas d'une ligne touchée, 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 sélectionnée.
Contient l’indice du deuxième sommet de la primitive sélectionnée. Dans le cas d’un collision avec un triangle, il s’agit de l’un des trois sommets. Dans le cas d’une collision avec 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 sélectionnée.
Contient l'index du troisième sommet de la primitive sélectionnée. Ceci n'est valable que pour les collisions avec des 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.
Contient les coordonnées du point d'intersection dans le système de coordonnées mondial.
Fonctions d'accès :
| QVector3D | worldIntersection() const |
Documentation des fonctions membres
float QRayCasterHit::distance() const
Renvoie la distance entre l'origine du rayon et le point d'intersection
Remarque : fonctiongetter pour la propriété distance.
Qt3DCore::QEntity *QRayCasterHit::entity() const
Renvoie un pointeur vers l'entité qui a été touchée
Remarque : fonctiongetter pour la propriété entity.
Qt3DCore::QNodeId QRayCasterHit::entityId() const
Renvoie l'identifiant de l'entité qui a été touchée
Remarque : fonctiongetter 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é
Remarque : fonctiongetter pour la propriété localIntersection.
uint QRayCasterHit::primitiveIndex() const
Renvoie l'index de la primitive sélectionnée
Remarque : fonctiongetter pour la propriété `primitiveIndex`.
Qt3DRender::QRayCasterHit::HitType QRayCasterHit::type() const
Renvoie le type du résultat
Remarque : fonctiongetter pour la propriété « type ».
uint QRayCasterHit::vertex1Index() const
Renvoie l'index du premier sommet de la primitive sélectionnée
Remarque : fonctionde lecture pour la propriété vertex1Index.
uint QRayCasterHit::vertex2Index() const
Renvoie l'index du deuxième sommet de la primitive sélectionnée
Remarque : fonctionde lecture pour la propriété vertex2Index.
uint QRayCasterHit::vertex3Index() const
Renvoie l'index du troisième sommet de la primitive sélectionnée
Remarque : fonctionde lecture 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
Remarque : fonctiongetter 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.
