共用方式為

DirectX 標準注釋和語意參考

  • 發行項

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

背景資訊

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

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

本檔描述使用注釋來表示效果參數意圖的 DXSAS 標準，以及定義主應用程式同意提供給效果的主機應用程式值集合。

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

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

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

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

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

區分大小寫

所有識別碼、語意和批註值都不區分大小寫。 批註名稱 (不區分大小寫) 的值。 注釋名稱是由 D3DX 效果系統辨識，因此 SAS 注釋名稱也是。

效果參考