Version: 5.6
支持 DX11/OpenGL Core 曲面细分的表面着色器
顶点和片元着色器示例

编写顶点和片元着色器

ShaderLab 着色器不止包含“硬件着色器”。它们执行很多操作。它们描述了在材质检视面板中显示的属性,包含用于不同图形硬件的多个着色器实现,配置固定函数硬件状态,等等。实际的可编程着色器(如顶点和片元程序)只是整个 ShaderLab 的“着色器”概念的一部分。有关基本介绍,请查看着色器教程。在本文中,我们将低级别硬件着色器称为__着色器程序__。

如果要编写与光照交互的着色器,请查看表面着色器文档。如需查看一些示例,请参阅顶点和片元着色器示例。本页的其余部分假设着色器不与 Unity 光源(例如特殊效果、后期处理效果等等)交互。

着色器程序用 HLSL 语言编写,在着色器文本中嵌入“代码片段”(在 Pass 命令中的某个位置)。着色器程序通常如下所示:

  Pass {
        // ...常规通道状态设置 ...
      
        CGPROGRAM
        // 此代码片段的编译指令,例如:
        #pragma vertex vert
        #pragma fragment frag
      
        // Cg/HLSL 代码本身
      
        ENDCG
        // ...通道设置的剩余部分 ...
    }

HLSL 代码片段

HLSL program snippets are written between CGPROGRAM and ENDCG keywords, or alternatively between HLSPROGRAM and ENDHLSL. The latter form does not automatically include HLSLSupport and UnityShaderVariables built-in header files.

在代码片段的开头,可使用 #pragma 语句的形式提供编译指令。以下指令可指示要编译的着色器函数:

  • #pragma vertex name - 作为顶点着色器来编译函数 name
  • #pragma fragment name - 作为片元着色器来编译函数 name
  • #pragma geometry name - 作为 DX10 几何着色器来编译函数 name。如下所述,设置此选项会自动开启 #pragma target 4.0
  • #pragma hull name - 作为 DX11 外壳着色器来编译函数 name。如下所述,设置此选项会自动开启 #pragma target 5.0
  • #pragma domain name - 作为 DX11 域着色器来编译函数 name。如下所述,设置此选项会自动开启 #pragma target 5.0

其他编译指令:

  • #pragma target name - 要编译到的着色器目标。有关详细信息,请参阅着色器编译目标页面。
  • #pragma only_renderers 空格分隔的名称 - 仅为给定的渲染器编译着色器。默认情况下,将为所有渲染器编译着色器。请参阅下文中的_渲染器_以了解详细信息。
  • #pragma exclude_renderers 空格分隔的名称 - 不为给定渲染器编译着色器。默认情况下,将为所有渲染器编译着色器。请参阅下文中的_渲染器_以了解详细信息。
  • #pragma multi_compile … - 用于处理多个着色器变体
  • #pragma enable_d3d11_debug_symbols - 为针对 DirectX 11 编译的着色器生成调试信息,这将允许您通过 Visual Studio 2012(或更高版本)图形调试器来调试着色器。
  • #pragma hardware_tier_variants 渲染器名称 - 为每个可以运行所选渲染器的硬件层生成每个编译着色器的多个着色器硬件变体。请参阅下文中的_渲染器_以了解详细信息。

每个代码片段必须至少包含一个顶点程序和一个片元程序。因此,#pragma vertex#pragma fragment 指令是必需的。

从 Unity 5.0 开始不执行任何操作并且可以安全删除的编译指令:#pragma glsl#pragma glsl_no_auto_normalization#pragma profileoption#pragma fragmentoption

渲染平台

Unity supports several rendering APIs (e.g. Direct3D 9 and OpenGL), and by default all shader programs are compiled into all supported renderers. You can indicate which renderers to compile to using #pragma only_renderers or #pragma exclude_renderers directives. This is mostly useful in cases where you are explicitly using some shader language features that you know aren’t possible on some platforms. Supported renderer names are:

  • d3d9 - Direct3D 9
  • d3d11 - Direct3D 11/12
  • glcore - OpenGL 3.x/4.x
  • gles - OpenGL ES 2.0
  • gles3 - OpenGL ES 3.x
  • metal - iOS/Mac Metal
  • vulkan - Vulkan
  • d3d11_9x - Direct3D 11 9.x 功能级别,通常在 WSA 平台上使用
  • xboxone - Xbox One
  • ps4 - PlayStation 4
  • psp2 - PlayStation Vita
  • n3ds - Nintendo 3DS
  • wiiu - Nintendo Wii U

For example, this line would only compile shader into D3D9 mode:

#pragma only_renderers d3d9

另请参阅

支持 DX11/OpenGL Core 曲面细分的表面着色器
顶点和片元着色器示例