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
Detaillierte Beschreibung
Wird als Rückgabeobjekt an View3D::pick erstellt.
Eigenschaft Dokumentation
distance : real [read-only]
Diese Eigenschaft enthält den Abstand zwischen dem Pick-Ursprung und der Trefferposition, d.h. die Länge des Strahls. Im Falle der Verwendung von Ansichtsfenster-Koordinaten für die Auswahl ist der Ursprung der Auswahl die Position der aktiven Kamera.
hitType : enumeration [read-only, since 6.8]
Diese Eigenschaft enthält den Treffertyp des Auswahlergebnisses.
| Konstante | Beschreibung |
|---|---|
PickResult.Null | Der Pick hat nichts getroffen. |
PickResult.Model | Das Plektrum hat ein Modell getroffen. |
PickResult.Item | Der Pick 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 der Pick eine Instanz eines instanzierten Modells trifft.
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 Koordinatenraum.
Hinweis: Bei 2D-Objekten ist dies 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 pickResult.Model ist.
Siehe auch itemHit.
position : vector3d [read-only]
Diese Eigenschaft enthält die Position des Treffers im lokalen Koordinatenraum.
sceneNormal : vector3d [read-only]
Diese Eigenschaft enthält die Normale der getroffenen Fläche im Szenenkoordinatenraum.
scenePosition : vector3d [read-only]
Diese Eigenschaft enthält die Position des Treffers in der Szene.
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 Trefferpunkts relativ zum Bounding Volume berechnet. Nützlich für die weitere Auswahl gegen ein Offscreen-gerendertes Objekt.
Wenn hitType gleich pickResult.Item ist, stellt dieser Wert die Position des Treffers im Koordinatenraum von itemHit dar.
© 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.
