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]。

另请参阅

任务参考