ObjectPicker QML Type
Die Klasse ObjectPicker instanziiert eine Komponente, die zur Interaktion mit einem Entity durch einen als "Picking" bekannten Prozess verwendet werden kann. Mehr...
| Import Statement: | import Qt3D.Render 2.8 |
| In C++: | QObjectPicker |
| Status: | Deprecated |
Eigenschaften
- containsMouse : bool
- dragEnabled : bool
- hoverEnabled : bool
- pressed : bool
- priority : int
Signale
- clicked(PickEvent pick)
- entered()
- exited()
- moved(PickEvent pick)
- pressed(PickEvent pick)
- released(PickEvent pick)
Detaillierte Beschreibung
Für jede Kombination von Ansichtsfenster und Kamera wirft Picking einen Strahl durch die Szene, um Objekte zu finden, deren Bounding Volume den Strahl schneidet. Das Begrenzungsvolumen wird anhand der Werte im Attributpuffer berechnet, der durch das BoundingVolumePositionAttribute der Geometrie angegeben wird.
Die Signale pressed(), released(), clicked(), moved(), entered() und exited() werden ausgegeben, wenn das durch die Eigenschaft pickAttribute definierte Begrenzungsvolumen einen Strahl schneidet.
Die meisten Signale enthalten eine PickEvent -Instanz. Wenn PickingSettings.pickMode auf PickingSettings.TrianglePicking gesetzt ist, ist der aktuelle Typ des Pick-Parameters PickTriangleEvent.
Pick-Abfragen werden beim Drücken der Maus und beim Loslassen der Maus durchgeführt. Wenn Drag aktiviert ist, werden Abfragen auch bei jeder Mausbewegung durchgeführt, während eine beliebige Taste gedrückt ist. Wenn Hover aktiviert ist, erfolgt die Abfrage bei jeder Mausbewegung, auch wenn keine Taste gedrückt ist.
Hinweis: Um Hover-Ereignisse in QtQuick zu empfangen, muss die Eigenschaft hoverEnabled von Scene3D ebenfalls gesetzt sein.
Hinweis: Instanzen dieser Komponente sollten nicht gemeinsam genutzt werden, da die Nichtbeachtung dieser Bedingung höchstwahrscheinlich zu undefiniertem Verhalten führt.
Hinweis: Der Wert für die Kamera-Fernebene beeinflusst das Picking und führt aufgrund der Fließkomma-Präzision zu falschen Ergebnissen, wenn er größer als ~100 000 ist.
Siehe auch PickingSettings, Geometry, Attribute, PickEvent, PickTriangleEvent, und NoPicking.
Eigenschaft Dokumentation
containsMouse : bool |
Gibt an, ob die Objektauswahl derzeit die Maus enthält
dragEnabled : bool |
hoverEnabled : bool |
Gibt an, ob Hover aktiviert ist
pressed : bool |
Gibt an, ob der Objektwähler gerade gedrückt ist
priority : int |
Die Priorität, die beim Filtern der Auswahlergebnisse nach Priorität verwendet werden soll, wenn PickingSettings.pickResultMode auf PickingSettings.PriorityPick gesetzt ist.
Signal Dokumentation
clicked(PickEvent pick) |
Dieses Signal wird ausgegeben, wenn das durch die Eigenschaft pickAttribute definierte Begrenzungsvolumen bei einem Mausklick einen Strahl schneidet. Die Schnittpunktinformationen sind über den Parameter pick zugänglich.
Hinweis: Der entsprechende Handler ist onClicked.
entered() |
Dieses Signal wird ausgegeben, wenn sich das durch die pickAttribute-Eigenschaft definierte Begrenzungsvolumen mit einem Strahl schneidet, wenn die Maus das Volumen betritt.
Hinweis: Der entsprechende Handler ist onEntered.
exited() |
Dieses Signal wird ausgegeben, wenn sich das durch die pickAttribute-Eigenschaft definierte Begrenzungsvolumen mit einem Strahl schneidet, der das Volumen verlässt.
Hinweis: Der entsprechende Handler ist onExited.
moved(PickEvent pick) |
Dieses Signal wird ausgegeben, wenn sich das durch die pickAttribute-Eigenschaft definierte Begrenzungsvolumen bei einer Mausbewegung mit gedrückter Taste mit einem Strahl schneidet. Die Schnittpunktinformationen sind über den Parameter pick zugänglich.
Hinweis: Der entsprechende Handler ist onMoved.
pressed(PickEvent pick) |
Dieses Signal wird ausgegeben, wenn sich das durch die pickAttribute-Eigenschaft definierte Begrenzungsvolumen bei einer Mausbewegung mit gedrückter Taste mit einem Strahl schneidet. Die Schnittpunktinformationen sind über den Parameter pick zugänglich.
Hinweis: Der entsprechende Handler ist onPressed.
released(PickEvent pick) |
Dieses Signal wird ausgegeben, wenn sich das durch die pickAttribute-Eigenschaft definierte Begrenzungsvolumen mit einem Strahl schneidet, wenn die Maus losgelassen wird. Die Schnittpunktinformationen sind über den Parameter pick zugänglich.
Hinweis: Der entsprechende Handler ist onReleased.
© 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.
