Qt 3D QML 类型

Qt 3D 核心 QML 类型的导入包括

import Qt3D.Core 2.9

其他模块导入碰撞检测、渲染、输入和动画功能。Qt 3D 导入语句的完整列表：

import Qt3D.Core 2.9
import Qt3D.Render 2.9
import Qt3D.Input 2.9
import Qt3D.Logic 2.9
import Qt3D.Extras 2.9
import Qt3D.Animation 2.9
import QtQuick.Scene2D 2.9
import QtQuick.Scene3D 2.9

QML 类型

Qt 3D 核心模块

AbstractSkeleton	骨架包含蒙皮网格的关节点
Armature	用于计算蒙皮变换矩阵并将其设置在着色器上
Attribute	定义属性以及从 Buffer（缓冲区）读取数据的方式
BoundingVolume	可用于覆盖实体的边界体积
Buffer	为原始数据提供数据存储空间，以便日后用作顶点或制服
Component3D	为创建Qt 3D 组件提供基本类型
CoreSettings	保存与核心数据处理流程相关的设置
Entity	节点子类，可聚合多个指定其行为的 Component3D 实例
EntityLoader	提供动态加载实体子树的方法
Geometry	封装几何体
GeometryView	封装几何细节
Joint	用于变换蒙皮网格的各个部分
Node	其他类型继承的基础 QML 类型。不能直接创建
NodeInstantiator	动态创建节点
QuaternionAnimation	用于四元数的 PropertyAnimation
Skeleton	为骨骼保存数据，以便与蒙皮网格一起使用
SkeletonLoader	用于从文件中加载关节骨架
Transform	用于对网格执行变换

Qt 3D 输入模块

AbstractActionInput	抽象 Qt3DInput::QAbstractActionInput C++ 类的 QML 前端
AbstractAxisInput	抽象 QAbstractAxisInput C++ 类的 QML 前端
AbstractPhysicalDevice	抽象 Qt3DInput::QAbstractPhysicalDevice C++ 类的 QML 前端
Action	Qt3DInput::QAction C++ 类的 QML 前端
ActionInput	Qt3DInput::QActionInput C++ 类的 QML 前端
AnalogAxisInput	Qt3DInput::QActionInput C++ 类的 QML 前端
Axis	Qt3DInput::QAxis C++ 类的 QML 前端
AxisAccumulator	Qt3DInput::QAxisAccumulator C++ 类的 QML 前端
AxisSetting	Qt3DInput::QAxisSetting C++ 类的 QML 前端
ButtonAxisInput	QButtonAxisInput C++ 类的 QML 前端。轴值由按钮而非传统的模拟输入（如操纵杆）控制
InputChord	Qt3DInput::QInputChord C++ 类的 QML 前端。
InputSequence	Qt3DInput::QInputSequence C++ 类的 QML 前端
InputSettings	持有指向输入事件源对象的指针
KeyEvent	QKeyEvent C++ 类的 QML 前端
KeyboardDevice	QKeyboardDevice C++ 类的 QML 前端
KeyboardHandler	QKeyboardHandler C++ 类的 QML 前端
LogicalDevice	Qt3DInput::QLogicalDevice C++ 类的 QML 前端
MouseDevice	将鼠标事件委托给附加的 MouseHandler 对象
MouseEvent	提供描述鼠标事件的参数
MouseHandler	提供鼠标事件通知
WheelEvent	包含描述鼠标滚轮事件的参数

Qt 3D 逻辑模块

FrameAction

提供一种在每一帧执行同步函数的方法

Qt 3D 渲染模块

AbstractRayCaster	用于 3D 场景中光线投射的抽象基类
AbstractTexture	用于提供纹理的基类
AbstractTextureImage	封装了创建 OpenGL 纹理图像的必要信息
AlphaCoverage	启用阿尔法覆盖多重采样模式
AlphaTest	指定 alpha 参考测试
BlendEquation	指定用于 RGB 混合方程和 Alpha 混合方程的等式
BlendEquationArguments	封装混合信息：指定输入值（将要绘制的内容）如何影响现有值（已绘制的内容）
BlitFramebuffer	FrameGraph 节点用于将像素值矩形从渲染目标的一个区域传输到另一个区域
BufferCapture	在 GPU 和 CPU 之间交换缓冲区数据
Camera	定义一个视点，通过该视点渲染场景
CameraLens	提供投影矩阵，用于为 3D 场景定义摄像机
CameraSelector	允许选择要使用的摄像机的类
ClearBuffers	清除缓冲区的类
ClipPlane	使用 gl_ClipDistance 在着色器中启用额外的 OpenGL 裁剪平面
ColorMask	允许指定哪些颜色组件应写入当前绑定的帧缓冲区
ComputeCommand	为 GPU 上的计算着色器发布工作的组件
CullFace	指定启用了正面还是背面剔除的类型
DebugOverlay	启用场景细节视觉叠加
DepthRange	启用重映射写入深度缓冲区的深度值
DepthTest	根据写入样本的深度测试片段着色器的深度值
DirectionalLight	在Qt 3D 场景中封装定向光对象
DispatchCompute	为 GPU 上的计算着色器发布工作的 FrameGraph 节点
Dithering	启用抖动
Effect	Qt 3D 场景中特效的基类
EnvironmentLight	在Qt 3D 场景中封装环境光对象
FilterKey	存储滤镜键及其值
FrameGraphNode	所有 FrameGraph 配置节点的基类
FrontFace	定义前后多边形的类型
FrustumCulling	启用 FrameGraph 的挫边剔除功能
GeometryRenderer	封装几何图形渲染
GraphicsApiFilter	对于 OpenGL，确定附加技术所需的 API
Layer	筛选要渲染的实体的方法
LayerFilter	控制在框架图形分支中绘制的图层
LevelOfDetail	根据实体在屏幕上的大小控制渲染实体复杂度的方法
LevelOfDetailLoader	根据与摄像机的距离或屏幕尺寸而改变的实体加载器
LevelOfDetailSwitch	提供一种根据距离或屏幕尺寸启用子实体的方法
Light	在Qt 3D 场景中封装 QAbstractLight 对象
LineWidth	指定光栅化线条的宽度
Material	不可创建的材质抽象基础
MemoryBarrier	用于设置内存障碍的类
Mesh	自定义网格加载器
MultiSampleAntiAliasing	启用多采样抗锯齿
NoDepthMask	禁用深度写入
NoDraw	当 FrameGraph 分支中存在 NoDraw（不绘制）节点时，渲染器将无法渲染任何基元。
NoPicking	当 FrameGraph 分支中出现 NoPicking 节点时，这将阻止渲染器对给定分支执行拾取选择。
ObjectPicker	实例化一个组件，该组件可用于通过称为 "挑选 "的过程与实体进行交互
Parameter	为名称和值对提供存储空间。这将映射到着色器统一
PickEvent	在选取对象时保存信息。当拾取成功时，大部分 QObjectPicker 组件信号都会将此作为参数接收
PickLineEvent	拾取线段时保存信息
PickPointEvent	选取点云的一段时保存信息
PickTriangleEvent	选取三角形时保存信息
PickingProxy	可用于提供仅用于拾取的替代几何视图
PickingSettings	指定如何处理实体拾取
PointLight	在Qt 3D 场景中封装点光源对象
PointSize	指定光栅化点的大小。可静态设置或由着色器程序设置
PolygonOffset	类型设置比例和步骤，以计算多边形偏移的深度值
ProximityFilter	选择目标实体距离阈值内的实体
RasterMode	渲染状态允许控制要执行的光栅化类型
RayCaster	用于在三维世界坐标中执行光线投射测试
RenderCapabilities	QRenderCapabilities 类保存与可用渲染引擎相关的设置
RenderCapture	捕捉渲染
RenderCaptureReply	接收渲染捕捉结果
RenderPass	封装一个渲染通道
RenderPassFilter	为滤镜键和参数向量提供存储空间
RenderSettings	该类保存与渲染过程相关的设置，并托管活动帧图
RenderState	所有渲染状态的抽象基础类型
RenderStateSet	FrameGraph 节点提供了一种指定渲染状态对象集的方法，以便在执行帧图分支时应用该对象集
RenderSurfaceSelector	提供一种指定渲染表面的方法
RenderTarget	封装一个目标（通常是一个帧缓冲区对象），渲染器可将其渲染到该目标中
RenderTargetOutput	通过该类型可指定渲染目标的附件（无论是色彩纹理还是深度纹理......）。
RenderTargetSelector	提供指定渲染目标的方法
SceneLoader	提供加载现有场景的功能
ScissorTest	可丢弃超出屏幕特定矩形范围的片段
ScreenRayCaster	根据屏幕坐标进行光线投射测试
SeamlessCubemap	启用无缝立方体贴图纹理过滤
ShaderImage	提供对着色器程序的图像访问
ShaderProgram	封装着色器程序
ShaderProgramBuilder	从加载的图形中生成着色器程序内容
SharedGLTexture	允许在Qt 3D 场景中使用来自单独 OpenGL 上下文的纹理 ID
SortPolicy	为要使用的排序类型提供存储空间
SpotLight	在Qt 3D 场景中封装聚光灯对象
StencilMask	类型可控制模版平面中各个位的前后写入
StencilOperation	类型指定钢网操作
StencilOperationArguments	类型设置钢网和深度测试失败时要采取的操作
StencilTest	类型指定钢网测试的参数
StencilTestArguments	类型指定钢网测试的参数
SubtreeEnabler	启用或禁用帧图节点的整个子树
Technique	封装技术
TechniqueFilter	用于选择所用技术的框架图节点
Texture1D	目标格式为 Target1D 的抽象纹理
Texture1DArray	目标格式为 Target1DArray 的抽象纹理
Texture2D	目标格式为 Target2D 的抽象纹理
Texture2DArray	目标格式为 Target2DArray 的抽象纹理
Texture2DMultisample	目标格式为 Target2DMultisample 的抽象纹理
Texture2DMultisampleArray	目标格式为 Target2DMultisampleArray 的抽象纹理
Texture3D	目标格式为 Target3D 的抽象纹理
TextureBuffer	目标格式为 TargetBuffer 的抽象纹理
TextureCubeMap	目标格式为 TargetCubeMap 的抽象纹理
TextureCubeMapArray	目标格式为 TargetCubeMapArray 的抽象纹理
TextureImage	封装从图像源创建 OpenGL 纹理图像的必要信息
TextureLoader	处理纹理加载和纹理属性设置
TextureRectangle	目标格式为 TargetRectangle 的抽象纹理
Viewport	Qt3D 场景上的视口
levelOfDetailBoundingSphere	QML 类型提供了一个简单的球形体积，由其中心和半径定义

Qt 3D 额外模块

ConeGeometry	允许在三维空间中创建圆锥体
ConeGeometryView	锥形网格
ConeMesh	锥形网格
CuboidGeometry	允许在三维空间中创建一个长方体
CuboidGeometryView	一个长方体网格
CuboidMesh	一个长方体网格
CylinderGeometry	允许在三维空间中创建一个圆柱体
CylinderGeometryView	圆柱网格
CylinderMesh	一个圆柱形网格
DiffuseSpecularMaterial	默认的 phong 灯光效果
ExtrudedTextGeometry	允许在三维空间中创建三维文本
ExtrudedTextMesh	三维挤出文字网格
FirstPersonCameraController	允许从第一人称视角控制场景摄像机
ForwardRenderer	前向渲染器的默认 FrameGraph 实现
GoochMaterial	实现 Gooch 阴影模型的材质，在 CAD 和 CAM 应用程序中非常流行
MetalRoughMaterial	该材质采用单次渲染通过的效果方法，并对每个片段进行照明。为 OpenGL 3 和 OpenGL ES 3 提供了各种技术
OrbitCameraController	允许沿轨道路径控制场景摄像机
PerVertexColorMaterial	默认实现为每个顶点设置的颜色属性渲染
PlaneGeometry	允许在三维空间中创建平面
PlaneGeometryView	正方形平面网格
PlaneMesh	正方形平面网格
SkyboxEntity	可用于在三维场景中插入天空盒的便利实体子类
SphereGeometry	允许在三维空间中创建一个球体
SphereGeometryView	球形网格
SphereMesh	球形网格
Text2DEntity	允许在三维空间中创建二维文本
TorusGeometry	允许在三维空间中创建环形网格
TorusGeometryView	环形网格
TorusMesh	环形网格

Qt 3D 动画模块

AbstractAnimation	Qt3D 动画的抽象基类
AbstractClipAnimator	提供动画播放功能的基类
AbstractClipBlendNode	用于构建动画混合树的基类
AdditiveClipBlend	根据加法因子对两个动画片段执行加法混合
AnimationController	动画控制器类型
AnimationGroup	动画分组类型
BlendedClipAnimator	为混合节点树提供动画播放功能的组件
ClipAnimator	提供简单动画播放功能的组件
ClipBlendValue	用于在混合树中包含剪辑的类型
KeyframeAnimation	为变形执行简单关键帧动画的类型
LerpClipBlend	根据归一化因子对两个动画片段执行线性插值
MorphTarget	为混合形状动画提供变形目标的类型
MorphingAnimation	实现混合形状变形动画的类型
VertexBlendAnimation	实现顶点混合变形动画的类型

Qt 3D 场景 2D 模块

Scene2D

该类型可将 qml 渲染成纹理，然后用作三维场景的一部分

Qt 3D Scene3D 模块

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