FXC-Aufgabe
Hinweis
Diese Aufgabe ist nur verfügbar, wenn Sie das C++-Buildsystem verwenden.
Verwenden Sie HLSL-Shader-Compiler im Buildprozess.
Parameter
In der folgenden Tabelle werden die Parameter der Aufgabe FXC beschrieben:
| Parameter | Beschreibung |
|---|---|
| AdditionalIncludeDirectories | Optionaler string[] -Parameter. Gibt mindestens ein Verzeichnis an, das dem include-Pfad hinzugefügt werden soll. Verwenden Sie Semikolons als Trennzeichen, wenn mehrere Verzeichnisse vorhanden sind. Verwenden Sie /I[path]. |
| AdditionalOptions | Optionaler string-Parameter |
| AllResourcesBound | Optionaler bool-Parameter. Der Compiler geht davon aus, dass alle Ressourcen, auf die ein Shader ggf. verweist, gebunden sind und für die Dauer der Shaderausführung einen ordnungsgemäßen Zustand aufweisen. Verfügbar für Shadermodell 5.1 und höher. Verwenden Sie /all_resources_bound. |
| AssemblerOutput | Optionaler string-Parameter Gibt die Inhalte der Ausgabedatei für die Assemblysprache an. Verwenden Sie /Fc, /Fx.NoListing AssemblyCode: Verwenden Sie Fc.AssemblyCodeAndHex: Verwenden Sie Fx. |
| AssemblerOutputFile | Optionaler string-Parameter Gibt den Dateinamen für die Assembly-Codelistingdatei an. |
| CompileD2DCustomEffect | Optionaler bool-Parameter. Kompiliert einen benutzerdefinierten Direct2D-Effekt mit Pixelshadern. Verwenden Sie diese Option nicht für einen benutzerdefinierten Vertex- oder Computeeffekt. |
| ConsumeExportFile | Optionaler string-Parameter |
| DisableOptimizations | Optionaler bool-Parameter. Deaktiviert Optimierungen. /Od impliziert /Gfp, die Ausgabe ist jedoch möglicherweise nicht mit /Od /Gfp identisch. |
| EnableDebuggingInformation | Optionaler bool-Parameter. Aktiviert Debuginformationen. |
| EnableUnboundedDescriptorTables | Optionaler bool-Parameter. Informiert den Compiler, dass ein Shader ggf. eine Deklaration eines Ressourcenarrays mit einem ungebundenen Bereich enthält. Verfügbar für Shadermodell 5.1 und höher. Verwenden Sie /enable_unbounded_descriptor_tables. |
| EntryPointName | Optionaler string-Parameter Gibt den Namen des Einstiegspunkts für den Shader an. Verwenden Sie /E[name]. |
| GenerateExportFile | Optionaler string-Parameter |
| GenerateExportShaderProfile | Optionaler string-Parameter |
| HeaderFileOutput | Optionaler string-Parameter Gibt einen Namen für die Headerdatei mit Objektcode an. Verwenden Sie /Fh [name]. |
| ObjectFileOutput | Optionaler string-Parameter Gibt einen Namen für die Objektdatei an. Verwenden Sie /Fo [name]. |
| PreprocessorDefinitions | Optionaler string[] -Parameter Definiert Vorverarbeitungssymbole für Ihre Quelldatei. |
| SetRootSignature | Optionaler string-Parameter Fügt die Stammsignatur an Shader-Bytecode an. Verfügbar für Shadermodell 5.0 und höher. Verwenden Sie /setrootsignature. |
| ShaderModel | Optionaler string-Parameter Gibt das Shadermodell an. Einige Shadertypen können nur mit aktuellen Shadermodellen verwendet werden. Verwenden Sie /T [type]_[model]. |
| ShaderType | Optionaler string-Parameter Gibt die Art des Shaders an. Verwenden Sie /T [type]_[model].Effect: Verwenden Sie fx.Vertex: Verwenden Sie vs.Pixel: Verwenden Sie ps.Geometry: Verwenden Sie gs.Hull: Verwenden Sie hs.Domain: Verwenden Sie ds.Compute: Verwenden Sie cs.Library: Verwenden Sie lib.RootSignature: Generiert das Stammsignaturobjekt. |
| Quelle | Erforderlicher ITaskItem-Parameter. |
| SuppressStartupBanner | Optionaler bool-Parameter. Unterdrückt die Anzeige des Startbanners und der Informationsmeldung. Verwenden Sie /nologo. |
| TrackerLogDirectory | Optionaler string-Parameter |
| TreatWarningAsError | Optionaler bool-Parameter. Behandelt alle Compilerwarnungen als Fehler. Bei einem neuen Projekt kann es empfehlenswert sein, /WX in allen Kompilierungen zu verwenden. Die Auflösung aller Warnungen stellt sicher, dass möglichst wenig schwer zu findende Codefehler vorhanden sind. |
| VariableName | Optionaler string-Parameter Gibt einen Namen für den Variablennamen in der Headerdatei an. Verwenden Sie /Vn [name]. |