HLSL 編譯器屬性頁

發行項
10/12/2023

您可以使用 HLSL 編譯器 (fxc.exe) 屬性頁，設定個別 HLSL 著色器檔案的建置方式。您也可以使用 命令列 屬性頁的 [其他選項 ] 屬性來指定 HLSL 編譯器的命令列引數;這包括無法使用 HLSL 屬性頁的其他屬性設定的引數。如需 HLSL 編譯器的資訊，請參閱 Effect-Compiler Tool (效果編譯器工具)

HLSL 一般屬性頁

其他 Include 目錄

指定一或多個要加入 Include 路徑中的目錄；如有多個目錄，請使用分號加以分隔。（/I[path]）

進入點名稱

指定著色器進入點的名稱（/E[name]）

[停用最佳化]

[是 (/Od)] 可停用最佳化；否則為 [否]。根據預設，[偵錯] 組態的值是 [是 (/Od)]，而 [發行] 組態的值是 [否]。

HLSL 編譯器的 /Od 命令列引數會隱含地套用 /Gfp 命令列引數，但輸出可能不同於同時明確傳遞 /Od 和 /Gfp 命令列引數所產生的輸出。

啟用偵錯資訊

[是 (/Zi)] 可啟用偵錯資訊；否則為 [否]。根據預設，[偵錯] 組態的值是 [是 (/Zi)]，而 [發行] 組態的值是 [否]。

著色器類型

指定著色器種類。不同種類的著色器會實作圖形管線的不同部分。特定種類的著色器僅可用於較新的著色器模型 (其由 [著色器模型] 屬性指定)。例如，在著色器模型 5 中引入了計算著色器。

這個屬性對應於 HLSL 編譯器之 /T [type]_[model] 命令列引數的 [type] 部分。 [著色器模型] 屬性則會指定引數的 [model] 部分。

Choices

效果
頂點著色器
像素著色器
幾何著色器
赫爾著色器
網域著色器
計算著色器
程式庫
產生根簽章物件

著色器模型

指定著色器模型。不同的著色器模型具有不同的功能。一般情況下，較新的著色器模型會提供擴充功能，但需要更先進的圖形硬體才能執行著色器程式碼。特定種類的著色器 (其由 [著色器類型] 屬性指定) 僅可用於較新的著色器模型；例如，在著色器模型 5 中引入了計算著色器。

這個屬性對應於 HLSL 編譯器之 /T [type]_[model] 命令列引數的 [model] 部分。 [著色器類型] 屬性則會指定引數的 [type] 部分。

系結的所有資源

編譯器會假設著色器可能參考的所有資源都會系結，而且在著色器執行期間處於良好狀態（/all_resources_bound）。適用於著色器模型 5.1 (含) 以上版本。

啟用未系結描述中繼資料表

通知編譯器著色器可能包含具有未系結範圍之資源陣列的宣告（/enable_unbounded_descriptor_tables）。適用於著色器模型 5.1 (含) 以上版本。

設定根簽章

將根簽章附加至著色器位元組程式碼（/setrootsignature）。適用於著色器模型 5.0 (含) 以上版本。

前置處理器定義

新增一或多個要套用至 HLSL 原始程式碼檔案的前置處理器符號定義。請使用分號來分隔這些符號定義。

這個屬性對應於 HLSL 編譯器之 /D [definitions] 命令列引數。

編譯 Direct2D 自訂圖元著色器效果

編譯包含像素著色器的 Direct2D 自訂效果。請勿用於頂點或計算自訂效果。

多處理器編譯

同時執行多個實例。

進階屬性頁

隱藏程式啟始資訊及資訊訊息。（/諾洛戈）

將警告視為錯誤

將所有編譯器警告視為錯誤。若是新專案，建議在所有編譯中使用 /WX；解決所有警告時，才能將難以找出的程式碼缺失降至最低。

輸出檔案屬性頁

標頭變數名稱

指定標頭檔中變數名稱的名稱（/Vn [name]）

標頭檔名

指定包含目的碼的標頭檔名稱。（/Fh [名稱]）

目的檔名稱

指定目的檔的名稱。（/Fo [名稱]）

組合語言輸出

指定組合語言輸出檔案的內容。（/Fc、/Fx）