語意
語意是附加至著色器輸入或輸出的字串，可傳達參數預期用途的相關信息。 著色器階段之間傳遞的所有變數都需要語意。 將語意新增至著色器變數的語法如下所示（變數語法（DirectX HLSL） 。
一般而言，在管線階段之間傳遞的數據是完全泛型的，而且不會由系統唯一解譯;允許具有特殊意義的任意語意。 包含這些特殊語意的參數（在 Direct3D 10 和更新版本中），稱為 「系統值語意」。
Direct3D 9 和 Direct3D 10 和更新版本中支持的語意
Direct3D 9 和 Direct3D 10 和更新版本中都支援下列類型的語意。
頂點著色器語意
這些語意在附加至頂點著色器參數時具有意義。 Direct3D 9 和 Direct3D 10 和更新版本中都支持這些語意。
| 輸入 | 描述 | 類型 |
|---|---|---|
| BINORMAL[n] | Binormal | float4 |
| BLENDINDICES[n] | 混合索引 | uint |
| BLENDWEIGHT[n] | 混合權數 | float |
| COLOR[n] | 擴散和反射色彩 | float4 |
| NORMAL[n] | 一般向量 | float4 |
| POSITION[n] | 對象空間中的頂點位置。 | float4 |
| POSITIONT | 轉換的頂點位置。 | float4 |
| PSIZE[n] | 點大小 | float |
| TANGENT[n] | 切線 | float4 |
| TEXCOORD[n] | 紋理座標 | float4 |
| 輸出 | 描述 | 類型 |
|---|---|---|
| COLOR[n] | 擴散或反射色彩 | float4 |
| 霧 | 頂點霧 | float |
| POSITION[n] | 同質空間中頂點的位置。 將螢幕空間中的計算位置除以 w（x，y，z） 每個頂點著色器都必須寫出具有此語意的參數。 注意：此語意適用於 Direct3D 9。 針對 Direct3D 10 和更新版本，請改用 SV_Position。 | float4 |
| PSIZE | 點大小 | float |
| TESSFACTOR[n] | 鑲嵌因數 | float |
n 是介於 0 與支援的資源數目之間的選擇性整數。 例如，POSITION0、TEXCOORD1等。
圖元著色器語意
這些語意在附加至圖元著色器輸入參數時具有意義。 Direct3D 9 和 Direct3D 10 和更新版本中都支持這些語意。
| 輸入 | 描述 | 類型 |
|---|---|---|
| COLOR[n] | 擴散或反射色彩。 | float4 |
| TEXCOORD[n] | 紋理座標 | float4 |
| VFACE | 表示背向基本類型的浮點純量。 負值會向後顯示，而正值則面對相機。
注意： |
float |
| VPOS | 屏幕空間中的圖元位置 （x，y）。 若要將 Direct3D 9 著色器（使用此語意）轉換為 Direct3D 10 和更新版本的著色器，請參閱 Direct3D 9 VPOS 和 Direct3D 10 SV_Position） | float2 |
| 輸出 | 描述 | 類型 |
|---|---|---|
| COLOR[n] | 輸出色彩 | float4 |
| DEPTH[n] | 輸出深度 | float |
n 是介於 0 與支援的資源數目之間的選擇性整數。 例如，PSIZE0、COLOR1 等。
COLOR 語意只有在著色器相容性模式中才有效（也就是使用 D3D10_SHADER_ENABLE_BACKWARDS_COMPATIBILITY 建立著色器時）。
只有 Direct3D 10 和更新版本才支援語意。
Direct3D 10 新引進了下列類型的語意，且不適用於 Direct3D 9。
系統值語意
系統值語意是 Direct3D 10 的新功能。 所有系統值都是以SV_前置詞開頭，常見的範例是SV_POSITION，由轉譯器階段解譯。 系統值在管線的其他部分有效。 例如，SV_Position可以指定為頂點著色器的輸入以及輸出。 圖元著色器只能寫入具有SV_Depth和SV_Target系統值語意的參數。
其他系統值（SV_VertexID、SV_InstanceID、SV_IsFrontFace）只能輸入管線中的第一個作用中著色器，以解譯特定值：之後，著色器函式必須將值傳遞至後續階段。
SV_PrimitiveID是這個規則的例外狀況，即只輸入管線中第一個作用中著色器，而該著色器可以解譯特定值;硬體可以提供與船體著色器階段、網域著色器階段以及在該之後第一個啟用階段相同的標識符值：geometry-Shader 階段或圖元著色器階段。
如果已啟用鑲嵌式，則會出現船體著色器階段和領域著色器階段。 針對指定的修補程式，相同的 PrimitiveID 會套用至修補程式的輪廓著色器調用，以及所有鑲嵌式網域著色器調用。 相同的 PrimitiveID 也會傳播到下一個使用中階段;如果已啟用 geometry-shader 階段或像素著色器階段。
如果幾何著色器輸入SV_PrimitiveID，而且因為它可以為每個調用輸出零或一或多個基本類型，著色器必須在後續的圖元著色器輸入SV_PrimtiveID時，針對每個輸出基本類型自行撰寫SV_PrimitiveID值的程序設計。
另一個範例是，頂點著色器階段無法解譯SV_PrimitiveID，因為頂點可以是多個基本類型的成員。
這些語意已新增至 Direct3D 10;它們無法在 Direct3D 9 中使用。
轉譯器階段的系統值語意。
| 系統值語意 | 描述 | 類型 |
|---|---|---|
| SV_ClipDistance[n] | 裁剪距離數據。 SV_ClipDistance值都是假設為平面的 float32 帶正負號距離。 基本設定只會在插入平面距離 >= 0 的像素上叫用點陣化。 您可以同時實作多個裁剪平面，方法是將一個或多個頂點元素的多個元件宣告為SV_ClipDistance。 在最多 D3D#_CLIP_OR_CULL_DISTANCE_ELEMENT_COUNT 緩存器中，結合的剪輯和 cull 距離值最多為 D3D#_CLIP_OR_CULL_DISTANCE_COUNT 元件。 可供讀取或寫入的所有著色器使用，但頂點著色器可以寫入值，但無法將其視為輸入。 clipplanes 屬性的運作方式類似SV_ClipDistance，但適用於所有硬體功能層級9_x和更新版本。 如需詳細資訊，請參閱 功能層級 9 硬體上的使用者剪輯平面。 |
float |
| SV_CullDistance[n] | Null 距離數據。 當頂點元素的 component（s） 指定此標籤時，這些值會假設為平面的 float32 帶正負號距離。 如果基本類型中所有頂點的平面距離為 < 0，則會完全捨棄基本類型。 您可以將一或多個頂點元素的多個元件宣告為SV_CullDistance，以同時使用多個 null 平面。 在最多 D3D#_CLIP_OR_CULL_DISTANCE_ELEMENT_COUNT 緩存器中，結合的剪輯和 cull 距離值最多為 D3D#_CLIP_OR_CULL_DISTANCE_COUNT 元件。 可供讀取或寫入的所有著色器使用，但頂點著色器可以寫入值，但無法將其視為輸入。 |
float |
| SV_Coverage | 可在輸入、輸出或兩個像素著色器上指定的遮罩。 針對圖元著色器上的SV_Coverage，ps_4_1或更新版本支援 OUTPUT。 針對圖元著色器上的SV_Coverage，INPUT 需要ps_5_0或更高版本。 |
uint |
| SV_Depth | 深度緩衝區數據。 可由圖元著色器撰寫。 | float |
| SV_DepthGreaterEqual | 在圖元著色器中，允許輸出深度，只要其大於或等於轉譯器所決定的值即可。 啟用調整深度，而不停用早期 Z。 | float |
| SV_DepthLessEqual | 在圖元著色器中，允許輸出深度，只要小於或等於轉譯器所決定的值即可。 啟用調整深度，而不停用早期 Z。 | float |
| SV_DispatchThreadID | 定義分派呼叫內的全域線程位移，每個群組維度。 可作為計算著色器的輸入。 （唯讀） | uint3 |
| SV_DomainLocation | 定義要評估之目前定義域點殼體上的位置。 可作為網域著色器的輸入。 （唯讀） | float2|3 |
| SV_GroupID | 定義分派呼叫內的群組位移，每個分派呼叫的維度。 可作為計算著色器的輸入。 （唯讀） | uint3 |
| SV_GroupIndex | 提供指定群組內指定線程的扁平化索引。 可作為計算著色器的輸入。 （唯讀） | uint |
| SV_GroupThreadID | 定義群組內每個維度的線程位移。 可作為計算著色器的輸入。 （唯讀） | uint3 |
| SV_GSInstanceID | 定義 geometry 著色器的實例。 可作為幾何著色器的輸入。 需要實例，因為幾何著色器最多可以在相同的幾何基本類型上叫用 32 次。 | uint |
| SV_InnerCoverage | 代表低估的保守點陣化資訊（即圖元是否保證完全涵蓋）。 可由圖元著色器讀取或寫入。 | |
| SV_InsideTessFactor | 定義修補表面內的鑲嵌量。 可在船體著色器中取得以供寫入，且可在網域著色器中取得以供讀取。 | float|float[2] |
| SV_InstanceID | 執行時間自動產生的每個實體識別碼（請參閱 使用系統產生的值 （Direct3D 10） 。 適用於所有著色器。 | |
| SV_IsFrontFace | 指定三角形是否為正面。 針對線條和點，IsFrontFace 的值為 true。 例外狀況是繪製出三角形的線條（線框模式），這會將IsFrontFace設定為與以實心模式點陣化三角形的方式相同。 可由幾何著色器寫入，並由圖元著色器讀取。 | bool |
| SV_OutputControlPointID | 定義由船體著色器主要進入點叫用所操作之控制點標識碼的索引。 只能由船體著色器讀取。 | uint |
| SV_Position | 當SV_Position宣告為著色器的輸入時，它可以有兩種指定的插補模式之一：linearNoPerspective 或 linearNoPerspectiveCentroid，其中後者會在多重取樣反鋸齒時提供心心貼齊的 xyzw 值。 在著色器中使用時，SV_Position描述圖元位置。 適用於所有著色器，以取得具有0.5位移的圖元中心。 | float4 |
| SV_PrimitiveID | 執行時間自動產生的每一基本識別碼（請參閱 使用系統產生的值 （Direct3D 10） 。 可以由幾何或像素著色器寫入，並由幾何、圖元、殼體或領域著色器讀取。 | uint |
| SV_RenderTargetArrayIndex | 轉譯目標陣列索引。 套用至幾何著色器輸出，並指出基本類型將由圖元著色器繪製的轉譯目標陣列配量。 只有當轉譯目標是陣列資源時，SV_RenderTargetArrayIndex才有效。 此語意僅適用於基本類型;如果基本類型有多個頂點，則會使用前置頂點的值。 這個值也會指出深度/樣板檢視的數位配量用於讀取/寫入目的。 可以從幾何著色器寫入，並由圖元著色器讀取。 如果 D3D11_FEATURE_DATA_D3D11_OPTIONS3：：VPAndRTArrayIndexFromAnyShaderFeedingRasterizer 為 true，則SV_RenderTargetArrayIndex會套用至任何向轉譯器饋送的著色器。 |
uint |
| SV_SampleIndex | 取樣頻率索引數據。 只能由圖元著色器讀取或寫入。 | uint |
| SV_StencilRef | 表示目前的像素著色器樣板參考值。 只能由圖元著色器撰寫。 | uint |
| SV_Target[n]，其中 0 <= n <= 7 | 將儲存在轉譯目標的輸出值。 索引表示要寫入的8個可能系結轉譯目標中的哪一個。 值可供所有著色器使用。 | float[2|3|4] |
| SV_TessFactor | 定義修補的每個邊緣的鑲嵌量。 可用於在船體著色器中寫入，並在網域著色器中讀取。 | float[2|3|4] |
| SV_VertexID | 運行時間自動產生的每個頂點標識碼（請參閱 使用系統產生的值 （Direct3D 10） ）。 僅供頂點著色器的輸入使用。 | uint |
| SV_ViewportArrayIndex | Viewport 陣列索引。 套用至幾何著色器輸出，並指出要用於目前正在寫出之基本類型的檢視區。圖元著色器可以讀取。 在將索引指定的檢視區傳遞至轉譯器之前，會先轉換和裁剪基本類型。 此語意僅適用於基本類型;如果基本類型有多個頂點，則會使用前置頂點的值。 如果 D3D11_FEATURE_DATA_D3D11_OPTIONS3：：VPAndRTArrayIndexFromAnyShaderFeedingRasterizer 為 true，則會將SV_ViewportArrayIndex套用至轉譯器饋送的任何著色器。 |
uint |
| SV_ShadingRate | 透過底紋速率 值定義由一個像素著色器調用寫入的像素數目，以 可變底紋速率第2 層或更高層級的裝置。 可以從圖元著色器讀取。 可以從頂點或幾何著色器撰寫。 | uint |
撰寫SV_Depth時的限制：
- 當多重取樣 （multisampleEnable 在 D3D10_RASTERIZER_DESC 中為 TRUE）和寫入深度值（使用圖元著色器），則寫出的單一值也會用於深度測試中，因此在較高解析度呈現基本邊緣的能力會在多重取樣時遺失。
- 使用動態流程控制時，不可能在編譯時期判斷是否保證在一些路徑中寫入SV_Depth的著色器是否保證會在每次執行中寫入SV_Depth。 當宣告時無法寫入SV_Depth會導致未定義的行為（這可能或不包括捨棄圖元）。
- 任何 float32 值，包括 +/-INF 和 NaN 都可以寫入至SV_Depth。
- 執行雙重來源色彩混合時，寫入SV_Depth仍然有效。
從 Direct3D 9 移轉至 Direct3D 10 和更新版本
將程式代碼從 Direct3D 9 移轉至 Direct3D 10 和更新版本時，應考慮下列問題：
對應至 Direct3D 9 語意
一些 Direct3D 10 和更新版本的語意會直接對應至 Direct3D 9 語意。
| Direct3D 10 語意 | Direct3D 9 對等語意 |
|---|---|
| SV_Depth | DEPTH |
| SV_Position | POSITION |
| SV_Target | 顏色 |
[!]請注意 Direct3D 9 開發人員：針對 Direct3D 9 目標，著色器語意必須對應至有效的 Direct3D 9 語意。 為了回溯相容性，FXC 會將POSITION0及其變體名稱視為SV_Position。 FXC 會將 COLOR 視為SV_TARGET。 DXC 和較新的編譯程式會將POSITION[n] 和 COLOR 視為使用者定義的語意。
Direct3D 9 VPOS 和 Direct3D 10 SV_Position
D3D10 語意SV_Position提供與 Direct3D 9 著色器模型 3 VPOS 語意類似的功能。 例如，在 Direct3D 9 中，下列語法用於使用螢幕空間座標的圖元著色器：
float4 psMainD3D9( float4 screenSpace : VPOS ) : COLOR
{
// code here
}
VPOS 新增了著色器模型 3 支援，以指定螢幕空間座標，因為 POSITION 語意適用於物件空間座標。
在 Direct3D 10 和更新版本中，SV_Position語意（在圖元著色器的內容中使用時）會指定螢幕空間座標（位移 0.5）。 因此，Direct3D 9 著色器大致相當於下列專案（而不考慮 0.5 位移）：
float4 psMainD3D10( float4 screenSpace : SV_Position ) : COLOR
{
// code here
}
從 Direct3D 9 移轉至 Direct3D 10 和更新版本時，您必須在翻譯著色器時注意這一點。
HLSL 中的使用者裁剪平面
從 Windows 8 開始，您可以在 HLSL 函式宣告中使用剪輯平面函式屬性，而不是SV_ClipDistance，讓您的著色器在功能層級9_x以及功能層級 10 和更新版本上運作。 如需詳細資訊，請參閱 功能層級 9 硬體上的使用者剪輯平面。