Qt 3D Extras C++ Classes

Qt 3D Extras 模块提供了一组预构建元素，可帮助您开始使用Qt 3D 。更多

自 6.8 起，该模块已被弃用。我们强烈建议不要在新代码中使用该模块。

命名空间

包含 Qt3DExtras 模块中的类

类

Qt3DExtras::QAbstractCameraController	相机控制器的基本功能
Qt3DExtras::QConeGeometry	允许在三维空间中创建锥形
Qt3DExtras::QConeGeometryView	锥形网格
Qt3DExtras::QConeMesh	锥形网格
Qt3DExtras::QCuboidGeometry	允许在三维空间中创建一个长方体
Qt3DExtras::QCuboidGeometryView	一个长方体网格
Qt3DExtras::QCuboidMesh	一个长方体网格
Qt3DExtras::QCylinderGeometry	允许在三维空间中创建一个圆柱体
Qt3DExtras::QCylinderGeometryView	圆柱网格
Qt3DExtras::QCylinderMesh	一个圆柱形网格
Qt3DExtras::QDiffuseSpecularMaterial	默认的 phong 灯光效果
Qt3DExtras::QExtrudedTextGeometry	允许在三维空间中创建三维挤出文本
Qt3DExtras::QExtrudedTextMesh	三维挤出文字网格
Qt3DExtras::QFirstPersonCameraController	允许从第一人称视角控制场景摄像机
Qt3DExtras::QForwardRenderer	前向渲染器的默认 FrameGraph 实现
Qt3DExtras::QGoochMaterial	实现 Gooch 阴影模型的材质，该模型在 CAD 和 CAM 应用程序中非常流行
Qt3DExtras::QMetalRoughMaterial	PBR 照明的默认实现
Qt3DExtras::QMorphPhongMaterial	默认实现 phong 灯光效果
Qt3DExtras::QOrbitCameraController	允许沿轨道路径控制场景摄像机
Qt3DExtras::QPerVertexColorMaterial	为每个顶点设置颜色属性的默认渲染方式
Qt3DExtras::QPlaneGeometry	允许在三维空间中创建平面
Qt3DExtras::QPlaneGeometryView	正方形平面网格
Qt3DExtras::QPlaneMesh	正方形平面网格
Qt3DExtras::QSkyboxEntity	Qt3DExtras::QSkyboxEntity 是一个方便的 Qt3DCore::QEntity 子类，可用于在 3D 场景中插入天空盒。
Qt3DExtras::QSphereGeometry	允许在三维空间中创建球体
Qt3DExtras::QSphereGeometryView	球形网格
Qt3DExtras::QSphereMesh	球形网格
Qt3DExtras::QText2DEntity	允许在三维空间中创建二维文本
Qt3DExtras::QTextureMaterial	默认实现的简单无光纹理材质
Qt3DExtras::QTorusGeometry	允许在三维空间中创建环形网格
Qt3DExtras::QTorusGeometryView	环形网格
Qt3DExtras::QTorusMesh	环形网格

详细说明

本模块仍在开发中，但可作为技术预览版使用。这意味着它是不稳定的，有可能发生变化，并且仅作为一种便利提供。

#include <Qt3DExtras>

要与相应的 C++ 库链接，请在您的 qmake 项目文件中添加以下内容：

QT += 3dextras

类、类型和函数在Qt3DExtras 命名空间下声明。

概述

材料

Qt3DExtras::QDiffuseSpecularMaterial	phong 灯光效果的默认实现
Qt3DExtras::QGoochMaterial	实现 Gooch 阴影模型的材质，在 CAD 和 CAM 应用程序中很受欢迎
Qt3DExtras::QMetalRoughMaterial	PBR 照明的默认实现
Qt3DExtras::QMorphPhongMaterial	默认实现 phong 灯光效果
Qt3DExtras::QPerVertexColorMaterial	为每个顶点设置的颜色属性的默认渲染实现
Qt3DExtras::QTextureMaterial	简单无光照纹理材质的默认实现

网格和几何图形

Qt3DExtras::QConeGeometry	允许在三维空间中创建圆锥体
Qt3DExtras::QConeGeometryView	锥形网格
Qt3DExtras::QConeMesh	锥形网格
Qt3DExtras::QCuboidGeometry	允许在三维空间中创建一个长方体
Qt3DExtras::QCuboidGeometryView	一个长方体网格
Qt3DExtras::QCuboidMesh	一个长方体网格
Qt3DExtras::QCylinderGeometry	允许在三维空间中创建一个圆柱体
Qt3DExtras::QCylinderGeometryView	圆柱网格
Qt3DExtras::QCylinderMesh	一个圆柱形网格
Qt3DExtras::QPlaneGeometry	允许在三维空间中创建平面
Qt3DExtras::QPlaneGeometryView	正方形平面网格
Qt3DExtras::QPlaneMesh	正方形平面网格
Qt3DExtras::QSphereGeometry	允许在三维空间中创建球面
Qt3DExtras::QSphereGeometryView	球形网格
Qt3DExtras::QSphereMesh	球形网格
Qt3DExtras::QTorusGeometry	可在三维空间中创建环形网格
Qt3DExtras::QTorusGeometryView	环形网格
Qt3DExtras::QTorusMesh	环形网格

摄像机控制器

Qt3DExtras::QFirstPersonCameraController	可从第一人称视角控制场景摄像机
Qt3DExtras::QOrbitCameraController	允许沿轨道路径控制场景摄像机

实体

Qt3DExtras::QSkyboxEntity

框架图

Qt3DExtras::QForwardRenderer

窗口

Qt3DExtras::Qt3DWindow

注： Quick3DExtras 模块还指定了一个 Qt3DExtras::Quick::Qt3DQuickWindow。

参考

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