共用方式為

DirectX 標準批注和語意參考

  • 發行項

標準批注和語意 （DXSAS） 以標準方式提供使用著色器的方法，可讓著色器搭配工具、應用程式和遊戲引擎使用。 DXSAS 定義一組語意和批註，這些語意和註釋會附加至主應用程式值和效果參數，以便共用效果。 為了讓這些批注和語意很有用，它們必須在主應用程式和效果檔案中實作。 本文件說明 DXSAS 標準，其利用 DirectX 效果架構的強大功能，讓主應用程式和工具以程式設計方式共用 DirectX 效果（.fx 檔案），以及設計與 UI 的互動。

背景資訊

標準批注和語意是設計來系結效果和 X 檔案參數，以裝載應用程式值。 D3DX 效果架構 （或效果） 會封裝轉譯狀態。 藉由在效果中封裝轉譯狀態（包括頂點、紋理和像素處理狀態），您可以建立涵蓋各種轉譯選項的效果連結庫。 這可能包括在不同類型的硬體上轉譯，或使用單一或多重傳遞混合進行轉譯等選項。 如需效果架構的詳細資訊，您應該參考 效果參考。 DXSAS 建置在此架構之上，為開發人員提供更一致的體驗。 將轉譯設定封裝在效果中之後，DXSAS 標準可讓效果開發人員透過註釋公開效果參數的意圖。 然後，任何主應用程式或工具都可以讀取這些批註（不只是設計成使用效果的註釋），該效果符合標準，將瞭解如何以設計的方式使用效果。

標準化主應用程式支援的效果語意和批注集，可讓效果作者建立可在多個專案中使用的效果，從而提升更廣泛的效果使用者社群。 DXSAS 標準可讓開發人員讀取檔案、可在工具之間交換，並讓開發人員利用第三方工具為其管線撰寫效果。

本文件說明 DXSAS 標準，其使用註釋來表達效果參數的意圖，以及定義主應用程式同意提供給效果的主機應用程式值集合。

使用標準批注和語意撰寫效果

如下圖所示，DXSAS 標準需要效果檔案中的註釋，以及遵循此處所述的指導方針來處理檔案的主應用程式。

主機應用程式和效果檔案的 dxsas 標準圖表

主應用程式必須實作使用者介面邏輯和主機環境。 若要實作符合 DXSAS 規範的效果，請閱讀下列主題：

  • 全域參數 會定義效果的相關信息，例如版本或效果作者。
  • 數據系結 會定義參數集合（以及其類型和結構），這些參數可由公開至效果的主應用程式所設定的效果使用。
  • 若要將使用者介面控制項與效果參數產生關聯，請使用 UI 註釋。 這些批註包括：SasUiMax、SasUiMin、SasUiSteps、SasUiStepsPower，以及 SasUiStride。
  • 若要使用外部檔案中包含的數據初始化效果參數，請使用 參數初始化註釋。
  • 當資料在主應用程式與效果之間傳輸時（反之亦然），轉換和轉換 會在類型不完全相符時發生。 本節會指定當來源和目標類型不同時，數據的寫入方式。 此外，使用 ParameterValueModifiers 修改主應用程式應該如何解譯從效果參數讀取的數據。 這些批註包括：SasNormalize 和 SasUnits。

區分大小寫

所有標識碼、語意和註釋值不區分大小寫。 註釋名稱（非值）區分大小寫。 註釋名稱是由 D3DX 效果系統辨識，因此 SAS 註釋名稱也一樣。

效果參考