Qt Quick 3D QML Types

This is the QML frontend for using the spatial renderer and scenegraph. For the time being, all 3D content goes through offscreen textures (FBO)s so that they can be composed into Qt Quick scenes (as a QQuickItem).

Import the QtQuick3D module with the following statement:

import QtQuick3D

QtQuick3D QML Types

BakedLightmap

Specifies baked lightmap settings for a model

Buffer

Creates or references a color buffer to be used for a pass of an Effect

BufferInput

Defines an input buffer to be used as input for a pass of an Effect

Camera

Defines an abstract base for Cameras

Command

Supertype of commands to be performed as part of a pass in an Effect

CubeMapTexture

Defines a cube map texture for use in 3D scenes

CustomCamera

Defines a Camera with a custom projection matrix

CustomMaterial

Base component for creating custom materials used to shade models

DebugSettings

Used to configure debug settings

DirectionalLight

Defines a directional light in the scene

Effect

Base component for creating a post-processing effect

FileInstancing

Allows reading instance tables from file

Fog

Specifies fog settings for a scene

FrustumCamera

Defines a PerspectiveCamera with a custom frustum

Geometry

Base type for custom geometry

InstanceList

Allows manually specifying instancing in QML

InstanceListEntry

Specifies an instance in an InstanceList

Instancing

Base type for instance tables

Joint

Defines a node in a skeletal animation hierarchy

Light

An uncreatable abstract base type for all lights

Lightmapper

Specifies lightmap baking settings for a scene

Loader3D

Allows dynamic loading of a 3D subtree from a URL or Component

Material

Abstract base type providing functionality common to materials

Model

Lets you load a 3D model data

MorphTarget

Defines the properties of a morph target

Node

Base component for an object that exists in a 3D scene

Object3D

Abstract base type of all 3D nodes and resources

OrthographicCamera

Defines an Camera with an orthographic projection matrix

Pass

Defines a render pass in an Effect

PerspectiveCamera

Defines a Perspective Camera for viewing the content of a 3D scene

PointLight

Defines a point light in the scene

PrincipledMaterial

Lets you define a material for 3D items using the metal/roughness workflow

Quaternion

Provides utility functions for quaternion

QuaternionAnimation

A PropertyAnimation for quaternions

ReflectionProbe

Defines a reflection probe in the scene

RenderExtension

An uncreatable abstract base type for render extensions

RenderStats

Provides information of the scene rendering

Repeater3D

Instantiates a number of Node-based components using a provided model

ResourceLoader

Allows pre-loading of 3D resources

SceneEnvironment

Lets you configure how a scene is rendered

SetUniformValue

Defines a value to be set during a single pass

Shader

Container component for defining shader code used by post-processing effects

Skeleton

Defines a skeletal animation hierarchy

Skin

Defines a skinning animation

SpecularGlossyMaterial

Lets you define a material for 3D items using the specular/glossiness workflow

SpotLight

Defines a spot light in the scene

Texture

Defines a texture for use in 3D scenes

TextureData

Base type for custom texture data

TextureInput

Specifies a texture exposed to the shaders of a CustomMaterial or Effect

View3D

Provides a viewport on which to render a 3D scene

QML Value Types

bounds

Specifies the bounds of a model

pickResult

Contains the results of a pick

QtQuick3D.Helpers QML Types

Import the QtQuick3D.Helpers module with the following statement:

import QtQuick3D.Helpers

AxisHelper

Visual helper for showing the 3 axes and a grid in a 3D scene

ConeGeometry

Provides geometry for a cone

CuboidGeometry

Provides geometry for a cuboid

CylinderGeometry

Provides geometry for a cylinder

DebugView

View to show rendering statistics and perform debug and developer actions

ExtendedSceneEnvironment

A SceneEnvironment providing commonly used rendering effects

ExtrudedTextGeometry

Provides geometry for extruded text

GridGeometry

A custom geometry provider for rendering grids

HeightFieldGeometry

A height field geometry

InfiniteGrid

Shows an infinite grid

InstanceModel

Defines a data model based on an instance table

InstanceRange

Specifies a range for RandomInstancing

InstanceRepeater

Instantiates components based on an instance table

LodManager

Manager that handles level of detail visibility changes

LookAtNode

A helper node that is automatically kept pointing at another node

OrbitCameraController

Camera Controller which rotates around an origin

PlaneGeometry

Provides geometry for a plane

ProceduralMesh

Allows creation of Geometry from QML

ProceduralMeshSubset

Defines a subset of a ProceduralMesh

ProceduralSkyTextureData

Generates an HDR skybox cubemap

ProceduralTextureData

Allows creation and population of TextureData from QML

RandomInstancing

Generates a random instancing table

SphereGeometry

Provides geometry for a sphere

TorusGeometry

Provides geometry for a torus

WasdController

Control node position and orientation with keys and mouse

QtQuick3D.AssetUtils QML Types

Import the QtQuick3D.AssetUtils module with the following statement:

import QtQuick3D.AssetUtils

RuntimeLoader

Imports a 3D asset at runtime

QtQuick3D.Particles3D QML Types

Import the QtQuick3D.Particles3D module with the following statement:

import QtQuick3D.Particles3D

Affector3D

Affectors modify the attributes of particles during their lifetime

Attractor3D

Attracts particles towards a position or a shape

Direction3D

Directions assign velocity for the emitted particles

DynamicBurst3D

Dynamic emitter bursts

EmitBurst3D

Declarative emitter bursts

Gravity3D

Accelerates particles to a vector of the specified magnitude in the specified direction

LineParticle3D

Line particle

ModelBlendParticle3D

Blends particle effect with a 3D model

ModelParticle3D

Particle using a Qt Quick 3D Model

Particle3D

Abstract logical particle

ParticleAbstractShape3D

Abstract base type of particle shapes

ParticleCustomShape3D

Loads custom particle shapes for emitters and affectors

ParticleEmitter3D

Emitter for logical particles

ParticleModelShape3D

Offers particle shape from model for emitters and affectors

ParticleShape3D

Offers 3D shapes for emitters and affectors

ParticleSystem3D

A system which includes particle, emitter, and affector types

ParticleSystem3DLogging

Provides information of the particle system

PointRotator3D

Rotates particles around a pivot point

Repeller3D

Particle repeller

ScaleAffector3D

Particle scale affector

SpriteParticle3D

Particle using a 2D sprite texture

SpriteSequence3D

Provides image sequence features for the Sprite particles

TargetDirection3D

For specifying a direction towards the target position

TrailEmitter3D

Emitter for logical particles from other particles

VectorDirection3D

For specifying a direction towards the target direction

Wander3D

Applies random wave curves to particles

QtQuick3D.Xr QML Types

Import the QtQuick3D.Xr module with the following statement:

import QtQuick3D.Xr

XrCamera

Tracks spatial position and orientation from which the user views an XR scene

XrController

A tracked spatial node that tracks the position and orientation of an input controller

XrErrorDialog

Custom error dialog for PCVR applications

XrHandModel

Represents a 3D model for a hand

XrHapticEffect

Represents a haptic effect

XrHapticFeedback

Controls haptic feedback for an XR controller

XrInputAction

Represents an action from an input controller

XrItem

A virtual surface in 3D space that can hold 2D user interface content

XrOrigin

Origin location for the XrView

XrRuntimeInfo

Displays information about the XR runtime

XrSimpleHapticEffect

Allows setting controller haptics using amplitude, duration and frequency

XrSpatialAnchor

Tracks a specific location or object in real space

XrSpatialAnchorListModel

Provides a model containing spatial anchors

XrView

Sets up the view for an Xr application

XrVirtualMouse

Maps 3D controller input to mouse input in 2D items

Obsolete QML Types

The following QML types are now obsolete. Obsolete types are no longer maintained. They are provided to keep old source code working, but they can be removed in a future release. We strongly advise against using these classes in new code.

QML Types with Obsolete Properties or Methods

The following QML types contain one or more properties or methods that are now obsolete. Obsolete members are no longer maintained. They are provided to keep old source code working, but they can be removed in a future release. We strongly advise against using these obsolete members in new code. Click on a type to see its deprecated members.

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