RenderScript 數學常數和函式

pi 的反函式，為 32 位元浮點值。

2 除以 pi，以 32 位元的浮點值表示。

2 除以 pi 的平方根，為 32 位元浮點值。

數字 e，即自然對數的底數，以 32 位元的浮點值表示。

10 的自然對數，如 32 位元浮點值。

2 的自然對數，以 32 位元浮點值表示。

e 的對數底數 10，以 32 位元浮點值。

e 的對數底 2，以 32 位元浮點值表示。

常數 pi，以 32 位元的浮點值表示。

Pi 除以 2，以 32 位元的浮點值表示。

Pi 除以 4，以 32 位元的浮點值表示。

2 的平方根的反函式，為 32 位元浮點值。

2 的平方根，以 32 位元浮點值表示。

傳回整數的絕對值。

如果是浮點值，請使用 fabs()。

傳回反餘弦函數，並以弧度表示。

另請參閱 native_acos()。

傳回反雙曲線餘弦，並以弧度表示。

另請參閱 native_acosh()。

傳回以弧度為單位的反餘弦，除以 pi。

如要取得以度為單位的反餘弦值，請使用 acospi(a) * 180.f。

另請參閱 native_acospi()。

傳回反正弦函數，並以弧度為單位。

另請參閱 native_asin()。

傳回反雙曲線正弦值，以弧度為單位。

另請參閱 native_asinh()。

傳回反正弦值 (以弧度為單位) 除以 pi。

如要取得以度為單位的反正弦，請使用 asinpi(a) * 180.f。

另請參閱 native_asinpi()。

傳回反正切 (以弧度為單位)。

另請參閱 native_atan()。

傳回 (numerator / denominator) 的反正切值，並以弧度表示。

另請參閱 native_atan2()。

傳回 (numerator / denominator) 的反正切值，以弧度為單位除以 pi。

如要取得以度為單位的反正切值，請使用 atan2pi(n, d) * 180.f。

另請參閱 native_atan2pi()。

傳回反雙曲正切，以弧度為單位。

另請參閱 native_atanh()。

傳回以弧度為單位的反正切除以 pi。

如要取得以度為單位的反正切值，請使用 atanpi(a) * 180.f。

另請參閱 native_atanpi()。

傳回立方根。

另請參閱 native_cbrt()。

傳回不小於值的最小整數。

舉例來說，ceil(1.2f) 會傳回 2.f，而 ceil(-1.2f) 會傳回 -1.f。

另請參閱 floor()。

將值限制設為指定的高度與下限。如果值 < min_value 則會傳回 min_value，如果值 > max_value 則傳回 min_value，反之則傳回 min_value。

取值範圍有兩個變體：一個最小值和最大值是純量套用至值的所有項目，另一個是最小值和最大值的向量。

如果 min_value 大於 max_value，表示結果未定義。

傳回值中前置 0 位元的數目。

舉例來說，clz((char)0x03) 會傳回 6。

將正負號從 sign_value 複製到 magnitude_value。

傳回的值可以是 magnitude_value 或 -magnitude_value。

舉例來說，copysign(4.0f, -2.7f) 會傳回 -4.0f，而 copysign(-4.0f, 2.7f) 會傳回 4.0f。

傳回以弧度表示的角度餘弦值。

另請參閱 native_cos()。

傳回 v 的雙曲餘弦，其中 v 的計算單位為弧度。

另請參閱 native_cosh()。

傳回 (v * pi) 的餘弦，其中 (v * pi) 的單位為弧度。

如要取得測量值的餘弦值 (以度為單位)，請呼叫 cospi(v / 180.f)。

另請參閱 native_cospi()。

將弧度轉換成角度。

傳回錯誤函式。

傳回互補錯誤函式。

傳回 e，也就是 v，即 e ^ v。

另請參閱 native_exp()。

傳回 10 至 v，即 10.f ^ v。

另請參閱 native_exp10()。

傳回 2 到 v，即 2.f ^ v。

另請參閱 native_exp2()。

回傳 e 前提為 v 減 1，即 (e ^ v) - 1。

另請參閱 native_expm1()。

傳回浮點值 v 的絕對值。

如果是整數，請使用 abs()。

傳回兩個值之間的正差。

如果 a > b，會傳回 (a - b)，否則傳回 0f。

傳回不大於值的最小整數。

舉例來說，floor(1.2f) 會傳回 1.f，而 floor(-1.2f) 會傳回 -2.f。

另請參閱 ceil()。

乘法加乘。傳回 (multiplicand1 * multiplicand2) + offset。

這個函式與 mad() 類似。fma() 會保留乘法結果的完整精確度，且只會在加總後四捨五入。mad() 會在乘法和加法後無條件進位。在 rs_fp_relaxed 模式下，系統不保證能達到這項額外的精確度。

傳回 a 和 b 的最大值，例如：(a < b ? b : a)。

max() 函式傳回相同的結果，但可以套用至更多資料類型。

傳回 a 和 b 的最小值，例如 (a > b ? b : a)。

min() 函式會傳回相同的結果，但可以套用至更多資料類型。

傳回 (分子 / 分母) 的餘數，商數會四捨五入至零。

函式 remainder() 也是如此，但會四捨五入至最接近的整數。舉例來說，fmod(-3.8f, 2.f) 會傳回 -1.8f (-3.8f - -1.f * 2.f)，而 remainder(-3.8f, 2.f) 會傳回 0.2f (-3.8f - -2.f * 2.f)。

傳回 v 的正分數部分，例如 v - floor(v)。

舉例來說，fract(1.3f, &val) 會傳回 0.3f，並將 val 設為 1.f。fract(-1.3f, &val) 會傳回 0.7f，並將 val 設為 -2.f。

傳回二進位 mantisa 和 v 的指數，例如 v == mantissa * 2 ^ exponent。

空值永遠介於 0.5 (含) 和 1.0 (不含) 之間。

如要瞭解反向作業，請參閱 ldexp()。另請參閱 logb() 和 ilogb()。

傳回指定值的近似回流。

精確度為 16 位元的浮點值。

另請參閱 native_recip()。

傳回 (1.f / sqrt(value)) 的近似值。

精確度為 16 位元的浮點值。

另請參閱 rsqrt(), native_rsqrt()。

傳回指定值的近平方根。

精確度為 16 位元的浮點值。

另請參閱 sqrt()、native_sqrt()。

傳回假設，例如 sqrt(a * a + b * b)。

另請參閱 native_hypot()。

傳回指定值的兩個指數，其中 mantisa 介於 1.f (含) 和 2.f (不含) 之間。

舉例來說，ilogb(8.5f) 會回傳 3。

因為 Maantisa 之間的差異，這個數字小於 frexp() 傳回的數字。

logb() 類似，但會傳回浮點值。

傳回從定點和指數建立的浮點數，即 (mantissa * 2 ^ 指數)。

如要瞭解反向作業，請參閱 frexp()。

傳回 Gamma 函式絕對值的自然對數，例如 log(fabs(tgamma(v)))。

另請參閱 tgamma()。

傳回自然對數。

另請參閱 native_log()。

傳回以 10 為底數的對數。

另請參閱 native_log10()。

傳回 (v + 1.f) 的自然對數。

另請參閱 native_log1p()。

傳回以 2 為底數的對數。

另請參閱 native_log2()。

傳回指定值的兩個指數，其中 mantisa 介於 1.f (含) 和 2.f (不含) 之間。

舉例來說，logb(8.5f) 會傳回 3.f。

根據 mantisa 之間的差異，這個數字小於 frexp() 傳回的數字。

ilogb() 相似，但會傳回整數。

乘法加乘。傳回 (multiplicand1 * multiplicand2) + offset。

這個函式與 fma() 類似。fma() 會保留乘法結果的完整精確度，且只會在加總後四捨五入。mad() 會在乘法和加法後無條件進位。在 rs_fp_relaxed 模式下，mad() 可能無法在乘法後執行四捨五入。

傳回兩個引數的最大值。

傳回兩個引數的最小值。

傳回起始值 + ((停靠站 - 開始) * 分數)。

這對於混合兩個值非常實用。舉例來說，如要建立 40% 顏色 1 和 60% 顏色 2 的新顏色，請使用 mix(color1, color2, 0.6f)。

傳回指定數字的積分和分數元件。

這兩個元件的符號與 x 相同。例如，如果輸入的值是 -3.72f，*integral_part 會設為 -3.f，並傳回 .72f。

傳回 NaN 值 (不是數字)。

傳回半精度浮點 NaN 值 (不是數字)。

傳回近似反餘弦值，並以弧度表示。

這個函式會從小於 -1 或大於 1 的輸入值產生未定義的結果。

另請參閱 acos()。

傳回近似反雙曲線餘弦值，並以弧度表示。

另請參閱 acosh()。

傳回近似反餘弦值 (以弧度為單位) 除以 pi。

如要取得以度為單位的反餘弦值，請使用 acospi(a) * 180.f。

這個函式會從小於 -1 或大於 1 的輸入值產生未定義的結果。

另請參閱 acospi()。

傳回近似反正弦值，並以弧度表示。

這個函式會從小於 -1 或大於 1 的輸入值產生未定義的結果。

另請參閱 asin()。

傳回近似反雙曲線正弦值，並以弧度表示。

另請參閱 asinh()。

傳回近似反正弦值 (以弧度為單位) 除以 pi。

如要取得以度為單位的反正弦，請使用 asinpi(a) * 180.f。

這個函式會從小於 -1 或大於 1 的輸入值產生未定義的結果。

另請參閱 asinpi()。

傳回近似反正切值，並以弧度表示。

另請參閱 atan()。

傳回 (numerator / denominator) 的近似反正切值，並以弧度表示。

另請參閱 atan2()。

傳回 (numerator / denominator) 的近似反正切值，以弧度為單位除以 pi。

如要取得以度為單位的反正切值，請使用 atan2pi(n, d) * 180.f。

另請參閱 atan2pi()。

傳回近似反雙曲線正切值，並以弧度表示。

另請參閱 atanh()。

傳回近似反正切 (以弧度為單位) 除以 pi。

如要取得以度為單位的反正切值，請使用 atanpi(a) * 180.f。

另請參閱 atanpi()。

傳回近似立方根。

另請參閱 cbrt()。

傳回以弧度表示的角度近餘餘弦值。

另請參閱 cos()。

傳回近似雙曲線餘弦值。

另請參閱 cosh()。

傳回 (v * pi) 的近似餘弦，其中 (v * pi) 是以弧度為單位。

如要取得測量值的餘弦值 (以度為單位)，請呼叫 cospi(v / 180.f)。

另請參閱 cospi()。

計算兩個值的近似除法。

快速約略曝光。

對於 -86.f 到 86.f 之間的輸入值，這是有效視訊。精確度不低於使用 16 位元浮點值的情況。

另請參閱 exp()。

快速約 10。

對於 -37.f 到 37.f 之間的輸入，這是有效密碼。精確度不低於使用 16 位元浮點值的情況。

另請參閱 exp10()。

快速約 exp2。

對於 -125.f 到 125.f 之間的輸入值，這是有效密碼。精確度不低於使用 16 位元浮點值的情況。

另請參閱 exp2()。

傳回近似 (e ^ v) - 1。

另請參閱 expm1()。

傳回約略 native_sqrt(a * a + b * b)

另請參閱 hypot()。

快速的近似記錄。

如果值非常接近零，則不是準確的。

另請參閱 log()。

快速近似 log10。

如果值非常接近零，則不是準確的。

另請參閱 log10()。

傳回 (v + 1.0f) 的近似自然對數

另請參閱 log1p()。

快速近似 log2。

如果值非常接近零，則不是準確的。

另請參閱 log2()。

快速近似 (基數 ^ 指數)。

另請參閱 powr()。

傳回指定值的近似回合。

另請參閱 half_recip()。

計算指定值的近 N 次方根。

另請參閱 rootn()。

傳回近似值 (1 / sqrt(v))。

另請參閱 rsqrt(), half_rsqrt()。

傳回以弧度表示的角度近正正弦。

另請參閱 sin()。

傳回指定值的近正正弦和餘弦。

另請參閱 sincos()。

傳回指定值的近似雙曲正弦值，以弧度表示。

另請參閱 sinh()。

傳回 (v * pi) 的近正正弦，其中 (v * pi) 以弧度為單位。

如要取得測量值的正弦值 (以度為單位)，請呼叫 sinpi(v / 180.f)。

另請參閱 sinpi()。

傳回近似 sqrt(v)。

另請參閱 sqrt(), half_sqrt()。

傳回以弧度表示的角度近切正切值。

傳回指定值的近似雙曲正切值。

另請參閱 tanh()。

傳回 (v * pi) 的近正切值，其中 (v * pi) 是以弧度為單位。

如要取得測量值的正切值 (以度為單位)，請呼叫 tanpi(v / 180.f)。

另請參閱 tanpi()。

傳回從 v 朝目標邁進的下一個可代表浮點數。

在 rs_fp_relaxed 模式中，去正規化的輸入值可能無法產生下一個去正規化值，因為在放鬆模式中，您可以選擇是否要支援去正規化值。

回傳基數乘冪後的指數，即底數 ^ 指數。

pown() 和 powr()。pown() 採用整數指數。powr() 假設底數為非負數。

回傳基數乘冪後的指數，即底數 ^ 指數。

pow() 和 powr() 十分類似。兩者都會採用浮點指數，powr() 也會假設底數為非負數。

回傳基數做為指數，也就是底數 ^ 指數。底數必須大於或等於 0。

pow() 和 pown() 相似。兩者都不會對基底有任何假設。pow() 接受浮點指數，而 pown() 則採用整數。

另請參閱 native_powr()。

將角度轉換為弧度。

傳回 (分子 / 分母) 的餘數，商數會四捨五入至最接近的整數。

函式 fmod() 相似，但會無條件進位至最接近的整數。 舉例來說，fmod(-3.8f, 2.f) 會傳回 -1.8f (-3.8f - -1.f * 2.f)，而 remainder(-3.8f, 2.f) 會傳回 0.2f (-3.8f - -2.f * 2.f)。

傳回商數和餘數 (分子 / 分母)。

只有商號和最低三位元保證準確無誤。

這個函式適合用於實作定期函式。商的低三位元可提供象限和象限內的剩餘距離。舉例來說，實作 sin(x) 可以呼叫 remquo(x, PI / 2.f, &quadrant) 將非常大的 x 值縮減為限制範圍內的項目。

範例：remquo(-23.5f, 8.f, &quot) 將商的最小值三位元設為 3，而正負號設為負數。且會傳回 0.5f。

會四捨五入至最接近的整數。

rint() 會將半值四捨五入為偶數。舉例來說，rint(0.5f) 會傳回 0.f，rint(1.5f) 會傳回 2.f。同樣地，rint(-0.5f) 會傳回 -0.f，rint(-1.5f) 會傳回 -2.f。

round() 類似，但會四捨五入。trunc() 會截斷小數。

計算指定值的 N 次方根。

另請參閱 native_rootn()。

四捨五入至最接近的整數。

round() 將一半的值從零四捨五入。舉例來說，round(0.5f) 會傳回 1.f，round(1.5f) 會傳回 2.f。同樣地，round(-0.5f) 會傳回 -1.f，round(-1.5f) 會傳回 -2.f。

rint() 的計算方式十分類似，但會將一半的值四捨五入至偶數。trunc() 會截斷小數。