FXC 任务

注意

仅当使用 C++ 生成系统时,此任务才可用。

在生成过程中使用 HLSL 着色器编译器。

参数

下表介绍了 FXC 任务的参数

参数 描述
AdditionalIncludeDirectories 可选的 string[] 参数。

指定一个或多个要添加到包含路径中的目录;存在多个目录时,请用分号分隔。

请使用 /I[path]
AdditionalOptions 可选的 string 参数。
AllResourcesBound 可选的 bool 参数。

编译器假定着色器可引用的所有资源已绑定,并且在着色器执行期间处于良好状态。 适用于着色器模型 5.1 及更高版本。

请使用 /all_resources_bound
AssemblerOutput 可选的 string 参数。

指定汇编语言输出文件的内容。

请使用 /Fc, /Fx

NoListing
AssemblyCode,使用 Fc
AssemblyCodeAndHex,使用 Fx
AssemblerOutputFile 可选的 string 参数。

指定程序集代码清单文件的文件名。
CompileD2DCustomEffect 可选的 bool 参数。

编译包含像素着色器的 Direct2D 自定义效果。 请勿用于顶点或计算自定义效果。
ConsumeExportFile 可选的 string 参数。
DisableOptimizations 可选的 bool 参数。

禁用优化。

/Od 是指 /Gfp,但输出可能与 /Od /Gfp 不同。
EnableDebuggingInformation 可选的 bool 参数。

启用调试信息。
EnableUnboundedDescriptorTables 可选的 bool 参数。

通知编译器:着色器可能包含具有未绑定范围的资源数组的声明。 适用于着色器模型 5.1 及更高版本。

请使用 /enable_unbounded_descriptor_tables
EntryPointName 可选的 string 参数。

为着色器指定入口点名称。

请使用 /E[name]
GenerateExportFile 可选的 string 参数。
GenerateExportShaderProfile 可选的 string 参数。
HeaderFileOutput 可选的 string 参数。

为包含对象代码的头文件指定名称。

请使用 /Fh [name]
ObjectFileOutput 可选的 string 参数。

为对象文件指定名称。

请使用 /Fo [name]
PreprocessorDefinitions 可选的 string[] 参数。

为源文件定义预处理符号。
SetRootSignature 可选的 string 参数。

将根签名附加到着色器字节码。 适用于着色器模型 5.0 及更高版本。

请使用 /setrootsignature
ShaderModel 可选的 string 参数。

指定着色器模型。 部分着色器类型只能与最新的着色器模型搭配使用。

请使用 /T [type]_[model]
ShaderType 可选的 string 参数。

指定着色器的类型。

请使用 /T [type]_[model]

Effect,使用 fx
Vertex,使用 vs
Pixel,使用 ps
Geometry,使用 gs
Hull,使用 hs
Domain,使用 ds
Compute,使用 cs
Library,使用 lib
RootSignature,生成根签名对象。
Source 必需的 ITaskItem 参数。
SuppressStartupBanner 可选的 bool 参数。

取消显示启动版权标志和信息消息。

请使用 /nologo
TrackerLogDirectory 可选的 string 参数。
TreatWarningAsError 可选的 bool 参数。

将所有编译器警告视为错误。

对于新项目,最好在所有编译中使用 /WX;对所有警告进行解析可确保将可能难以发现的代码缺陷减至最少。
VariableName 可选的 string 参数。

为头文件中的变量名称指定名称。

请使用 /Vn [name]

另请参阅

任务参考