W3cubDocs

/Qt

NoPicking QML Type

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

Import Statement: import Qt3D.Render
Since: Qt 5.14
Instantiates: QNoPicking
Inherits:

FrameGraphNode

Detailed Description

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

When using multiple subviewports in the FrameGraph, NoPicking 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.

Viewport {
    CameraSelector {
        NoPicking {
            ClearBuffers {
                buffers: ClearBuffers.ColorDepthBuffer
                NoDraw { } // Prevents from drawing anything
            }
            RenderPassFilter {
                ...
            }
            RenderPassFilter {
                ...
            }
        }
    }
}

See also ObjectPicker, RayCaster, and ScreenRayCaster.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qml-qt3d-render-nopicking.html