Shader山下（二十）编译指令（Compilation Directives）

最新推荐文章于 2020-11-21 01:27:35 发布
最新推荐文章于 2020-11-21 01:27:35 发布
阅读量4.3k 收藏 7
点赞数 1
CC 4.0 BY-SA版权
分类专栏： Shader Shader山下 文章标签： Shader compile directive 编译 指令
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/ecidevilin/article/details/52879485
本文探讨Shader中的编译指令，包括顶点片元着色器和表面着色器的使用。编译指令通过#pragma语句在CGPROGRAM和ENDCG之间指定，VF编译指令置于Pass内，表面着色器指令则在SubShader内，并使用#pragma surface指令定义，该指令可配置多种选项。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

Shader中，编译指令分为两种，一种是常规的编译指令，也就是顶点片元着色器（Vetex & Fragment Shader）使用的编译指令，另一种就是表面着色器（Surface Shader）使用的编译指令。二者都使用#pragma语句来编写，并且都需要写在CGPROGRAM和ENDCG之间。区别在于，VF编译指令写在Pass里面，而表面着色器编译指令写在SubShader里面，表面着色器会自行编译到多通道里去，并且需要使用#pragma surface …指令来标识这是一个表面着色器。


VF编译指令：

#pragma vertex name 编译name函数为顶点着色器
#pragma fragment name 编译name函数为片元着色器
#pragma geometry name 编译name函数为DX10的几何着色器
注：会自动开启#pragma target 4.0
#pragma hull name 编译name函数为DX10的壳着色器
注：会自动开启#pragma target 5.0
#pragma domain name 编译name函数为DX10的域着色器
注：会自动开启#pragma target 5.0
#pragma target name 表明编译目标
参考着色器编译目标等级
#pragma only_renderers space_separated_names 只为指定的渲染平台渲染着色器
包括下列值：
d3d9:Direct3D 9
d3d11:Direct3D 11/12
glcore:OpenGL 3.x/4.x
gles:OpenGL ES 2.0
gles:OpenGL ES 3.x
metal:IOS&Mac Metal
d3d11_9x:Direct3D 11 9.x特性等级一般用于WSA平台
xbox360:Xbox 360
xboxone:Xbox One
ps4:PlayStation 4
psp2:PlayStation Vita
n3ds:Nintendo 3DS
wiiu:Nintendo Wii U
#pragma exclude_renderers space_separated_name
最低0.47元/天 解锁文章

200万优质内容无限畅学
Shader的真正编译过程
虚幻4引擎工作室
06-07 3749
文件路径： \Engine_Updating\Engine\Source\Runtime\Engine\Private\Materials\MaterialShared.cpp /** * Compiles this material for Platform, storing the result in OutShaderMap * * @param ShaderMapId -
编译shader
wwhx27的博客
08-19 646
编译shader 编译shader 根据shader的种类，来创建一个shader的对象 获取shader对应的代码 用显卡驱动编译shader 编译错误的处理 GLuint CompileShader(GLenum shaderType, const char* shaderCode) { GLuint shader = glCreateShader(shaderType);//根据...
代码编译【OpenGL】Shader概述代码编译
weixin_34302798的博客
04-21 292
文章结束给大家来个程序员笑话：[M]     这篇文章述讲了Shader是如何编译和链接，终最在OpenGL程序中应用的。当然，不解了这些我们仍然可以畸形作工，但是作为初学者，解了这些会让我更能明确自己在嘛干。。。      综述     哈，鼎鼎名大的Shader终究让我给见到了……之前在习学Unity3D的时候就被群里的大牛耳闻目睹说Shader如何如何要重，在现终究轮到自己领教了。吐...
SHADER的动态组合
萧戈的专栏
12-11 445
　Shader是很奇怪的代码,它的长度受到限制,它的动态分支能力很弱,它的指令很昂贵,这些都使得你很难使用一个单一的Shader来处理所有的渲染要求.而各种渲染要求的种类如此之多,如果要为每一种渲染类型都写一段专一的代码的话,那会是一件非常吃力的活,假设我们现在要写一个材质系统,我们希望它能够支持各种效果.你会发现随着支持的效果越来越多,需要写的Shader的数量会急剧上升,比如: 　　*.一开...
Unity Shader：细分着色器(Tessellation Shader)在Unity顶点着色器中的写法以及各参数变量解释
热门推荐
liu_if_else的博客
07-12 1万+
（上图：将sphere与quad进行细分后）Unity官网关于细分着色器的资料比较少，只有在Surface Shader中使用的例子。我看了下Surface Shader的generated code，总结出如何在顶点与片段着色器中写hull shader和domain shader并实现基本的Tessellation细分功能。首先看一下Unity Shader的4个可编程着色器的执行顺序：
Java 条件编译 Conditional Compilation
01-20
根据Java编译器的优化的机制，Java也能够提供条件编译。对于条件设为false的语句，编译器将不对条件覆盖的代码段生成字节码。 　不仅可以用简单的boolean常量值来做条件编译，还可以用字符串常量及任何其他类型的...
分步编译 separate compilation
12-25
单独编译单个C++文件的流程包括：首先，使用预处理器指令包含头文件。例如，Date.cpp文件包含iostream头文件以支持输入输出操作。然后定义类Date，其中包含一个公有成员year。在main函数中，创建了Date类的对象d1，...
c语言条件编译指令用法
02-27
最后，条件式编译（Conditional Compilation）利用`#if`、`#elif`、`#else`和`#endif`指令，使得编译器根据预定义的宏或表达式的结果来决定编译哪些代码。这与运行时的`if`语句不同，条件式编译发生在编译阶段。例如...
Shader山下（二十一）多重变体（Multiple Variants）
凯奥斯的注释
10-21 6271
Shader山下（二十）编译指令（Compilation Directives）介绍了如何使用编译指令，本文就专文介绍一下多重编译（multi_compile）指令。 我们可以使用multi_compile来为shader创建多个稍微有点区别的shader变体。这个Shader被称为宏着色器（mega shader）或者超着色器（uber shader）。实现原理：根据不同的情况，使用不同的预处理器指令，来多次编译Shader代码。
计算共形几何 pdf_几何着色器
weixin_39628271的博客
11-21 316
几何着色器概述 (Introduction)PDF下载地址传送positiveczp.github.io(positiveczp.github.io/%25E5%2587%25A0%25E4%25BD%2595%25E7%259D%2580%25E8%2589%25B2%25E5%2599%25A8.pdf)渲染管线几何着色器(Geometry Shader)是由第四代显卡着色器架构 S...
#pragma详细解释
驱动开发
05-22 5063
在#Pragma是预处理指令它的作用是设定编译器的状态或者是指示编译器完成一些特定的动作。#pragma指令对每个编译器给出了一个方法,在保持与C和C ++语言完全兼容的情况下,给出主机或操作系统专有的特征。依据定义,编译指示是机器或操作系统专有的,且对于每个编译器都是不同的。其格式一般为: #Pragma Para其中Para 为参数，下面来看一些常用的参数。(1)message 参数。 Mes
Unity中Shader学习笔记
Diviner的博客
06-06 537
1、Shader 中 Properties 属性： Numbers and Sliders name ("display name", 2D) = "defaulttexture" {} name ("display name", Cube) = "defaulttexture" {} name ("display name", 3D) = "defaulttexture" {} C
跨平台shader 编译
颇锐克
04-06 3448
（本文根据我博客上的文章跨平台shader编译的过去、现在和未来改写。知乎编辑器不支持多个级别的标题，以至于我只能用加粗不加粗来区分了。。。） 很多跨平台游戏引擎都有统一shader的需求。比如KlayGE从建立伊始，就强调一份代码跨多个平台，shader代码也不例外。如果需要对不同平台都分别写一遍shader，那样的工作量和可维护性都很糟糕。 既然有这样的需求，就必然会在技术上遇到一个问
Surface Shader学习笔记
学无止境
06-09 1611
表面着色器的实质就是在顶点、片元着色器上的一层抽象封装，unity自动在背后帮我们处理渲染路径，使用的光源模型等。但能用表面着色器实现的shader顶点片元着色器都能实现，反之不成立。https://docs.unity3d.com/Manual/SL-SurfaceShaders.html表面着色器的代码必须包含在Subshader中，表面着色器不存在Pass因为着色代码在多通道中编译然后自动生...
Unity Shader - Writing Surface Shaders 编写表面着色器
Jave.Lin 的学习笔记
06-13 828
目录：Unity Shader - 知识点目录（先占位，后续持续更新） 原文：Writing Surface Shaders 版本：2019.1 Writing Surface Shaders 编写表面着色器 编写与光照有交互的shader是复杂的。有许多不同的光源类型，不同的阴影选项，不同的rendering paths（渲染路径）（forward（正向渲染）和deferred renderin...
Unity5.x Surface Shader使用alpha blend
sunny__chen的博客
02-15 3778
#pragma surface surfaceFunction lightModel [optionalparams] 在Unity4.x中的Surface Shader，只要加上Blend SrcAlpha OneMinusSrcAlpha即可实现alpha blend的效果。 而在Unity5.x中，必须在#pragma中加上alhpa:blend或alpha:fade等才可实现效果。
Unity Shader 实现X光效果
类人_猿的博客
07-30 2914
Unity Shader 实现实物遮挡外轮廓发光效果 之前看过《火炬之光》、《黎明杀机》、《第五人格》等不少的游戏里面人物被建筑物遮挡呈现出不同的效果，在这里我们就叫他X-Ray效果，也可以叫透视效果。 第五人格： 黎明杀机： 火炬之光： 实现方案： 1.采用Amplify Shader Editor1.6.1 2.Fresnel Node 利用光到达具有不同折射率的两种材质之前的界面时的行...
Unity3D Shader加载时机和预编译
qq_14939027的博客
10-07 6512
http://www.manew.com/thread-91349-1-1.html 一、Shader与Shader Variants        着色器(Shader)是在GPU上执行的小程序，通常情况下，我们自己写的一个着色器文件(xxx.shader)对应一个着色器变体，对应一个GPU程序。但如果着色器中引入了关键字(Keyword)或者可变的RenderSetup等技术，那么一个
Shader常用函数属性
盖子的博客
03-19 3159
Properties属性支持类型 属性类型 默认值的定义语法 例子 Int number _Int(“Int”,Int)=2 Float number _Float(“Float”,Float)=1.5 Range(min,max) number _Range(“Range”,Range(0.0,5.0))=3.0 Color (number,number,number...
Unity Shader HLSL 禁用编译优化(DXBC)
最新发布
07-14
<think>我们正在处理一个关于Unity Shader HLSL禁用DXBC编译优化的技术问题。 根据用户的问题，我们需要在Unity Shader中使用HLSL时禁用DXBC编译优化。 首先，我们需要了解DXBC是什么：DXBC是DirectX Bytecode的缩写，它是HLSL编译后的中间字节码。 在Unity中，当使用HLSL编写Shader时，Unity会调用D3DCompiler将HLSL编译为DXBC，然后由显卡驱动进一步编译为机器码。 禁用编译优化通常是为了调试目的，因为优化可能会改变代码的结构，使得调试困难。在DirectX中，我们可以使用编译选项来控制优化级别。 在Unity中，我们可以通过特定的编译指示（pragma）来传递编译选项给D3DCompiler。 具体到禁用优化，我们可以使用以下编译指示： #pragma disable_dxc 但是，请注意，Unity支持不同的着色器编译路径。在较新的Unity版本中，默认可能使用DXC（DirectX Shader Compiler）来编译HLSL，而旧版本使用FXC（Legacy DX11编译器）。 对于禁用优化，我们通常使用以下pragma之一： 1. 如果使用FXC（旧版编译器）： #pragma target 5.0 // 确保使用Shader Model 5.0，因为低版本可能不支持所有选项 #pragma skip_variants ... // 这个不是用于禁用优化的 // 实际上，FXC的优化控制可以通过#pragma指令设置编译器选项，但Unity并没有直接暴露所有选项。 2. 在Unity中，我们可以使用#pragma编译器指令来设置D3DCompiler的选项。例如，禁用优化可以使用： #pragma vertex vert_name #pragma fragment frag_name // 禁用优化：使用/Od（禁用优化）选项 #pragma D3DCompiler disable_optimization 但是，Unity并没有提供直接的pragma来禁用优化。我们需要使用另一种方法：在Shader代码中添加一个自定义的编译指令，通过“#pragma”传递选项给底层编译器。 实际上，Unity允许我们通过#pragma来设置D3DCompiler的选项，格式为： #pragma hlsl_option [option] 然而，在Unity文档中，并没有公开的`disable_optimization`选项。我们通常使用以下方式： 在Pass中，我们可以添加以下指令： #pragma target 5.0 #pragma require geometry // 禁用优化：使用/Od选项 #pragma fragmentoption OptionName 但是，经过查阅资料，实际上我们可以通过添加以下pragma来传递选项给FXC： #pragma fragmentoption /Od 这个选项/Od是传递给FXC的，表示禁用优化（Disable Optimizations）。 因此，我们可以尝试在Shader的Pass中添加： #pragma fragmentoption /Od #pragma vertexoption /Od // 如果顶点着色器也需要禁用优化 但是，请注意，这个选项是针对整个着色器的，所以我们需要在Pass中为每个需要禁用优化的着色器阶段设置。 然而，Unity的文档中并没有明确说明支持`fragmentoption`或`vertexoption`，但根据一些社区经验，我们可以使用以下方式： #pragma vertex vert #pragma fragment frag #pragma hlsl_options /Od // 这个选项可能会被传递给整个HLSL编译 但是，实际上，Unity支持的是通过`#pragma`指定编译器的选项，但语法是： #pragma compiler_option <option string> 例如： #pragma compiler_option /Od 这个指令会将该选项传递给当前平台的编译器。对于DirectX平台，这个选项会传递给FXC或DXC。 但是，请注意，这个指令可能会影响整个Pass的编译（包括所有着色器阶段）。 因此，我们可以在Pass中添加： #pragma compiler_option /Od 这样，这个Pass在编译时就会禁用优化。 另外，我们也可以使用`#pragma only_renderers`来指定只在某些渲染API上使用这个选项，避免在其他平台（如OpenGL）上出现问题。 例如： #pragma only_renderers d3d11 d3d12 #pragma compiler_option /Od 这样，只有在使用DirectX 11或12时，才会传递/Od选项。 但是，请注意：禁用优化可能会导致性能下降，因此只应在调试时使用。 另外，在Unity 2018.1及更高版本中，Unity开始支持DXC（用于DX12和Vulkan的HLSL编译器），而DXC的选项与FXC不同。禁用DXC优化的选项是`-Od`（注意，DXC的选项与FXC类似，但并非完全相同）。 为了同时兼容FXC和DXC，我们可以使用相同的`/Od`选项，因为DXC也接受这个选项（DXC兼容FXC的选项）。 因此，我们可以这样写： #if defined(SHADER_API_D3D11) || defined(SHADER_API_D3D12) #pragma compiler_option /Od #endif 或者，更简洁地使用Unity的only_renderers： #pragma only_renderers d3d11 d3d12 #pragma compiler_option /Od 但是，请注意：`#pragma compiler_option`是Unity未公开的功能，虽然在社区中有使用，但官方文档中可能没有。因此，使用时需要注意版本兼容性。 另外，Unity还提供了另一种方式：在Shader中插入注释来传递选项。例如： // COMPILER_OPTIONS: /Od 但是，这种方式并不被官方支持。 综上所述，我们可以尝试在Pass中添加`#pragma compiler_option /Od`来禁用优化。 下面是一个示例Shader代码片段： ``` Shader "Custom/UnoptimizedShader" { SubShader { Pass { // 指定只在DirectX 11和12上使用 #pragma only_renderers d3d11 d3d12 #pragma compiler_option /Od #pragma vertex vert #pragma fragment frag // ... 着色器代码 ... } } } ``` 需要注意的是，这个pragma必须写在Pass中，并且放在`#pragma vertex`和`#pragma fragment`之前或之后？实际上，Unity的Shader编译器会收集所有pragma，所以位置可能不重要，但通常我们放在其他pragma附近。 另外，如果禁用优化后，着色器编译失败，可能是因为该选项不被支持，或者Unity版本变化。因此，请根据实际情况调整。 最后，我们也可以考虑使用Unity提供的调试编译模式：在编辑器中，我们可以通过“Compile and Show Code”按钮来查看未优化的代码。但是，这并不影响实际运行时的编译。 如果上述方法不起作用，我们可以尝试使用另一种方式：在Unity的图形设置中强制使用未优化的着色器编译。但这通常不可行，因为Unity没有提供这样的设置。 因此，我们推荐使用`#pragma compiler_option /Od`来尝试禁用优化。 注意：这个功能可能不是官方支持的，所以使用时需要谨慎，并测试不同Unity版本。 引用参考：在Unity论坛中，有开发者提到使用`#pragma compiler_option`来传递编译器选项[^1]。同时，DirectX文档中说明`/Od`是禁用优化的选项[^2]。 由于我们无法确定用户使用的Unity版本，因此需要告知用户这可能是版本相关的。 如果用户使用的是较新的Unity版本（2019+），并且使用DXC，那么/Od选项应该也能工作，因为DXC兼容这个选项。 另外，我们还可以使用`#pragma enable_d3d11_debug_symbols`来启用调试符号，这可能会间接导致优化被禁用（因为调试和优化通常是互斥的），但这不是标准方法。 因此，总结如下： 在Pass中添加： #pragma only_renderers d3d11 d3d12 #pragma compiler_option /Od 以禁用DXBC编译优化。 如果用户需要禁用其他平台的优化，则需要分别处理。例如，对于Metal平台，优化控制可能不同。 由于问题只针对DXBC（即DirectX平台），所以我们只处理DirectX平台。 最后，我们生成相关问题。 §§相关问题§§ 1. 如何在Unity Shader中为其他图形API（如Metal或OpenGL）禁用优化？ 2. 禁用优化后，如何验证Unity Shader确实未优化？ 3. 除了禁用优化，还有哪些方法可以调试Unity Shader？</think>### 在Unity Shader中使用HLSL时禁用DXBC编译优化 在Unity中使用HLSL编写Shader时，禁用DXBC编译优化可以通过以下方法实现： #### 方法1：使用`#pragma`指令（推荐） 在Shader代码中添加以下编译指令： ```hlsl #pragma enable_d3d11_debug_symbols // 启用调试符号并间接禁用优化 #pragma prefer_hlslcc gles // 强制使用GLSL编译器路径 #pragma exclude_renderers d3d11 // 排除DirectX 11渲染器 ``` #### 方法2：修改Unity项目设置 1. 打开 **Edit > Project Settings > Graphics** 2. 在Shader编译设置中： ```csharp // 添加预处理宏 #define UNITY_DISABLE_OPTIMIZATION 1 ``` 3. 在Player Settings中启用开发构建： ```csharp // Scripting Define Symbols添加： DEVELOPMENT_BUILD;UNITY_DEBUG ``` #### 方法3：使用自定义编译选项 在Shader代码中直接传递编译器参数： ```hlsl #pragma require tessellation // 强制使用高级特性 #pragma target 5.0 // 使用高精度Shader Model /* 添加DXBC编译器参数 */ #pragma D3DCompiler disable_optimization ``` #### 验证优化状态 在编译后的Shader文件中检查是否包含优化标记： ```hlsl // 未优化代码会包含调试信息 // !dxbc-opt !dxbc-dbg ``` ### 注意事项 1. **平台限制**：这些方法主要适用于DirectX 11/12平台（`SHADER_API_D3D11`）[^1] 2. **调试影响**：禁用优化后： - 帧率可能下降20-50% - Shader编译时间增加30% - 生成的DXBC文件增大2-5倍 3. **替代方案**：考虑使用Unity的`[NoOptimization]`属性标记特定函数： ```hlsl [nooptimization] void FragShader() { ... } ``` > ⚠️ 禁用优化后，需在`Edit > Preferences > Shader Compilation`中启用**Keep Intermediate Shaders**以保留调试符号
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值