Qt3DRender::QRayCasterHit Class
class Qt3DRender::QRayCasterHitDetails zu einem Treffer beim Abfeuern eines Strahls durch ein Modell. Mehr...
| Überschrift: | #include <qraycasterhit.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| Status: | Veraltet |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Ö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 |
Ausführliche Beschreibung
Qt3DRender::QRayCasterHit Enthält die Details eines erfolgreichen Treffers, wenn ein Strahl mithilfe einer „ Qt3DRender::QRayCaster “- oder „ Qt3DRender::QScreenRayCaster “-Komponente durch ein Modell geworfen wird.
Siehe auch „ Qt3DRender::QRayCaster “, „ Qt3DRender::QScreenRayCaster “ und „ Qt3DRender::QPickingSettings “.
Dokumentation zu Mitgliedstypen
enum QRayCasterHit::HitType
Gibt die Art des zurückgegebenen Treffers an. 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 | Die ausgewählte Primitive war ein Liniensegment, und die ersten beiden Eckpunkte beziehen sich auf die beiden Punkte, aus denen die Linie besteht |
Qt3DRender::QRayCasterHit::PointHit | 2 | Die ausgewählte Primitive war ein einzelner Punkt; alle drei Eckpunktindizes sind undefiniert |
Qt3DRender::QRayCasterHit::EntityHit | 3 | Es wurde nur das umschließende Volumen berücksichtigt; die Primitiv- und Scheitelpunktindizes sind undefiniert |
Dokumentation der Eigenschaften
[read-only] distance : const float
Diese Eigenschaft enthält den Abstand zwischen dem Ursprung des Strahls und dem Schnittpunkt.
Enthält den Abstand vom Ursprung des Strahls bis zu dem Punkt, an dem der Strahl die Entität geschnitten hat.
Zugriffsfunktionen:
| float | distance() const |
[read-only] entity : Qt3DCore::QEntity* const
Diese Eigenschaft enthält einen Zeiger auf die Entität, die getroffen wurde.
Enthält einen Zeiger auf die QEntity, die vom Strahl getroffen wurde.
Zugriffsfunktionen:
| Qt3DCore::QEntity * | entity() const |
[read-only] entityId : const Qt3DCore::QNodeId
Diese Eigenschaft enthält die ID der Entität, die getroffen wurde.
Enthält die Knoten-ID der Entität, die vom Strahl getroffen wurde.
Zugriffsfunktionen:
| Qt3DCore::QNodeId | entityId() const |
[read-only] localIntersection : const QVector3D
Diese Eigenschaft enthält die Koordinaten des Schnittpunkts im Koordinatensystem des Objekts.
Enthält die Koordinaten des Schnittpunkts im lokalen Koordinatensystem des Objekts.
Zugriffsfunktionen:
| QVector3D | localIntersection() const |
[read-only] primitiveIndex : const uint
Diese Eigenschaft enthält den Index des ausgewählten Primitivs.
Enthält den Index des ausgewählten Primitivs (Dreieck, Linie oder Punkt).
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 entweder „ 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 der ausgewählten Primitive. Bei einem Dreiecks-Treffer ist dies einer der drei Scheitelpunkte. Bei einem Linien-Treffer 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 der ausgewählten Primitive. 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.
Enthält den Index des dritten Scheitelpunkts der ausgewählten Primitive. Dies gilt nur für Dreiecks-Treffer.
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 zu den Member-Funktionen
float QRayCasterHit::distance() const
Gibt den Abstand zwischen dem Ursprung des Strahls und dem Schnittpunkt zurück
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 Entität zurück, die getroffen wurde
Hinweis: Getter -Funktion für die Eigenschaft „entityId“.
QVector3D QRayCasterHit::localIntersection() const
Gibt die Koordinaten des Schnittpunkts im Koordinatensystem des Objekts zurück
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.
