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()。

将值限制到指定的上下界。如果 value < min_value，clamp() 返回 min_value；如果 value > max_value，则返回 max_value；否则返回 value。

clamp 有两种变体：一种是 min 和 max 是应用于 value 所有条目的标量，另一种是 min 和 max 也是向量。

如果 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() 函数返回相同的结果，但可应用于更多数据类型。

返回 (numerator / denominator) 的余数，其中商向零舍入。

函数 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。

返回 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()。

返回值的以 2 为底的指数，其中尾数在 1.f（包含）和 2.f（不包含）之间。

例如，ilogb(8.5f) 返回 3。

由于尾数的差异，此数字比 frexp() 返回的数字小 1。

logb() 类似，但返回一个浮点数。

返回由尾数和指数创建的浮点数，即 (mantissa * 2 ^ exponent)。

有关逆运算，请参阅 frexp()。

返回 Gamma 函数绝对值的自然对数，即 log(fabs(tgamma(v)))。

另请参阅 tgamma()。

返回自然对数。

另请参阅 native_log()。

返回以 10 为底的对数。

另请参阅 native_log10()。

返回 (v + 1.f) 的自然对数。

另请参阅 native_log1p()。

返回以 2 为底的对数。

另请参阅 native_log2()。

返回值的以 2 为底的指数，其中尾数在 1.f（包含）和 2.f（不包含）之间。

例如，logb(8.5f) 返回 3.f。

由于尾数的差异，此数字比 frexp() 返回的数字小 1。

ilogb() 类似，但返回一个整数。

乘加。返回 (multiplicand1 * multiplicand2) + offset。

此函数类似于 fma()。fma() 保留乘法结果的完整精度，并且仅在加法后进行舍入。mad() 在乘法和加法后进行舍入。在 rs_fp_relaxed 模式下，mad() 可能不会在乘法后进行舍入。

返回两个参数的最大值。

返回两个参数的最小值。

返回 start + ((stop - start) * fraction)。

这对于混合两个值很有用。例如，要创建一个新颜色，其中 40% 来自 color1，60% 来自 color2，请使用 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()。

计算两个值的近似除法。

快速近似 exp。

对于介于 -86.f 和 86.f 之间的输入有效。精度不会比使用 16 位浮点数预期的精度更差。

另请参阅 exp()。

快速近似 exp10。

对于介于 -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()。

快速近似 (base ^ exponent)。

另请参阅 powr()。

返回某个值的近似倒数。

另请参阅 half_recip()。

计算某个值的近似 Nth 根。

另请参阅 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 到 target 方向上的下一个可表示浮点数。

在 rs_fp_relaxed 模式下，非规范化输入值可能不会产生下一个非规范化值，因为在 relaxed 模式下支持非规范化值是可选的。

返回底数的指数幂，即 base ^ exponent。

pown() 和 powr() 类似。pown() 接受整数指数。powr() 假定底数为非负数。

返回底数的指数幂，即 base ^ exponent。

pow() 和 powr() 类似。它们都接受浮点指数。powr() 也假定底数为非负数。

返回底数的指数幂，即 base ^ exponent。base 必须 >= 0。

pow() 和 pown() 类似。它们都对底数不做任何假定。pow() 接受浮点指数，而 pown() 接受整数。

另请参阅 native_powr()。

将角度从度转换为弧度。

返回 (numerator / denominator) 的余数，其中商会四舍五入到最近的整数。

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)。

返回 (numerator / denominator) 的商和余数。

只保证商的符号和最低三位是准确的。

此函数对于实现周期函数非常有用。商的低三位表示象限，余数表示象限内的距离。例如，sin(x) 的实现可以调用 remquo(x, PI / 2.f, &quadrant) 将很大的 x 值减小到有限范围内的值。

示例：remquo(-23.5f, 8.f, &quot) 将 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() 截断小数部分。