QNoPicking Class

class Qt3DRender::QNoPicking

When a Qt3DRender::QNoPicking node is present in a FrameGraph branch, this prevents the render aspect from performing picking selection for the given branch. More...

Header: #include <QNoPicking>
qmake: QT += 3drender
Since: Qt 5.14
Instantiated By: NoPicking
Inherits: Qt3DRender::QFrameGraphNode

This class was introduced in Qt 5.14.

Detailed Description

When disabled, a Qt3DRender::QNoPicking node won't prevent picking from being performed. Toggling the enabled property is therefore a way to make a Qt3DRender::QNoPicking active or inactive.

When using multiple subviewports in the FrameGraph, QNoPicking can be useful to prevent picking conflicts between overlapping viewports or non visual ones. It can also be used as an optimization to prevent unnecessary work for hidden viewports or for sections of the scenes which don't require any picking.

 Qt3DRender::QViewport *viewport = new Qt3DRender::QViewport();
 Qt3DRender::QCameraSelector *cameraSelector = new Qt3DRender::QCameraSelector(viewport);
 Qt3DRender::QNoPicking *noPicking = new Qt3DRender::QNoPicking(cameraSelector);

 Qt3DRender::QClearBuffers *clearBuffers = new Qt3DRender::QClearBuffers(noPicking);
 clearBuffers->setBuffers(Qt3DRender::QClearBuffers::ColorDepthBuffer);

 Qt3DRender::QRenderPassFilter *mainPass = new Qt3DRender::QRenderPassFilter(cameraSelector);
 ....
 Qt3DRender::QRenderPassFilter *previewPass = new Qt3DRender::QRenderPassFilter(cameraSelector);
 ....

See also Qt3DRender::QObjectPicker, Qt3DRender::QRayCaster, and Qt3DRender::QScreenRayCaster.