Share via


內建函式

下表列出 HLSL 中可用的內建函式。 每個函式都有簡短的描述,以及參考頁面的連結,其中包含輸入引數和傳回類型的詳細資料。

名稱 描述 最小著色器模型
abort 終止正在執行的目前繪製或分派呼叫。 4
abs 絕對值(每個元件)。 1次
acos 傳回 x 每個元件的反余弦值。 1次
全部 測試 x 的所有元件是否為非零。 1次
AllMemoryBarrier 封鎖群組中所有線程的執行,直到所有記憶體存取都完成為止。 5
AllMemoryBarrierWithGroupSync 封鎖群組中所有線程的執行,直到所有記憶體存取都完成,且群組中的所有線程都已到達此呼叫為止。 5
any 測試 x 的任何元件是否為非零。 1次
asdouble 將轉換值重新解譯為雙精度浮點數。 5
asfloat 將輸入類型轉換為 float。 4
asin 傳回 x 每個元件的反正弦值。 1次
asint 將輸入類型轉換為整數。 4
asuint 將 64 位類型的位模式重新解譯為 uint。 5
asuint 將輸入類型轉換為不帶正負號的整數。 4
atan 傳回 x 的反正切值。 1次
atan2 傳回兩個值的反正切值(x,y)。 1次
ceil 傳回大於或等於 x 的最小整數。 1次
CheckAccessFullyMapped 判斷範例或載入作業中的所有值 是否存取磚 資源中的 對應磚。 5
將 x 夾到範圍 [min, max]。 1次
clip 如果 x 的任何元件小於零,則會捨棄目前的圖元。 1次
cos 傳回 x 的余弦值。 1次
cosh 傳回 x 的雙曲余弦值。 1次
countbits 計算輸入整數中的位數(每個元件)。 5
交叉 傳回兩個 3D 向量的交叉乘積。 1次
D3DCOLORtoUBYTE4 4D 向量 x 的 Swizzles 和 scales 元件可補償某些硬體中缺乏 UBYTE4 支援。 1次
ddx 傳回 x 相對於螢幕空間 x 座標的部分衍生。 2 Emc
ddx_coarse 計算與螢幕空間 x 座標相關的低精確度部分衍生。 5
ddx_fine 計算與螢幕空間 x 座標相關的高精確度部分衍生。 5
ddy 傳回 x 相對於螢幕空間 y 座標的部分衍生。 2 Emc
ddy_coarse 計算與螢幕空間 y 座標相關的低精確度部分衍生。 5
ddy_fine 計算與螢幕空間 y 座標相關的高精確度部分衍生。 5
將 x 從弧度轉換成度。 1次
行列 式 傳回平方矩陣 m 的行列式。 1次
DeviceMemoryBarrier 封鎖群組中所有線程的執行,直到所有裝置記憶體存取完成為止。 5
DeviceMemoryBarrierWithGroupSync 封鎖群組中所有線程的執行,直到所有裝置記憶體存取都完成,且群組中的所有線程都已到達此呼叫為止。 5
distance 傳回兩點之間的距離。 1次
傳回兩個向量的內積。 1
Dst 計算距離向量。 5
errorf 將錯誤訊息提交至資訊佇列。 4
EvaluateAttributeCentroid 評估圖元心形。 5
EvaluateAttributeAtSample 評估在索引的範例位置。 5
EvaluateAttributeSnapped 以位移來評估圖元心。 5
exp 傳回 base-e 指數。 1次
exp2 基底 2 指數(每個元件)。 1次
f16tof32 將儲存在 uint 下半部的 float16 轉換為 float。 5
f32tof16 將輸入轉換成 float16 類型。 5
faceforward 會傳回 -n * sign(dot(i, ng))。 1次
firstbithigh 取得從最高順序位開始的第一個設定位位置,並依元件向下運作。 5
firstbitlow 傳回從最低順序位開始的第一個設定位位置,並依元件向上工作。 5
floor 傳回小於或等於 x 的最大整數。 1次
fma 傳回雙精確度融合加法 * b + c。 5
fmod 傳回 x/y 的浮點餘數。 1次
壓裂 傳回 x 的小數部分。 1次
frexp 傳回 x 的 mantissa 和指數。 2 Emc
fwidth 傳回 abs(ddx(x)) + abs(ddy(x)) 2 Emc
GetRenderTargetSampleCount 傳回轉譯目標樣本的數目。 4
GetRenderTargetSamplePosition 傳回指定範例索引的範例位置 (x,y)。 4
GroupMemoryBarrier 封鎖群組中所有線程的執行,直到所有群組共用存取都完成為止。 5
GroupMemoryBarrierWithGroupSync 封鎖群組中所有線程的執行,直到所有群組共用存取都完成,且群組中的所有線程都已到達此呼叫為止。 5
InterlockedAdd 對 dest 資源變數執行保證的不可部分完成增加值。 5
InterlockedAnd 執行保證的不可部分完成和 。 5
InterlockedCompareExchange 以不可部分完成的方式比較輸入與比較值,並交換結果。 5
InterlockedCompareStore 以不可部分完成的方式比較輸入與比較值。 5
InterlockedExchange 將值指派給 dest,並傳回原始值。 5
InterlockedMax 執行保證不可部分完成的最大值。 5
InterlockedMin 執行保證的不可部分完成最小值。 5
InterlockedOr 執行保證的不可部分完成或。 5
InterlockedXor 執行保證的不可部分完成 xor。 5
isfinite 如果 x 為有限,則傳回 true,否則傳回 false。 1次
isinf 如果 x 是 +INF 或 -INF,則傳回 true,否則傳回 false。 1次
isnan 如果 x 是 NAN 或 QNAN,則傳回 true,否則傳回 false。 1次
ldexp 傳回 x * 2exp 1次
length 傳回向量 v 的長度。 1次
lerp 會傳回 x + s(y - x)。 1次
點燃 傳回光源向量(環境、擴散、反射、1) 1次
log 傳回 x 的 base-e 對數。 1次
log10 傳回 x 的 base-10 對數。 1次
log2 傳回 x 的 base-2 對數。 1次
瘋狂 在三個值上執行算術乘法/加法運算。 5
max 選取 x 和 y 的更大。 1次
min 選取 x 和 y 的較小專案。 1次
modf 將 x 值分割成小數和整數部分。 1次
msad4 比較 4 位元組參考值和 8 位元組的來源值,並累積 4 個總和的向量。 5
mul 使用 x 和 y 執行矩陣乘法。 1
雜訊 使用 Perlin-noise 演算法產生隨機值。 1次
規範 傳回正規化向量。 1次
pow 傳回 x y 1次
printf 將自訂著色器訊息提交至資訊佇列。 4
Process2DQuadTessFactorsAvg 為四邊形修補產生更正的鑲嵌因數。 5
Process2DQuadTessFactorsMax 為四邊形修補產生更正的鑲嵌因數。 5
Process2DQuadTessFactorsMin 為四邊形修補產生更正的鑲嵌因數。 5
ProcessIsolineTessFactors 產生 isoline 的四捨五入鑲嵌因數。 5
ProcessQuadTessFactorsAvg 為四邊形修補產生更正的鑲嵌因數。 5
ProcessQuadTessFactorsMax 為四邊形修補產生更正的鑲嵌因數。 5
ProcessQuadTessFactorsMin 為四邊形修補產生更正的鑲嵌因數。 5
ProcessTriTessFactorsAvg 為三個修補程式產生更正的鑲嵌因數。 5
ProcessTriTessFactorsMax 為三個修補程式產生更正的鑲嵌因數。 5
ProcessTriTessFactorsMin 為三個修補程式產生更正的鑲嵌因數。 5
弧度 將 x 從度轉換成弧度。 1
rcp 計算快速、近似、每個元件的相互。 5
反映 傳回反映向量。 1
折射 傳回折射向量。 1次
reversebits 反轉每個元件位的順序。 5
round 將 x 四捨五入為最接近的整數 1次
rsqrt 傳回 1 / sqrt(x) 1次
飽和 將 x 夾到範圍 [0, 1] 1
簽署 計算 x 的符號。 1次
sin 傳回 x 的正弦值 1次
sincos 傳回 x 的正弦和余弦值。 1次
sinh 傳回 x 的雙曲正弦值 1次
smoothstep 傳回介於 0 到 1 之間的平滑隱士插補。 1次
sqrt 平方根 (每個元件) 1次
傳回 (x > = a) ? 1 : 0 1次
tan 傳回 x 的正切值 1次
tanh 傳回 x 的雙曲正切值 1次
tex1D(s, t) 1D 紋理查閱。 1
tex1D(s, t, ddx, ddy) 1D 紋理查閱。 2 Emc
tex1Dbias 具有偏差的 1D 紋理查閱。 2 Emc
tex1Dgrad 具有漸層的 1D 紋理查閱。 2 Emc
tex1Dlod 使用 LOD 進行 1D 紋理查閱。 3 Emc
tex1Dproj 具有投影除法的 1D 紋理查閱。 2 Emc
tex2D(s, t) 2D 紋理查閱。 1次
tex2D(s, t, ddx, ddy) 2D 紋理查閱。 2 Emc
tex2Dbias 具有偏差的 2D 紋理查閱。 2 Emc
tex2Dgrad 具有漸層的 2D 紋理查閱。 2 Emc
tex2Dlod 使用 LOD 進行 2D 紋理查閱。 3
tex2Dproj 具有投影除法的 2D 紋理查閱。 2 Emc
tex3D(s, t) 3D 紋理查閱。 1次
tex3D(s, t, ddx, ddy) 3D 紋理查閱。 2 Emc
tex3Dbias 具有偏差的 3D 紋理查閱。 2 Emc
tex3Dgrad 具有漸層的 3D 紋理查閱。 2 Emc
tex3Dlod 使用 LOD 進行 3D 紋理查閱。 3 Emc
tex3Dproj 具有投影除法的 3D 紋理查閱。 2 Emc
texCUBE(s, t) Cube 紋理查閱。 1次
texCUBE(s, t, ddx, ddy) Cube 紋理查閱。 2 Emc
texCUBEbias 具有偏差的立方體紋理查閱。 2 Emc
texCUBEgrad 具有漸層的 Cube 紋理查閱。 2 Emc
texCUBElod 使用 LOD 進行 Cube 紋理查閱。 3 Emc
texCUBEproj 具有投影除法的立方體紋理查閱。 2 Emc
transpose 傳回矩陣 m 的轉置。 1
trunc 截斷浮點值(s) 到整數值(s) 1

 

1 請參閱參考頁面以取得限制。

元件和範本類型

HLSL 內建函式宣告會針對輸入參數引數和傳回值使用元件類型和範本類型。 下表列出可用的類型。

這些範本類型 描述 支援這些資料類型
矩陣 根據宣告,最多 16 個元件 基本 HLSL 類型
object sampler 物件 sampler sampler1D sampler2D sampler3D samplerCUBE
標量 1 個元件 基本 HLSL 類型
vector 最小 1 個元件,最多 4 個元件(含) 基本 HLSL 類型

 

另請參閱

HLSL 的參考