QPickingProxy Class

class Qt3DRender::QPickingProxy

Can be used to provide an alternate QGeometryView used only for picking. More...

Header: #include <QPickingProxy>
CMake: find_package(Qt6 COMPONENTS 3drender REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
Since: Qt 6.0
Instantiated By: PickingProxy
Inherits: Qt3DCore::QBoundingVolume

Public Functions

QPickingProxy(Qt3DCore::QNode *parent = nullptr)

Detailed Description

Picking can be an expensive operation, especially if the mesh has a lot of vertices. QPickProxy can be used to provide an alternative geometry, usually with fewer primitives, which will be used for picking, while the GeometryRenderer instance will be used for rendering.

Note: Do not use a QPickingProxy if the application requires picking coordinates to match the rendered mesh.

Note: The picking algorithm uses a bounding volume hierarchy to optimize out entities who's bounding volume does not intersect the picking ray. For that hierarchy, the bounding volume of the renderered entity is used (or one explicitly set using a QBoundingVolume component) will be used rather than the one of the proxy.

Member Function Documentation

QPickingProxy::QPickingProxy(Qt3DCore::QNode *parent = nullptr)

Constructs a new QPickingProxy with parent.

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