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 Viewport-Koordinaten für das Picking ist der Pick-Ursprung die Position der aktiven Kamera.

hitType : enumeration [read-only, since 6.8]

Diese Eigenschaft enthält den Treffertyp des Pickergebnisses.

Konstante	Beschreibung
`PickResult.Null`	Der Pick hat nichts getroffen.
`PickResult.Model`	Der Pick 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 getroffen hat.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.

itemHit : Item [read-only, since 6.8]

Diese Eigenschaft enthält das Qt Quick Item, das von dem Pick 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 Fläche, die im lokalen Koordinatenraum getroffen wurde.

Hinweis: Für 2D-Objekte ist dies immer (0, 0, 1).

objectHit : Model [read-only]

Diese Eigenschaft enthält das Modellobjekt, das von dem Pick getroffen wurde. Dieser Wert ist null, wenn hitType nicht pickResult.Model ist.

Siehe auch itemHit.

position : vector3d [read-only]

Diese Eigenschaft enthält die Szenenposition 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 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 Trefferpunkts relativ zum Bounding Volume berechnet. Nützlich für die weitere Auswahl gegen ein Offscreen-gerendertes Objekt.

Wenn hitType pickResult.Item ist, stellt dieser Wert die Position des Treffers im Koordinatenraum von itemHit dar.

© 2025 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.