RenderScript 数学常量和函数

圆周率的倒数，表示为 32 位浮点数。

2 除以圆周率，表示为 32 位浮点数。

2 除以圆周率的平方根，表示为 32 位浮点数。

数字 e，自然对数的底数，采用 32 位浮点数表示。

10 的自然对数，表示为 32 位浮点数。

2 的自然对数，表示为 32 位浮点数。

以 e 为底数为 10 的对数，表示为 32 位浮点数。

以 e 为底数的对数为 2，为 32 位浮点数。

圆周率常数，采用 32 位浮点数表示。

pi 除以 2，表示为 32 位浮点数。

pi 除以 4，表示为 32 位浮点数。

2 的平方根的倒数，表示为 32 位浮点数。

2 的平方根，采用 32 位浮点数。

返回整数的绝对值。

对于浮点数，请使用 fabs()。

返回反余弦值，以弧度表示。

另请参阅 native_acos()。

返回反双曲余弦值，以弧度表示。

另请参阅 native_acosh()。

返回用弧度除以圆周率的反余弦值。

如需获取以度为单位的反余弦值，请使用 acospi(a) * 180.f。

另请参阅 native_acospi()。

返回反正弦值，以弧度表示。

另请参阅 native_asin()。

返回反双曲正弦值，以弧度表示。

另请参阅 native_asinh()。

返回用弧度除以圆周率的反正弦值。

如需获取以度为单位的反正弦值，请使用 asinpi(a) * 180.f。

另请参阅 native_asinpi()。

返回反正切值，以弧度表示。

另请参阅 native_atan()。

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

另请参阅 native_atan2()。

返回 (numerator / denominator) 的反正切值，以弧度除以圆周率。

如需获取以度为单位的反正切值，请使用 atan2pi(n, d) * 180.f。

另请参阅 native_atan2pi()。

返回反双曲正切，以弧度表示。

另请参阅 native_atanh()。

返回弧度除以圆周率的反正切值。

如需获取以度为单位的反正切值，请使用 atanpi(a) * 180.f。

另请参阅 native_atanpi()。

返回立方根。

另请参阅 native_cbrt()。

返回不小于某个值的最小整数。

例如，ceil(1.2f) 会返回 2.f，而 ceil(-1.2f) 会返回 -1.f。

另请参阅 floor()。

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

clamp 有两种变体：一种是最小值和最大值是应用于值的所有条目的标量，另一种是最小值和最大值也是矢量。

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

从弧度转换为角度。

返回错误函数。

返回互补误差函数。

返回增加为 v 的 e，即 e ^ v。

另请参阅 native_exp()。

返回 10 增加到 v，即 10.f ^ v。

另请参阅 native_exp10()。

返回 2 增加到 v，即 2.f ^ v。

另请参阅 native_exp2()。

返回增加到 v 减 1 的 e，即 (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。

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

返回数值以二为底的指数，尾数介于 1.f（含）和 2.f（不含）之间。

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

由于尾数不同，此数字比 frexp() 返回的要小 1。

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

返回用尾数和指数创建的浮点数，即（尾数 * 2 ^ 指数）。

请参阅 frexp()，了解反向操作。

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

另请参阅 tgamma()。

返回自然对数。

另请参阅 native_log()。

返回以 10 为底的对数。

另请参阅 native_log10()。

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

另请参阅 native_log1p()。

返回以 2 为底的对数。

另请参阅 native_log2()。

返回数值以二为底的指数，尾数介于 1.f（含）和 2.f（不含）之间。

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

由于尾数不同，此数字比 frexp() 返回的要少 1。

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

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

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

返回两个参数的最大值。

返回两个参数的最小值。

返回开始 + ((停止 - 起始) * 分数)。

这在混合两个值时非常有用。例如，如需创建一个颜色为 40% 且颜色为 60% 的新颜色，请使用 mix(color1, color2, 0.6f)。

返回数值的积分分量和小数分量。

两个分量的符号与 x 相同。例如，对于 -3.72f 的输入，*integral_part 将设置为 -3.f，将返回 .72f。

返回 NaN 值（非数字）。

返回半精度浮点 NaN 值（非数字）。

返回近似的反余弦值，以弧度表示。

此函数会从小于 -1 或大于 1 的输入值中产生未定义的结果。

另请参阅 acos()。

返回近似双曲余弦值，以弧度表示。

另请参阅 acosh()。

返回近似反余弦值（以弧度为单位）除以圆周率。

如需获取以度为单位的反余弦值，请使用 acospi(a) * 180.f。

此函数会从小于 -1 或大于 1 的输入值中产生未定义的结果。

另请参阅 acospi()。

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

此函数会从小于 -1 或大于 1 的输入值中产生未定义的结果。

另请参阅 asin()。

返回近似的双曲正弦值，以弧度表示。

另请参阅 asinh()。

返回近似正弦值（以弧度为单位）除以圆周率。

如需获取以度为单位的反正弦值，请使用 asinpi(a) * 180.f。

此函数会从小于 -1 或大于 1 的输入值中产生未定义的结果。

另请参阅 asinpi()。

返回近似反正切，以弧度表示。

另请参阅 atan()。

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

另请参阅 atan2()。

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

如需获取以度为单位的反正切值，请使用 atan2pi(n, d) * 180.f。

另请参阅 atan2pi()。

返回近似的双曲正切，以弧度表示。

另请参阅 atanh()。

返回近似反正切值（以弧度除以圆周率）。

如需获取以度为单位的反正切值，请使用 atanpi(a) * 180.f。

另请参阅 atanpi()。

返回近似立方根。

另请参阅 cbrt()。

返回角度的近似余弦值（以弧度为单位）。

另请参阅 cos()。

返回近似双曲余弦值。

另请参阅 cosh()。

返回 (v * pi) 的近似余弦值，其中 (v * pi) 以弧度为单位。

如需获取以度为单位的值的余弦值，请调用 cospi(v / 180.f)。

另请参阅 cospi()。

计算两个值的近似除法。

快速近似体验

此类型适用于从 -86.f 到 86.f 的输入。精度并不比使用 16 位浮点值时的预期差很多。

另请参阅 exp()。

快速近似 exp10。

此类型适用于输入介于 -37.f 到 37.f 之间的值。精度并不比使用 16 位浮点值时的预期差很多。

另请参阅 exp10()。

快速近似体验 2。

此类型适用于从 -125.f 到 125.f 的输入。精度并不比使用 16 位浮点值时的预期差很多。

另请参阅 exp2()。

返回近似值 (e ^ v) - 1。

另请参阅 expm1()。

返回近似 native_sqrt(a * a + b * b)

另请参阅 hypot()。

快速记录近似值。

对于非常接近零的值，此值并不准确。

另请参阅 log()。

快速近似 log0。

对于非常接近零的值，此值并不准确。

另请参阅 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)。

返回商和余数（分子 / 分母）。

只有商的符号和最低三位可以保证准确。

此函数对于实现周期性函数非常有用。商的低 3 位表示象限，余下部分表示该象限内的距离。例如，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() 将一半的值向远离 0 的方向舍入。例如，round(0.5f) 会返回 1.f，而 round(1.5f) 会返回 2.f。同样，round(-0.5f) 会返回 -1.f，而 round(-1.5f) 会返回 -2.f。

rint() 与此类似，但会将一半的值四舍五入为偶数。trunc() 会截断十进制分数。