自定义材质编辑器

材质编辑器工具

QtQuick3D 材质编辑器工具是一种图形用户界面工具,通过提供材质的实时预览、语法高亮显示、错误报告以及将材质导出到CustomMaterial QML 组件的功能,使CustomMaterials 的创作变得更加容易。

使用方法

材料编辑器可通过运行命令启动:

$(QTDIR)/bin/materialeditor[.exe]

材质编辑器窗口由两个主要部分组成,左侧为编辑器,右侧为预览。

着色器编辑

编辑器视图中有两个编辑器,一个用于顶点着色器,另一个用于片段着色器。编辑着色器片段时,更改结果将立即显示在预览中。如果无法装配材质,则会在输出面板中显示描述问题的信息。

用于编写CustomMaterial 着色器片段的语言是 Vulkan 风格的 GLSL,其中还包含一些QtQuick3D 专用的附加关键字,这些关键字以全部大写字母书写,非常容易识别。编辑器也会高亮显示QtQuick3D 的特定关键字。

有关着色器片段所用语言的更详细概述,以及着色器片段与渲染管道其他部分的交互方式, 请参阅可编程材质文档。

材质属性

材质属性 "部分包含材质的常用 QML 属性。这些属性以及它们如何影响材质,详见CustomMaterial 文档。

预览

除了显示当前材质的渲染效果外,预览面板还包含一系列可调整的控件,以查看材质在不同条件下的外观。用户可以通过这些控件选择不同的模型、切换使用基于图像的照明打开关闭场景光以及调整环境的旋转。还可以使用鼠标围绕模型旋转。

制服

统一表中列出了着色器使用的统一。可以随时添加、删除或更改制服,但着色器片段使用的所有制服都需要添加到制服表中。一旦添加了制服,两个着色器都可以访问该制服。将材质导出到 QML 组件时,制服将成为材质组件的属性。

输出面板

输出面板显示诊断信息,例如在着色器片段中发现的错误。

导入着色器

着色器片段可导入到应用程序中,这些文件的扩展名为.vert.frag ,预计将包含纯文本。当然,如果着色器代码的语言或形式与CustomMaterial 不兼容,则需要手动调整导入的着色器片段(工具不会尝试翻译)。

保存和加载项目

材质编辑器可以使用自己的项目格式保存或加载项目文件。材料编辑器项目文件的扩展名为.qmp

注意: "材质编辑器 "的项目文件格式并非用于运行时使用,而是仅供 "材质编辑器 "使用。

导出。

要在应用程序中使用材质,需要将其导出为 QML 组件,可以从应用程序菜单中打开导出对话框。导出对话框会要求输入输出文件夹、材质组件名称和着色器片段名称。成功导出材质后,输出文件夹将包含一个描述材质的 QML 组件,以及材质所需的着色器片段和纹理。

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