Qt3DRender::QRayCasterHit Class
class Qt3DRender::QRayCasterHitDetails eines Treffers beim Werfen eines Strahls durch ein Modell. Mehr...
| Kopfzeile: | #include <QRayCasterHit> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender)target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| Status: | Veraltet |
Öffentliche Typen
| enum | HitType { TriangleHit, LineHit, PointHit, EntityHit } |
Eigenschaften
|
|
Öffentliche Funktionen
| 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 |
Detaillierte Beschreibung
Qt3DRender::QRayCasterHit enthält die Details eines erfolgreichen Treffers beim Wurf eines Strahls durch ein Modell unter Verwendung einer Qt3DRender::QRayCaster oder Qt3DRender::QScreenRayCaster Komponente.
Siehe auch Qt3DRender::QRayCaster, Qt3DRender::QScreenRayCaster, und Qt3DRender::QPickingSettings.
Dokumentation der Mitgliedstypen
enum QRayCasterHit::HitType
Gibt die Art des Treffers an, der zurückgegeben wurde. Dies wird über QPickingSettings gesteuert.
| Konstante | Wert | Beschreibung |
|---|---|---|
Qt3DRender::QRayCasterHit::TriangleHit | 0 | Das ausgewählte Primitiv war ein Dreieck und die Scheitelpunktindizes beziehen sich auf die drei Punkte, aus denen das Dreieck besteht |
Qt3DRender::QRayCasterHit::LineHit | 1 | Das ausgewählte Primitiv war ein Liniensegment, und die ersten beiden Scheitelpunkte beziehen sich auf die beiden Punkte, aus denen die Linie besteht |
Qt3DRender::QRayCasterHit::PointHit | 2 | Das ausgewählte Primitiv war ein einzelner Punkt; alle 3 Scheitelpunktindizes sind undefiniert. |
Qt3DRender::QRayCasterHit::EntityHit | 3 | Nur das Begrenzungsvolumen wurde berücksichtigt; die Indizes des Primitivs und der Scheitelpunkte sind undefiniert |
Dokumentation der Eigenschaft
[read-only] distance : const float
Diese Eigenschaft enthält den Abstand zwischen dem Ursprung des Strahls und dem Schnittpunkt.
Enthält den Abstand zwischen dem Ursprung des Strahls und dem Punkt, an dem der Strahl das Objekt schneidet.
Zugriffsfunktionen:
| float | distance() const |
[read-only] entity : Qt3DCore::QEntity* const
Diese Eigenschaft enthält einen Zeiger auf das getroffene Objekt.
Enthält einen Zeiger auf das QEntity, das von dem Strahl getroffen wurde.
Zugriffsfunktionen:
| Qt3DCore::QEntity * | entity() const |
[read-only] entityId : const Qt3DCore::QNodeId
Diese Eigenschaft enthält die ID des getroffenen Objekts.
Enthält die Knoten-ID des Objekts, das vom Strahl getroffen wurde.
Zugriffsfunktionen:
| Qt3DCore::QNodeId | entityId() const |
[read-only] localIntersection : const QVector3D
Diese Eigenschaft enthält die Koordinaten des Schnittpunkts im Koordinatensystem der Entität.
Enthält die Koordinaten des Schnittpunkts im lokalen Koordinatensystem der Entität.
Zugriffsfunktionen:
| QVector3D | localIntersection() const |
[read-only] primitiveIndex : const uint
Diese Eigenschaft enthält den Index des ausgewählten Primitivs.
Enthält den Index des Primitivs (Dreieck, Linie oder Punkt), das ausgewählt wurde.
Zugriffsfunktionen:
| uint | primitiveIndex() const |
[read-only] type : const QRayCasterHit::HitType
Diese Eigenschaft enthält den Typ des Treffers.
Enthält den Typ des Treffers, der TriangleHit, LineHit, PointHit oder EntityHit sein kann.
Zugriffsfunktionen:
| Qt3DRender::QRayCasterHit::HitType | type() const |
[read-only] vertex1Index : const uint
Diese Eigenschaft enthält den Index des ersten Scheitelpunkts des ausgewählten Primitivs.
Enthält den Index des ersten Scheitelpunkts des ausgewählten Primitivs. Bei einem Dreieckstreffer ist dies einer der drei Scheitelpunkte. Bei einem Linientreffer ist dies einer der beiden Scheitelpunkte.
Zugriffsfunktionen:
| uint | vertex1Index() const |
[read-only] vertex2Index : const uint
Diese Eigenschaft enthält den Index des zweiten Scheitelpunkts des ausgewählten Primitivs.
Enthält den Index des zweiten Scheitelpunkts des ausgewählten Primitivs. Bei einem Dreieckstreffer ist dies einer der drei Scheitelpunkte. Bei einem Linientreffer ist dies einer der beiden Scheitelpunkte.
Zugriffsfunktionen:
| uint | vertex2Index() const |
[read-only] vertex3Index : const uint
Diese Eigenschaft enthält den Index des dritten Scheitelpunkts des ausgewählten Primitivs.
Hält den Index des dritten Scheitelpunkts des ausgewählten Primitivs. Dies ist nur für Dreieckstreffer gültig.
Zugriffsfunktionen:
| uint | vertex3Index() const |
[read-only] worldIntersection : const QVector3D
Diese Eigenschaft enthält die Koordinaten des Schnittpunkts im Koordinatensystem des Modells.
Enthält die Koordinaten des Schnittpunkts im Weltkoordinatensystem.
Zugriffsfunktionen:
| QVector3D | worldIntersection() const |
Dokumentation der Mitgliedsfunktionen
float QRayCasterHit::distance() const
Liefert den Abstand zwischen dem Ursprung des Strahls und dem Schnittpunkt
Hinweis: Getter-Funktion für die Eigenschaft distance.
Qt3DCore::QEntity *QRayCasterHit::entity() const
Gibt einen Zeiger auf die getroffene Entität zurück
Hinweis: Getter-Funktion für die Eigenschaft entity.
Qt3DCore::QNodeId QRayCasterHit::entityId() const
Gibt die ID der getroffenen Entität zurück
Hinweis: Getter-Funktion für die Eigenschaft entityId.
QVector3D QRayCasterHit::localIntersection() const
Liefert die Koordinaten des Schnittpunkts im Koordinatensystem der Entität
Hinweis: Getter-Funktion für die Eigenschaft localIntersection.
uint QRayCasterHit::primitiveIndex() const
Gibt den Index des ausgewählten Primitivs zurück.
Hinweis: Getter-Funktion für die Eigenschaft primitiveIndex.
Qt3DRender::QRayCasterHit::HitType QRayCasterHit::type() const
Gibt den Typ des Treffers zurück
Hinweis: Getter-Funktion für die Eigenschaft type.
uint QRayCasterHit::vertex1Index() const
Gibt den Index des ersten Scheitelpunkts des ausgewählten Primitivs zurück.
Hinweis: Getter-Funktion für die Eigenschaft vertex1Index.
uint QRayCasterHit::vertex2Index() const
Gibt den Index des zweiten Scheitelpunkts des ausgewählten Primitivs zurück.
Hinweis: Getter-Funktion für die Eigenschaft vertex2Index.
uint QRayCasterHit::vertex3Index() const
Gibt den Index des dritten Scheitelpunkts des ausgewählten Primitivs zurück.
Hinweis: Getter-Funktion für die Eigenschaft vertex3Index.
QVector3D QRayCasterHit::worldIntersection() const
Gibt die Koordinaten des Schnittpunkts im Koordinatensystem des Modells zurück
Hinweis: Getter-Funktion für die Eigenschaft 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.
