统一的Unigine着色器语言

The Unified UNIGINE shader language (UUSL) is a wrapper, which wraps HLSL syntax and uses custom parsers for #ifdef constructs. You can use the UUSL instructions to write shader code without graphic API defining: it will work on all APIs.统一UNIGINE着色器语言(UUSL)是一个包装器，它包装HLSL语法并为#ifdef构造使用自定义解析器。您可以使用UUSL指令来编写着色器代码，而无需定义图形API：它将在所有API上都可以使用。

Definitely not. UUSL is just a wrapper which facilitates the shader-writing process. You can also use an old-school approach by writing separately part of the shader for corresponding graphic API with HLSL and PS5's shading languages.绝对不是。 UUSL只是一个有助于着色器编写过程的包装器。您也可以使用老式的方法，分别使用 HLSL 和 PS5 的着色语言为相应的图形API编写着色器的一部分。

Unigine engine has the standard shaders pipeline: Vertex-Shader stage → Geometry-Shader stage → Fragment-Shader stage. If you want to use tessellation, the pipeline will have 3 additional stages between vertex-shader and geometry-shader stages: Control-Shader stage, tessellation stage, Evaluation-Shader stage. Unigine引擎具有标准的着色器管道： Vertex-Shader阶段→ Geometry-Shader阶段→ Fragment-Shader阶段。如果要使用细分，则管线在顶点着色器阶段和几何着色器阶段之间还有3个附加阶段： Control-Shader阶段，镶嵌细分阶段，评估-着色器阶段。

Material specifies which shaders for defined rendering pass it will use to render. You can define vertex, geometry and fragment shaders for a material. When you assign the material, the engine starts using its shaders to render the image. A piece of cake! 材质指定将用于渲染定义的 rendering pass 的着色器。您可以为材质定义顶点，几何和片段着色器。分配材质时，引擎将开始使用其着色器来渲染图像。一块蛋糕！

注意

Vertex and fragment shaders are mandatory for a material.材质必须使用顶点着色器和片段着色器。

We have a neat article about the materials files formats, check it out.我们有一篇关于 materials文件格式的简洁文章，请查看。

When you start writing shaders, include the UUSL headers and start coding!开始编写着色器时，请包含UUSL标头并开始编码！

Use the following commands to include the necessary headers:使用以下命令包括必要的标题：

// Include Unified Unigine Shader Language (UUSL) common header
#include <core/materials/shaders/api/common.h>

Yes, they do. But the engine does the job: just use the materials_reload console command if you made some changes in shader files. It is really handy: you don't need to compile the shader every time you made any changes, you see the result of the changes in runtime without engine restart!是的，他们这样做。但是引擎可以完成工作：如果对着色器文件进行了一些更改，只需使用 materials_reload 控制台命令。这真的很方便：您不需要每次进行任何更改都编译着色器，无需运行引擎即可看到运行时的更改结果！

注意

If you made changes in the material .mat file, you should reload the engine.如果您在材质.mat文件中进行了更改，则应重新加载引擎。

Sure. If there is a shader error, the engine shows it in the console: 当然。如果存在着色器错误，引擎会在控制台中显示该错误：

The message contains information about which file has errors and their description (including the number of line).该消息包含有关哪个文件有错误及其描述（包括行数）的信息。

Export the shader file to the file and find this code line to figure out what's happen. Shader will be exported in a file with the graphic API shader format (.hlsl) located relatively to the data folder. 将着色器文件导出到该文件，并找到此代码行以了解发生了什么。着色器将导出为相对于data文件夹具有图形API着色器格式（.hlsl）的文件。

您可以使用相应主题的教程来了解如何为它们创建材质和着色器：

• Creating of Custom Shader for Post-Processing 创建自定义着色器以进行后处理。
• Abstract material — Mesh抽象材质 — Mesh
• Abstract material — Decal抽象材质 — Decal