pickResult QML Value Type
Enthält die Ergebnisse einer Auswahl. Mehr...
| Import Statement: | import QtQuick3D |
Eigenschaften
- distance : real
- hitType : enumeration
(since 6.8) - instanceIndex : int
(since 6.5) - itemHit : Item
(since 6.8) - normal : vector3d
- objectHit : Model
- position : vector3d
- sceneNormal : vector3d
- scenePosition : vector3d
- uvPosition : vector2d
Ausführliche Beschreibung
Erstellt als Rückgabeobjekt für „ View3D::pick “.
Dokumentation der Eigenschaften
distance : real [read-only]
Diese Eigenschaft enthält den Abstand zwischen dem Auswahlursprung und der Trefferposition, d. h. die Länge des Strahls. Bei Verwendung von Viewport-Koordinaten für die Auswahl entspricht der Auswahlursprung der Position der aktiven Kamera.
hitType : enumeration [read-only, since 6.8]
Diese Eigenschaft enthält den Treffer-Typ des Auswahlergebnisses.
| Konstante | Beschreibung |
|---|---|
PickResult.Null | Die Auswahl hat nichts getroffen. |
PickResult.Model | Die Auswahl hat ein Modell getroffen. |
PickResult.Item | Die Auswahl hat ein „ QQuickItem “ getroffen. |
Diese Eigenschaft wurde in Qt 6.8 eingeführt.
instanceIndex : int [read-only, since 6.5]
Diese Eigenschaft enthält den Index in der Instanztabelle für den Fall, dass die Auswahl auf eine Instanz eines instanzierten Modells getroffen ist.
Diese Eigenschaft wurde in Qt 6.5 eingeführt.
itemHit : Item [read-only, since 6.8]
Diese Eigenschaft enthält das „ Qt Quick “-Element, das von der Auswahl getroffen wurde. Dieser Wert ist null, wenn „ hitType “ nicht „ pickResult.Item “ ist.
Diese Eigenschaft wurde in Qt 6.8 eingeführt.
Siehe auch „ objectHit “.
normal : vector3d [read-only]
Diese Eigenschaft enthält die Normale der getroffenen Fläche im lokalen Koordinatensystem.
Hinweis: Hierbei handelt es sich um die geometrische Normale der Fläche, die bei einer Fläche, die auf ihrer Rückseite getroffen wurde, vom Strahl wegzeigt. Rückseiten werden nur ausgewählt, wenn die Material- cull mode, sie nicht verworfen.
Hinweis: Bei 2D-Objekten ist dieser Wert immer (0, 0, 1).
objectHit : Model [read-only]
Diese Eigenschaft enthält das Modellobjekt, das von der Auswahl getroffen wurde. Dieser Wert ist null, wenn „ hitType “ nicht auf „ pickResult.Model “ gesetzt ist.
Siehe auch „ itemHit “.
position : vector3d [read-only]
Diese Eigenschaft enthält die Szenenposition des Treffers im lokalen Koordinatensystem.
sceneNormal : vector3d [read-only]
Diese Eigenschaft enthält die Normale der getroffenen Fläche im Szenenkoordinatensystem.
scenePosition : vector3d [read-only]
Diese Eigenschaft enthält die Szenenposition des Treffers.
uvPosition : vector2d [read-only]
Diese Eigenschaft enthält die UV-Position des Treffers. Die UV-Position wird als normalisierte lokale x- und y-Koordinaten des Treffpunkts relativ zum Begrenzungsvolumen berechnet. Nützlich für die weitere Auswahl anhand eines außerhalb des Bildschirms gerenderten Objekts.
Wenn „ hitType “ auf „ pickResult.Item “ gesetzt ist, gibt dieser Wert die Position des Treffers im Koordinatenraum von „ itemHit “ an.
© 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.
