Qt Quick 3D QML Types

这是用于调用空间渲染器和场景图的 QML 前端。目前，所有 3D 内容均通过离屏纹理（FBO）处理，以便将其合成到Qt Quick 场景中（作为QQuickItem ）。

使用以下语句导入 QtQuick3D 模块：

import QtQuick3D

QtQuick3D QML 类型

AddDefine	为着色器编译的某个渲染通道添加预处理器定义
BakedLightmap	为模型指定烘焙光照贴图的设置
Buffer	创建或引用一个用于效果（Effect）某次渲染通道的颜色缓冲区
BufferInput	定义一个将用作效果某次渲染通道输入的输入缓冲区
Camera	定义摄像机的抽象基类
ColorAttachment	为渲染通道定义颜色附件
Command	作为效果中渲染通道的一部分执行的命令的超类
ContentLayer	提供用于分组和过滤场景节点的图层标志常量的单例
CubeMapTexture	定义用于 3D 场景的立方体贴图
CustomCamera	定义了一个带有自定义投影矩阵的摄像机
CustomMaterial	用于创建自定义材质以对模型进行着色的基类组件
DebugSettings	用于配置调试设置
DepthStencilAttachment	为渲染通道（RenderPass）定义深度-模板附件
DepthTextureAttachment	为渲染通道定义深度纹理附件
DirectionalLight	在场景中定义一盏定向光
Effect	用于创建后处理效果的基础组件
FileInstancing	允许从文件中读取实例表
Fog	为场景指定雾效设置
FrustumCamera	定义一个带有自定义视锥体的透视摄像机
Geometry	自定义几何体的基类
InstanceList	允许在 QML 中手动指定实例化
InstanceListEntry	在 InstanceList 中指定一个实例
Instancing	实例表的基类
Joint	定义骨骼动画层次结构中的节点
Light	所有光源的不可创建的抽象基类
Lightmapper	为场景指定光照贴图烘焙设置
Loader3D	允许从 URL 或组件动态加载 3D 子树
Material	提供材质通用功能的抽象基类
Model	允许您加载3D模型数据
MorphTarget	定义变形目标的属性
Node	存在于3D场景中的对象的基础组件
Object3D	所有 3D 节点和资源的抽象基类
OrthographicCamera	定义了一个带有正交投影矩阵的摄像机
Pass	定义效果器中的渲染通道
PerspectiveCamera	定义用于查看 3D 场景内容的透视摄像机
PipelineStateOverride	定义单个渲染通道的管道状态覆盖
PointLight	在场景中定义一个点光源
PrincipledMaterial	允许您使用金属度/粗糙度工作流为3D对象定义材质
Quaternion	提供四元数相关辅助函数
QuaternionAnimation	四元数的属性动画
ReflectionProbe	在场景中定义反射探针
RenderExtension	一个用于渲染扩展的不可创建的抽象基类
RenderPass	定义用于渲染 3D 内容的自定义渲染通道
RenderPassTexture	定义了一种将在渲染通道中用作渲染目标的纹理
RenderStats	提供场景渲染的相关信息
RenderablesFilter	定义一个过滤器，用于选择在渲染通道中受影响的渲染对象
Repeater3D	使用提供的模型实例化若干基于节点的组件
ResourceLoader	允许预加载 3D 资源
SceneEnvironment	允许您配置场景的渲染方式
SetUniformValue	定义在单个渲染通道中需设置的值
Shader	用于定义后处理效果所用着色器代码的容器组件
Skeleton	定义骨骼动画层级结构
Skin	定义骨骼绑定动画
SkyMaterial	渲染程序化天空并生成基于图像的照明数据
SpecularGlossyMaterial	允许您使用镜面反射/光泽度工作流程为 3D 对象定义材质
SpotLight	在场景中定义聚光灯
SubRenderPass	在与父级RenderPass相同的渲染目标内渲染工作的一部分
Texture	定义用于 3D 场景的纹理
TextureData	自定义纹理数据的基础类型
TextureInput	指定一个供 CustomMaterial 或 Effect 着色器使用的纹理
TextureProviderExtension	用于生成纹理的渲染扩展的抽象基类
View3D	提供用于渲染 3D 场景的视口

QML 值类型

bounds	指定模型的边界
pickResult	包含拾取操作的结果
renderTargetBlend	定义渲染通道中单个颜色附件的混合参数

QtQuick3D.Helpers QML 类型

使用以下语句导入 QtQuick3D.Helpers 模块：

import QtQuick3D.Helpers

AxisHelper	用于在 3D 场景中显示 3 个坐标轴和网格的视觉辅助工具
CapsuleGeometry	为胶囊提供几何体
ConeGeometry	提供圆锥的几何体
CuboidGeometry	提供长方体的几何体
CylinderGeometry	提供圆柱体的几何体
DebugView	用于显示渲染统计信息并执行调试和开发操作的视图
ExtendedSceneEnvironment	一个提供常用渲染效果的 SceneEnvironment
ExtrudedTextGeometry	提供挤出文本的几何体
GridGeometry	用于渲染网格的自定义几何体提供器
HeightFieldGeometry	一个高程场几何体
InfiniteGrid	显示无限网格
InstanceModel	基于实例表定义数据模型
InstanceRange	为 RandomInstancing 指定范围
InstanceRepeater	根据实例表实例化组件
LodManager	处理细节级别可见性变化的管理器
LookAtNode	一个会自动保持指向另一个节点的辅助节点
OrbitCameraController	围绕原点旋转的摄像机控制器
PlaneGeometry	为平面提供几何体
ProceduralMesh	允许从 QML 创建几何体
ProceduralMeshSubset	定义 ProceduralMesh 的子集
ProceduralSkyTextureData	生成HDR天空盒立方贴图
ProceduralTextureData	支持通过 QML 创建和填充 TextureData
QuadTextureProvider	用于使用自定义片段着色器渲染四边形纹理
RandomInstancing	生成一个随机的实例化表
RenderOutputProvider	用作访问各渲染通道中提供的纹理的桥梁
SimpleQuadRenderer	将带纹理的全屏四边形渲染到主渲染目标
SphereGeometry	提供球体的几何体
TorusGeometry	为环面提供几何体
WasdController	使用键盘和鼠标控制节点的位置和方向

QtQuick3D.AssetUtils QML 类型

使用以下语句导入 QtQuick3D.AssetUtils 模块：

import QtQuick3D.AssetUtils

RuntimeLoader

在运行时导入 3D 资源

QtQuick3D.Particles3D QML 类型

使用以下语句导入 QtQuick3D.Particles3D 模块：

import QtQuick3D.Particles3D

Affector3D	影响器可在粒子的生命周期内修改其属性
Attractor3D	将粒子吸引到某个位置或形状处
Direction3D	方向（Directions）为发射的粒子赋予速度
DynamicBurst3D	动态发射器爆发
EmitBurst3D	声明式发射器爆发
Gravity3D	将粒子加速至指定方向上、指定大小的向量
LineParticle3D	线状粒子
ModelBlendParticle3D	将粒子效果与3D模型融合
ModelParticle3D	使用Qt Quick 3D 模型的粒子
Particle3D	抽象逻辑粒子
ParticleAbstractShape3D	粒子形状的抽象基类
ParticleCustomShape3D	为发射器和影响器加载自定义粒子形状
ParticleEmitter3D	逻辑粒子的发射器
ParticleModelShape3D	为发射器和作用器提供来自模型的粒子形状
ParticleSceneShape3D	为发射器和影响器提供来自场景的粒子形状
ParticleShape3D	为发射器和影响器提供 3D 形状
ParticleSystem3D	包含粒子、发射器和影响器类型的系统
ParticleSystem3DLogging	提供粒子系统的相关信息
PointRotator3D	围绕枢轴点旋转粒子
Repeller3D	粒子排斥器
ScaleAffector3D	粒子缩放影响器
SpriteParticle3D	使用 2D 精灵纹理的粒子
SpriteSequence3D	为精灵粒子提供图像序列功能
TargetDirection3D	用于指定指向目标位置的方向
TrailEmitter3D	用于从其他粒子发射逻辑粒子的发射器
VectorDirection3D	用于指定指向目标方向的方向
Wander3D	将随机波形曲线应用于粒子

QtQuick3D.Xr QML 类型

使用以下语句导入 QtQuick3D.Xr 模块：

import QtQuick3D.Xr

XrCamera	跟踪用户观察 XR 场景时的空间位置和方向
XrController	一个被追踪的空间节点，用于追踪输入控制器的位置和方向
XrErrorDialog	适用于 PCVR 应用程序的自定义错误对话框
XrHandModel	表示一只手的 3D 模型
XrHapticEffect	表示一种触觉效果
XrHapticFeedback	控制 XR 控制器上的触觉反馈
XrInputAction	表示来自输入控制器的操作
XrItem	位于3D空间中、可承载2D用户界面内容的虚拟表面
XrOrigin	XrView的原点位置
XrRuntimeInfo	显示有关 XR 运行时的信息
XrSimpleHapticEffect	允许通过振幅、持续时间和频率设置控制器触觉反馈
XrSpatialAnchor	追踪实空间中的特定位置或物体
XrSpatialAnchorListModel	提供包含空间锚点的模型
XrView	为 Xr 应用程序设置视图
XrVirtualMouse	将 3D 控制器输入映射为 2D 元素中的鼠标输入

已弃用的 QML 类型

以下 QML 类型现已过时。过时类型不再进行维护。提供这些类型是为了确保旧源代码能够继续运行，但它们可能会在未来的版本中被移除。我们强烈建议不要在新代码中使用这些类。

A: AdditiveColorGradient

B: Blur; BrushStrokes

C: ChromaticAberration; ColorMaster

D: DefaultMaterial; DepthOfFieldHQBlur; Desaturate; DistortionRipple; DistortionSphere; DistortionSpiral

E: EdgeDetect; Emboss

F: Flip; FunctionSorter; Fxaa

G: GaussianBlur

H: HDRBloomTonemap

M: MotionBlur

S: Scatter; SCurveTonemap; Settings

T: TiltShift

V: Vignette

包含已弃用属性或方法的 QML 类型

以下 QML 类型包含一个或多个现已弃用的属性或方法。弃用的成员不再进行维护。提供这些成员是为了确保旧源代码能够继续运行，但它们可能会在未来的版本中被移除。我们强烈建议不要在新代码中使用这些弃用的成员。点击某个类型以查看其已弃用的成员。

A: Application

B: BakedLightmap

C: Canvas

D: DragHandler

G: Gravity

H: HeightFieldGeometry

L: Light; Locale

M: Model; MouseEvent

P: PinchHandler

Q: Qt

S: Screen; SortFilterProxyModel

T: TableView; Text; TouchPoint

X: XrInputAction

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