View3D QML Type

This property specifies which Camera is used to render the scene. If this property is not set, then the first enabled camera in the scene will be used.

See also PerspectiveCamera, OrthographicCamera, FrustumCamera, and CustomCamera.

This property exposes the size, in pixels, of the underlying color (and depth/stencil) buffers. It is provided for use on the GUI (main) thread, in QML bindings or JavaScript.

This is a read-only property.

This property was introduced in Qt 6.7.

See also explicitTextureWidth, explicitTextureHeight, and DebugView.

This property specifies the SceneEnvironment used to render the scene.

See also SceneEnvironment.

The height, in pixels, of the item's associated texture. Relevant when a fixed texture size is desired that does not depend on the item's size. This size has no effect on the geometry of the item (its size and placement within the scene), which means the texture's content will appear scaled up or down (and possibly stretched) onto the item's area.

By default the value is 0. A value of 0 means that texture's size follows the item's size. (texture size in pixels = item's logical size * device pixel ratio).

This property was introduced in Qt 6.7.

See also explicitTextureWidth, effectiveTextureSize, and DebugView.

The width, in pixels, of the item's associated texture. Relevant when a fixed texture size is desired that does not depend on the item's size. This size has no effect on the geometry of the item (its size and placement within the scene), which means the texture's content will appear scaled up or down (and possibly stretched) onto the item's area.

By default the value is 0. A value of 0 means that texture's size follows the item's size. (texture size in pixels = item's logical size * device pixel ratio).

This property was introduced in Qt 6.7.

See also explicitTextureHeight, effectiveTextureSize, and DebugView.

This property contains a list of user extensions that should be used with this View3D.

See also RenderExtension.

This property defines the reference node of the scene to render to the viewport. The node does not have to be a child of the View3D. This referenced node becomes a sibling with child nodes of View3D, if there are any.

You can also define a hierarchy of Node-based items as children of the View3D directly, then this will become the implicit scene of the View3D.

To return the current scene of the View3D, use the scene property.

See also Node.

This property determines the backing texture's format. Applicable only when the View3D is rendering to a texture, for example because the renderMode is View3D.Offscreen.

The default is ShaderEffectSource.RGBA8.

If the format is not supported by the underlying graphics driver at run time, RGBA8 is used.

• ShaderEffectSource.RGBA8
• ShaderEffectSource.RGBA16F
• ShaderEffectSource.RGBA32F

This property was introduced in Qt 6.4.

See also QtQuick::ShaderEffectSource::format and QtQuick::Item::layer.format.

This property determines how the View3D is combined with the other parts of the Qt Quick scene.

By default, the scene will be rendered into an off-screen buffer as an intermediate step. This off-screen buffer is then rendered into the window (or render target) like any other Qt Quick Item.

For most users, there will be no need to change the render mode, and this property can safely be ignored. But on some graphics hardware, the use of an off-screen buffer can be a performance bottleneck. If this is the case, it might be worth experimenting with other modes.

The default is View3D.Offscreen.

This property provides statistics about the rendering of a frame, such as fps, frameTime, renderTime, syncTime, and maxFrameTime.

Returns the root Node of the View3D's scene.

To define the 3D scene that is visualized in the View3D:

• Define a hierarchy of Node-based items as children of the View3D directly, then this will become the implicit scene of the View3D.
• Reference an existing scene by using the importScene property and set it to the root Node of the scene you want to visualize. This Node does not have to be an ancestor of the View3D, and you can have multiple View3Ds that import the same scene.

See also importScene.

Transforms scenePos from scene space (3D) into view space (2D).

The returned x- and y-values will be be in view coordinates, with the top-left corner at [0, 0] and the bottom-right corner at [width, height]. The returned z-value contains the distance from the near clip plane of the frustum (clipNear) to scenePos in scene coordinates. If the distance is negative, that means the scenePos is behind the active camera. If scenePos cannot be mapped to a position in the scene, a position of [0, 0, 0] is returned.

This function requires that camera is assigned to the view.

See also mapTo3DScene() and Camera.mapToViewport().

Transforms viewPos from view space (2D) into scene space (3D).

The x- and y-values of viewPos should be in view coordinates, with the top-left corner at [0, 0] and the bottom-right corner at [width, height]. The z-value is interpreted as the distance from the near clip plane of the frustum (clipNear) in scene coordinates.

If viewPos cannot successfully be mapped to a position in the scene, a position of [0, 0, 0] is returned.

This function requires that a camera is assigned to the view.

See also mapFrom3DScene() and Camera.mapFromViewport().

This method will "shoot" a ray into the scene from view coordinates x and y and return information about the nearest intersection with an object in the scene.

This can, for instance, be called with mouse coordinates to find the object under the mouse cursor.

This method will "shoot" a ray into the scene from view coordinates x and y and return a list of information about intersections with objects in the scene. The returned list is sorted by distance from the camera with the nearest intersections appearing first and the furthest appearing last.

This can, for instance, be called with mouse coordinates to find the object under the mouse cursor.

This method was introduced in Qt 6.2.

This method will "shoot" a ray into the scene starting at origin and in direction and return information about the nearest intersection with an object in the scene.

This can, for instance, be called with the position and forward vector of any object in a scene to see what object is in front of an item. This makes it possible to do picking from any point in the scene.

This method was introduced in Qt 6.2.

This method will "shoot" a ray into the scene starting at origin and in direction and return a list of information about the nearest intersections with objects in the scene. The list is presorted by distance from the origin along the direction vector with the nearest intersections appearing first and the furthest appearing last.

This can, for instance, be called with the position and forward vector of any object in a scene to see what objects are in front of an item. This makes it possible to do picking from any point in the scene.

This method was introduced in Qt 6.2.