自定义材质编辑器

材质编辑器工具

材质编辑器工具是一个 GUI 工具，通过提供实时材质预览、语法高亮、错误报告以及将材质导出为 QML 组件的功能，简化了为 QtQuick3D 创建自定义材质的过程。

使用方法

可以通过运行以下命令启动材质编辑器

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

材质编辑器窗口由两个主要组件组成，左侧是编辑器，右侧是预览区域。

着色器编辑

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

编写自定义材质的着色器片段使用的语言是 Vulkan风格的GLSL，它包含一些针对 QtQuick3D 的特定关键词，这些关键词全部用大写字母编写。编辑器也会突出显示 QtQuick3D 特定的关键词。

有关着色器片段使用的语言以及它们如何与渲染管线其他部分的交互的更详细概述，请参阅可编程材质文档。

材质属性

材质属性部分包含材质的常见 QML 属性。这些属性及其对材质的影响在“自定义材质”文档中有更详细的描述。

预览

除了显示当前材质的渲染效果外，预览面板还包含一些可以调整以查看在不同条件下材质外观的控件。这些控件允许用户进行以下操作：选择不同的模型、切换使用基于图像的光照、打开或关闭场景光照，并调整环境的旋转。还可以使用鼠标进行环绕模型。

统一量

统一表是列出着色器所使用的制服的地方。制服可以随时添加、删除或更改，但所有着色器片段使用的手套都需要添加到统一表格中。一旦添加了制服，它将同时对两个着色器可访问。当将材料导出为 QML 组件时，制服将成为材料组件的属性。

输出面板

输出面板显示诊断消息，例如，在着色器片段中找到的错误。

导入着色器

着色器片段可以导入到应用程序中，这些文件具有扩展名 .vert 和 .frag，并且预期包含纯文本。如果着色器代码不是在与其他 CustomMaterial 兼容的语言或形式中（工具不尝试翻译），则导入的着色器片段当然需要手动修改。

保存和加载项目

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

导出

为了使材料可以从应用程序中使用，它需要导出为 QML 组件，这可以通过从应用程序菜单中打开导出对话框来完成。导出对话框将要求输入输出文件夹，材料组件的名称以及着色器片段的名称。当材料成功导出后，输出文件夹将包含描述材料的 QML 组件以及所需的所有着色器片段和纹理。