Qt Quick 3D QML Types

这是使用空间渲染器和场景图的 QML 前端。目前，所有三维内容都通过离屏纹理（FBO），以便将它们组成Qt Quick 场景（如QQuickItem ）。

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

import QtQuick3D

QtQuick3D QML Types

AddDefine	为通道的着色器编译添加预处理器定义
BakedLightmap	为模型指定烘焙光贴图设置
Buffer	创建或引用一个颜色缓冲区，以用于一个效果的传递
BufferInput	定义一个输入缓冲区，作为效果的一个通道的输入
Camera	定义相机的抽象基础
ColorAttachment	定义色彩附件
Command	作为效果传递的一部分执行的命令的超级类型
ContentLayer	提供 QtQuick3D 中可用的内容层枚举
CubeMapTexture	定义用于 3D 场景的立方体贴图纹理
CustomCamera	定义带有自定义投影矩阵的相机
CustomMaterial	创建自定义材质的基础组件，用于为模型遮光
DebugSettings	用于配置调试设置
DepthStencilAttachment	为 RenderPass 定义深度模版附件
DepthTextureAttachment	为渲染通道定义深度纹理附件
DirectionalLight	定义场景中的定向光
Effect	用于创建后期处理效果的基础组件
FileInstancing	允许从文件中读取实例表
Fog	为场景指定雾化设置
FrustumCamera	为透视摄像机定义一个自定义锥面
Geometry	自定义几何体的基本类型
InstanceList	允许在 QML 中手动指定实例
InstanceListEntry	在实例列表中指定实例
Instancing	实例表的基本类型
Joint	定义骨骼动画层次结构中的节点
Light	所有灯光的不可创建抽象基础类型
Lightmapper	为场景指定光图烘焙设置
Loader3D	允许从 URL 或组件动态加载 3D 子树
Material	提供材质通用功能的抽象基础类型
Model	允许加载三维模型数据
MorphTarget	定义变形目标的属性
Node	三维场景中物体的基础组件
Object3D	所有三维节点和资源的抽象基础类型
OrthographicCamera	使用正投影矩阵定义相机
Pass	定义特效中的渲染通道
PerspectiveCamera	定义用于查看三维场景内容的透视摄像机
PipelineStateOverride	定义单次渲染的流水线状态重写
PointLight	在场景中定义点光源
PrincipledMaterial	使用金属/粗糙度工作流程为 3D 项目定义材质
Quaternion	为四元数提供实用功能
QuaternionAnimation	四元数属性动画
ReflectionProbe	在场景中定义反射探针
RenderExtension	用于渲染扩展的不可创建的抽象基础类型
RenderPass	该类型定义了用于渲染 3D 内容的自定义渲染通道
RenderPassTexture	定义一个纹理作为渲染通道中的渲染目标
RenderStats	提供场景渲染信息
RenderablesFilter	定义一个过滤器，用于选择在传递中影响哪些渲染对象
Repeater3D	使用提供的模型实例化大量基于节点的组件
ResourceLoader	允许预加载 3D 资源
SceneEnvironment	让您配置场景的渲染方式
SetUniformValue	定义要在单次渲染中设置的值
Shader	用于定义后处理特效所用着色器代码的容器组件
Skeleton	定义骨骼动画层次结构
Skin	定义蒙皮动画
SpecularGlossyMaterial	使用镜面/光泽度工作流程为 3D 项目定义材质
SpotLight	在场景中定义聚光灯
Texture	定义用于 3D 场景的纹理
TextureData	自定义纹理数据的基本类型
TextureInput	指定暴露给自定义材质或效果着色器的纹理
TextureProviderExtension	用于纹理提供程序扩展的不可创建的抽象基础类型
View3D	为渲染三维场景提供视口
renderTargetBlend	为渲染传递的单一颜色附件定义混合参数

QML 值类型

bounds	指定模型的边界
pickResult	包含选取结果

QtQuick3D.Helpers QML 类型

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

import QtQuick3D.Helpers

AxisHelper	在 3D 场景中显示 3 个轴和网格的可视化助手
CapsuleGeometry	为胶囊提供几何图形
ConeGeometry	为圆锥体提供几何图形
CuboidGeometry	为立方体提供几何图形
CylinderGeometry	为圆柱体提供几何图形
DebugView	用于显示渲染统计数据并执行调试和开发人员操作的视图
ExtendedSceneEnvironment	提供常用渲染效果的场景环境
ExtrudedTextGeometry	为挤出文本提供几何体
GridGeometry	用于渲染网格的自定义几何体提供程序
HeightFieldGeometry	高度区域几何体
InfiniteGrid	显示无限网格
InstanceModel	根据实例表定义数据模型
InstanceRange	为 RandomInstancing 指定范围
InstanceRepeater	根据实例表实例化组件
LodManager	处理详细程度可见性变化的管理器
LookAtNode	自动保持指向另一个节点的辅助节点
OrbitCameraController	围绕原点旋转的相机控制器
PlaneGeometry	为平面提供几何体
ProceduralMesh	允许从 QML 创建几何体
ProceduralMeshSubset	定义程序网格的子集
ProceduralSkyTextureData	生成 HDR 天幕立方体地图
ProceduralTextureData	允许从 QML 创建和填充纹理数据
RandomInstancing	生成随机实例表
SphereGeometry	为球体提供几何图形
TorusGeometry	提供环形的几何图形
WasdController	使用按键和鼠标控制节点位置和方向

QtQuick3D.AssetUtils QML 类型

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

import QtQuick3D.AssetUtils

RuntimeLoader

在运行时导入 3D 资产

QtQuick3D.Particles3D QML类型

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

import QtQuick3D.Particles3D

Affector3D	Affectors 在粒子的生命周期内修改粒子的属性
Attractor3D	吸引粒子朝向一个位置或形状
Direction3D	方向为发射的粒子指定速度
DynamicBurst3D	动态发射器爆发
EmitBurst3D	声明式粒子喷发
Gravity3D	将粒子加速到指定方向上的指定大小的矢量
LineParticle3D	线条粒子
ModelBlendParticle3D	将粒子效果与 3D 模型融合
ModelParticle3D	使用Qt Quick 3D 模型的粒子
Particle3D	抽象逻辑粒子
ParticleAbstractShape3D	粒子形状的抽象基础类型
ParticleCustomShape3D	为发射器和影响器加载自定义粒子形状
ParticleEmitter3D	逻辑粒子的发射器
ParticleModelShape3D	为发射器和影响器提供来自模型的粒子形状
ParticleSceneShape3D	为发射器和影响器提供来自场景的粒子形状
ParticleShape3D	为发射器和影响器提供三维形状
ParticleSystem3D	包含粒子、发射器和影响器类型的系统
ParticleSystem3DLogging	提供粒子系统的信息
PointRotator3D	围绕支点旋转粒子
Repeller3D	粒子排斥器
ScaleAffector3D	粒子缩放影响器
SpriteParticle3D	使用二维精灵纹理的粒子
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	可容纳 2D 用户界面内容的 3D 空间虚拟表面
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; 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

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.