Qt3D Inspector

Overview

The Qt 3D inspector allows you to browse the entity tree and the frame graph of a Qt 3D scene. If the target application contains multiple Qt 3D engine, you can select the desired Qt3DCore::QAspectEngine in the combo box at the top.

On the left side you can switch between two views with the tabs at the bottom:

  • The entity tree of the scene.
  • The frame graph composing the render settings of the scene.

Entity Tree

The entity tree shows the hierarchy of the Qt3DCore::QEntity instances of the scenes. The checkbox next to each entity shows the state of the entity enabled state (see Qt3DCore::QEntity::enabled), which can also be changed this way. The context menu on the entity tree allows navigation to other views of the entity object.

Render Settings

The frame graph tree shows the hierarchy of the Qt3DRender::QFrameGraphNode instances composing the Qt3DRender::QRenderSettings of a scene. The checkbox next to each node shows the state of the frame graph node enabled state (see Qt3DRender::QFrameGraphNode::enabled), which can also be changed this way. The context menu on the entity tree allows navigation to other views of the node object.

Geometry Inspection

When selecting an entity with a geometry component attached, or a geometry component directly in a different view, the Qt3D Geometry Inspector tab is shown on the right hand side.

The geometry inspection tab has two views:

  • A graphical wireframe view of the geometry with various diagnostic shading modes.
  • A raw data view on its associated Qt3DRender::QBuffer instances.

Wireframe View

The wireframe view renders the selected geometry separately, so it can be inspected for defects easily. Common issues involve:

  • Wrong triangle ordering. Toggle backface culling in the toolbar above the wireframe view to get culled back faces highlighted.
  • Wrong normal vectors. Toggle the normal vector visualization to get vertex and face normals displayed.

You can move the camera in the wireframe view using mouse (left and middle mouse buttons) or keyboard (arrow keys, page up/page down, W/A/S/D).

Buffer View

You can switch to the raw buffer view in the toolbar of the Qt3D Geometry Inspector tab, and select the Qt3DRender::QBuffer instance to inspect in the combo box at the top right.

The buffer view then shows the buffer data decoded based on its associated Qt3DRender::QAttribute instances.

Examples

The following examples make use of the Qt3D inspector: