diff options
Diffstat (limited to 'libs/rs')
-rw-r--r-- | libs/rs/scriptc/rs_cl.rsh | 503 |
1 files changed, 451 insertions, 52 deletions
diff --git a/libs/rs/scriptc/rs_cl.rsh b/libs/rs/scriptc/rs_cl.rsh index e402b86..bbc8fc5 100644 --- a/libs/rs/scriptc/rs_cl.rsh +++ b/libs/rs/scriptc/rs_cl.rsh @@ -15,7 +15,7 @@ */ /** @file rs_cl.rsh - * \brief Additional compute routines + * \brief Basic math functions * * */ @@ -111,225 +111,555 @@ _RS_RUNTIME float4 __attribute__((overloadable)) \ fnc(float4 v1, float4 v2, int4 *v3); +/** + * Return the inverse cosine. + * + * Supports float, float2, float3, float4 + */ extern float __attribute__((overloadable)) acos(float); FN_FUNC_FN(acos) +/** + * Return the inverse hyperbolic cosine. + * + * Supports float, float2, float3, float4 + */ extern float __attribute__((overloadable)) acosh(float); FN_FUNC_FN(acosh) +/** + * Return the inverse cosine divided by PI. + * + * Supports float, float2, float3, float4 + */ _RS_RUNTIME float __attribute__((overloadable)) acospi(float v); - - FN_FUNC_FN(acospi) +/** + * Return the inverse sine. + * + * Supports float, float2, float3, float4 + */ extern float __attribute__((overloadable)) asin(float); FN_FUNC_FN(asin) +/** + * Return the inverse hyperbolic sine. + * + * Supports float, float2, float3, float4 + */ extern float __attribute__((overloadable)) asinh(float); FN_FUNC_FN(asinh) +/** + * Return the inverse sine divided by PI. + * + * Supports float, float2, float3, float4 + */ _RS_RUNTIME float __attribute__((overloadable)) asinpi(float v); FN_FUNC_FN(asinpi) +/** + * Return the inverse tangent. + * + * Supports float, float2, float3, float4 + */ extern float __attribute__((overloadable)) atan(float); FN_FUNC_FN(atan) -extern float __attribute__((overloadable)) atan2(float, float); +/** + * Return the inverse tangent of y / x. + * + * Supports float, float2, float3, float4. Both arguments must be of the same + * type. + * + * @param y + * @param x + */ +extern float __attribute__((overloadable)) atan2(float y, float x); FN_FUNC_FN_FN(atan2) +/** + * Return the inverse hyperbolic tangent. + * + * Supports float, float2, float3, float4 + */ extern float __attribute__((overloadable)) atanh(float); FN_FUNC_FN(atanh) - +/** + * Return the inverse tangent divided by PI. + * + * Supports float, float2, float3, float4 + */ _RS_RUNTIME float __attribute__((overloadable)) atanpi(float v); FN_FUNC_FN(atanpi) - +/** + * Return the inverse tangent of y / x, divided by PI. + * + * Supports float, float2, float3, float4. Both arguments must be of the same + * type. + * + * @param y + * @param x + */ _RS_RUNTIME float __attribute__((overloadable)) atan2pi(float y, float x); FN_FUNC_FN_FN(atan2pi) + +/** + * Return the cube root. + * + * Supports float, float2, float3, float4. + */ extern float __attribute__((overloadable)) cbrt(float); FN_FUNC_FN(cbrt) +/** + * Return the smallest integer not less than a value. + * + * Supports float, float2, float3, float4. + */ extern float __attribute__((overloadable)) ceil(float); FN_FUNC_FN(ceil) -extern float __attribute__((overloadable)) copysign(float, float); +/** + * Copy the sign bit from y to x. + * + * Supports float, float2, float3, float4. Both arguments must be of the same + * type. + * + * @param x + * @param y + */ +extern float __attribute__((overloadable)) copysign(float x, float y); FN_FUNC_FN_FN(copysign) +/** + * Return the cosine. + * + * Supports float, float2, float3, float4. + */ extern float __attribute__((overloadable)) cos(float); FN_FUNC_FN(cos) +/** + * Return the hypebolic cosine. + * + * Supports float, float2, float3, float4. + */ extern float __attribute__((overloadable)) cosh(float); FN_FUNC_FN(cosh) - +/** + * Return the cosine of the value * PI. + * + * Supports float, float2, float3, float4. + */ _RS_RUNTIME float __attribute__((overloadable)) cospi(float v); FN_FUNC_FN(cospi) +/** + * Return the complementary error function. + * + * Supports float, float2, float3, float4. + */ extern float __attribute__((overloadable)) erfc(float); FN_FUNC_FN(erfc) +/** + * Return the error function. + * + * Supports float, float2, float3, float4. + */ extern float __attribute__((overloadable)) erf(float); FN_FUNC_FN(erf) +/** + * Return e ^ value. + * + * Supports float, float2, float3, float4. + */ extern float __attribute__((overloadable)) exp(float); FN_FUNC_FN(exp) +/** + * Return 2 ^ value. + * + * Supports float, float2, float3, float4. + */ extern float __attribute__((overloadable)) exp2(float); FN_FUNC_FN(exp2) -extern float __attribute__((overloadable)) pow(float, float); +/** + * Return x ^ y. + * + * Supports float, float2, float3, float4. Both arguments must be of the same + * type. + */ +extern float __attribute__((overloadable)) pow(float x, float y); +FN_FUNC_FN_FN(pow) +/** + * Return 10 ^ value. + * + * Supports float, float2, float3, float4. + */ _RS_RUNTIME float __attribute__((overloadable)) exp10(float v); FN_FUNC_FN(exp10) +/** + * Return (e ^ value) - 1. + * + * Supports float, float2, float3, float4. + */ extern float __attribute__((overloadable)) expm1(float); FN_FUNC_FN(expm1) +/** + * Return the absolute value of a value. + * + * Supports float, float2, float3, float4. + */ extern float __attribute__((overloadable)) fabs(float); FN_FUNC_FN(fabs) +/** + * Return the positive difference between two values. + * + * Supports float, float2, float3, float4. Both arguments must be of the same + * type. + */ extern float __attribute__((overloadable)) fdim(float, float); FN_FUNC_FN_FN(fdim) +/** + * Return the smallest integer not greater than a value. + * + * Supports float, float2, float3, float4. + */ extern float __attribute__((overloadable)) floor(float); FN_FUNC_FN(floor) -extern float __attribute__((overloadable)) fma(float, float, float); +/** + * Return a*b + c. + * + * Supports float, float2, float3, float4. + */ +extern float __attribute__((overloadable)) fma(float a, float b, float c); FN_FUNC_FN_FN_FN(fma) -extern float __attribute__((overloadable)) fmax(float, float); +/** + * Return (x < y ? y : x) + * + * Supports float, float2, float3, float4. + * @param x: may be float, float2, float3, float4 + * @param y: may be float or vector. If vector must match type of x. + */ +extern float __attribute__((overloadable)) fmax(float x, float y); FN_FUNC_FN_FN(fmax); FN_FUNC_FN_F(fmax); -extern float __attribute__((overloadable)) fmin(float, float); +/** + * Return (x > y ? y : x) + * + * @param x: may be float, float2, float3, float4 + * @param y: may be float or vector. If vector must match type of x. + */ +extern float __attribute__((overloadable)) fmin(float x, float y); FN_FUNC_FN_FN(fmin); FN_FUNC_FN_F(fmin); -extern float __attribute__((overloadable)) fmod(float, float); +/** + * Return the remainder from x / y + * + * Supports float, float2, float3, float4. + */ +extern float __attribute__((overloadable)) fmod(float x, float y); FN_FUNC_FN_FN(fmod) +/** + * Return fractional part of v + * + * @param iptr iptr[0] will be set to the floor of the input value. + * Supports float, float2, float3, float4. + */ _RS_RUNTIME float __attribute__((overloadable)) fract(float v, float *iptr); FN_FUNC_FN_PFN(fract) -extern float __attribute__((overloadable)) frexp(float, int *); +/** + * Return the mantissa and place the exponent into iptr[0] + * + * @param v Supports float, float2, float3, float4. + * @param iptr Must have the same vector size as v. + */ +extern float __attribute__((overloadable)) frexp(float v, int *iptr); FN_FUNC_FN_PIN(frexp) -extern float __attribute__((overloadable)) hypot(float, float); +/** + * Return sqrt(x*x + y*y) + * + * Supports float, float2, float3, float4. + */ +extern float __attribute__((overloadable)) hypot(float x, float y); FN_FUNC_FN_FN(hypot) +/** + * Return the integer exponent of a value + * + * Supports 1,2,3,4 components + */ extern int __attribute__((overloadable)) ilogb(float); IN_FUNC_FN(ilogb) -extern float __attribute__((overloadable)) ldexp(float, int); +/** + * Return (x * 2^y) + * + * @param x Supports 1,2,3,4 components + * @param y Supports single component or matching vector. + */ +extern float __attribute__((overloadable)) ldexp(float x, int y); FN_FUNC_FN_IN(ldexp) FN_FUNC_FN_I(ldexp) +/** + * Return the log gamma + * + * Supports 1,2,3,4 components + */ extern float __attribute__((overloadable)) lgamma(float); FN_FUNC_FN(lgamma) -extern float __attribute__((overloadable)) lgamma(float, int*); + +/** + * Return the log gamma and sign + * + * @param x Supports 1,2,3,4 components + * @param y Supports matching vector. + */ +extern float __attribute__((overloadable)) lgamma(float x, int* y); FN_FUNC_FN_PIN(lgamma) +/** + * Return the natural logarithm + * + * Supports 1,2,3,4 components + */ extern float __attribute__((overloadable)) log(float); FN_FUNC_FN(log) - +/** + * Return the base 10 logarithm + * + * Supports 1,2,3,4 components + */ extern float __attribute__((overloadable)) log10(float); FN_FUNC_FN(log10) - +/** + * Return the base 2 logarithm + * + * Supports 1,2,3,4 components + */ _RS_RUNTIME float __attribute__((overloadable)) log2(float v); FN_FUNC_FN(log2) -extern float __attribute__((overloadable)) log1p(float); +/** + * Return the natural logarithm of (v + 1.0f) + * + * Supports 1,2,3,4 components + */ +extern float __attribute__((overloadable)) log1p(float v); FN_FUNC_FN(log1p) +/** + * Compute the exponent of the value. + * + * Supports 1,2,3,4 components + */ extern float __attribute__((overloadable)) logb(float); FN_FUNC_FN(logb) -extern float __attribute__((overloadable)) mad(float, float, float); +/** + * Compute (a * b) + c + * + * Supports 1,2,3,4 components + */ +extern float __attribute__((overloadable)) mad(float a, float b, float c); FN_FUNC_FN_FN_FN(mad) -extern float __attribute__((overloadable)) modf(float, float *); +/** + * Return the integral and fractional components of a number + * Supports 1,2,3,4 components + * + * @param x Source value + * @param iret iret[0] will be set to the integral portion of the number. + * @return The floating point portion of the value. + */ +extern float __attribute__((overloadable)) modf(float x, float *iret); FN_FUNC_FN_PFN(modf); //extern float __attribute__((overloadable)) nan(uint); -extern float __attribute__((overloadable)) nextafter(float, float); +/** + * Return the next floating point number from x towards y. + * + * Supports 1,2,3,4 components + */ +extern float __attribute__((overloadable)) nextafter(float x, float y); FN_FUNC_FN_FN(nextafter) -FN_FUNC_FN_FN(pow) - +/** + * Return (v ^ p). + * + * Supports 1,2,3,4 components + */ _RS_RUNTIME float __attribute__((overloadable)) pown(float v, int p); -_RS_RUNTIME float2 __attribute__((overloadable)) pown(float2 v, int2 p); -_RS_RUNTIME float3 __attribute__((overloadable)) pown(float3 v, int3 p); -_RS_RUNTIME float4 __attribute__((overloadable)) pown(float4 v, int4 p); +FN_FUNC_FN_IN(pown) +/** + * Return (v ^ p). + * @param v must be greater than 0. + * + * Supports 1,2,3,4 components + */ _RS_RUNTIME float __attribute__((overloadable)) powr(float v, float p); -_RS_RUNTIME float2 __attribute__((overloadable)) powr(float2 v, float2 p); -_RS_RUNTIME float3 __attribute__((overloadable)) powr(float3 v, float3 p); -_RS_RUNTIME float4 __attribute__((overloadable)) powr(float4 v, float4 p); +FN_FUNC_FN_FN(powr) -extern float __attribute__((overloadable)) remainder(float, float); +/** + * Return round x/y to the nearest integer then compute the remander. + * + * Supports 1,2,3,4 components + */ +extern float __attribute__((overloadable)) remainder(float x, float y); FN_FUNC_FN_FN(remainder) +// document once we know the precision of bionic extern float __attribute__((overloadable)) remquo(float, float, int *); FN_FUNC_FN_FN_PIN(remquo) +/** + * Round to the nearest integral value. + * + * Supports 1,2,3,4 components + */ extern float __attribute__((overloadable)) rint(float); FN_FUNC_FN(rint) +/** + * Compute the Nth root of a value. + * + * Supports 1,2,3,4 components + */ +_RS_RUNTIME float __attribute__((overloadable)) rootn(float v, int n); +FN_FUNC_FN_IN(rootn) -_RS_RUNTIME float __attribute__((overloadable)) rootn(float v, int r); -_RS_RUNTIME float2 __attribute__((overloadable)) rootn(float2 v, int2 r); -_RS_RUNTIME float3 __attribute__((overloadable)) rootn(float3 v, int3 r); -_RS_RUNTIME float4 __attribute__((overloadable)) rootn(float4 v, int4 r); - - +/** + * Round to the nearest integral value. Half values are rounded away from zero. + * + * Supports 1,2,3,4 components + */ extern float __attribute__((overloadable)) round(float); FN_FUNC_FN(round) - +/** + * Return the square root of a value. + * + * Supports 1,2,3,4 components + */ extern float __attribute__((overloadable)) sqrt(float); +FN_FUNC_FN(sqrt) + +/** + * Return (1 / sqrt(value)). + * + * @param v The incoming value in radians + * Supports 1,2,3,4 components + */ _RS_RUNTIME float __attribute__((overloadable)) rsqrt(float v); FN_FUNC_FN(rsqrt) -extern float __attribute__((overloadable)) sin(float); +/** + * Return the sine of a value specified in radians. + * + * @param v The incoming value in radians + * Supports 1,2,3,4 components + */ +extern float __attribute__((overloadable)) sin(float v); FN_FUNC_FN(sin) +/** + * Return the sine and cosine of a value. + * + * @return sine + * @param v The incoming value in radians + * @param *cosptr cosptr[0] will be set to the cosine value. + * + * Supports 1,2,3,4 components + */ _RS_RUNTIME float __attribute__((overloadable)) sincos(float v, float *cosptr); -_RS_RUNTIME float2 __attribute__((overloadable)) sincos(float2 v, float2 *cosptr); -_RS_RUNTIME float3 __attribute__((overloadable)) sincos(float3 v, float3 *cosptr); -_RS_RUNTIME float4 __attribute__((overloadable)) sincos(float4 v, float4 *cosptr); +FN_FUNC_FN_PFN(sincos); +/** + * Return the hyperbolic sine of a value specified in radians. + * + * Supports 1,2,3,4 components + */ extern float __attribute__((overloadable)) sinh(float); FN_FUNC_FN(sinh) +/** + * Return the sin(v * PI). + * + * Supports 1,2,3,4 components + */ _RS_RUNTIME float __attribute__((overloadable)) sinpi(float v); FN_FUNC_FN(sinpi) -FN_FUNC_FN(sqrt) - -extern float __attribute__((overloadable)) tan(float); +/** + * Return the tangent of a value. + * + * Supports 1,2,3,4 components + * @param v The incoming value in radians + */ +extern float __attribute__((overloadable)) tan(float v); FN_FUNC_FN(tan) +/** + * Return the hyperbolic tangent of a value. + * + * Supports 1,2,3,4 components + * @param v The incoming value in radians + */ extern float __attribute__((overloadable)) tanh(float); FN_FUNC_FN(tanh) +/** + * Return tan(v * PI) + * + * Supports 1,2,3,4 components + */ _RS_RUNTIME float __attribute__((overloadable)) tanpi(float v); FN_FUNC_FN(tanpi) - +/** + * Compute the gamma function of a value. + * + * Supports 1,2,3,4 components + */ extern float __attribute__((overloadable)) tgamma(float); FN_FUNC_FN(tgamma) +/** + * Round to integral using truncation. + * + * Supports 1,2,3,4 components + */ extern float __attribute__((overloadable)) trunc(float); FN_FUNC_FN(trunc) -// Int ops (partial), 6.11.3 #define XN_FUNC_YN(typeout, fnc, typein) \ extern typeout __attribute__((overloadable)) fnc(typein); \ @@ -373,14 +703,29 @@ XN_FUNC_XN_XN_BODY(float, fnc, body) UIN_FUNC_IN(abs) IN_FUNC_IN(clz) +/** + * Return the minimum of two values. + * + * Supports 1,2,3,4 components of uchar, char, ushort, short, uint, int, float. + */ IN_FUNC_IN_IN_BODY(min, (v1 < v2 ? v1 : v2)) FN_FUNC_FN_F(min) +/** + * Return the maximum of two values. + * + * Supports 1,2,3,4 components of uchar, char, ushort, short, uint, int, float. + */ IN_FUNC_IN_IN_BODY(max, (v1 > v2 ? v1 : v2)) FN_FUNC_FN_F(max) -// 6.11.4 - +/** + * Clamp a value to a specified high and low bound. + * + * @param amount value to be clamped. Supports 1,2,3,4 components + * @param low Lower bound, must be scalar or matching vector. + * @param high High bound, must match type of low + */ _RS_RUNTIME float __attribute__((overloadable)) clamp(float amount, float low, float high); _RS_RUNTIME float2 __attribute__((overloadable)) clamp(float2 amount, float2 low, float2 high); _RS_RUNTIME float3 __attribute__((overloadable)) clamp(float3 amount, float3 low, float3 high); @@ -389,9 +734,19 @@ _RS_RUNTIME float2 __attribute__((overloadable)) clamp(float2 amount, float low, _RS_RUNTIME float3 __attribute__((overloadable)) clamp(float3 amount, float low, float high); _RS_RUNTIME float4 __attribute__((overloadable)) clamp(float4 amount, float low, float high); +/** + * Convert from radians to degrees. + * + * Supports 1,2,3,4 components + */ _RS_RUNTIME float __attribute__((overloadable)) degrees(float radians); FN_FUNC_FN(degrees) +/** + * return start + ((stop - start) * amount); + * + * Supports 1,2,3,4 components + */ _RS_RUNTIME float __attribute__((overloadable)) mix(float start, float stop, float amount); _RS_RUNTIME float2 __attribute__((overloadable)) mix(float2 start, float2 stop, float2 amount); _RS_RUNTIME float3 __attribute__((overloadable)) mix(float3 start, float3 stop, float3 amount); @@ -400,9 +755,22 @@ _RS_RUNTIME float2 __attribute__((overloadable)) mix(float2 start, float2 stop, _RS_RUNTIME float3 __attribute__((overloadable)) mix(float3 start, float3 stop, float amount); _RS_RUNTIME float4 __attribute__((overloadable)) mix(float4 start, float4 stop, float amount); +/** + * Convert from degrees to radians. + * + * Supports 1,2,3,4 components + */ _RS_RUNTIME float __attribute__((overloadable)) radians(float degrees); FN_FUNC_FN(radians) +/** + * if (v < edge) + * return 0.f; + * else + * return 1.f; + * + * Supports 1,2,3,4 components + */ _RS_RUNTIME float __attribute__((overloadable)) step(float edge, float v); _RS_RUNTIME float2 __attribute__((overloadable)) step(float2 edge, float2 v); _RS_RUNTIME float3 __attribute__((overloadable)) step(float3 edge, float3 v); @@ -411,6 +779,7 @@ _RS_RUNTIME float2 __attribute__((overloadable)) step(float2 edge, float v); _RS_RUNTIME float3 __attribute__((overloadable)) step(float3 edge, float v); _RS_RUNTIME float4 __attribute__((overloadable)) step(float4 edge, float v); +// not implemented extern float __attribute__((overloadable)) smoothstep(float, float, float); extern float2 __attribute__((overloadable)) smoothstep(float2, float2, float2); extern float3 __attribute__((overloadable)) smoothstep(float3, float3, float3); @@ -419,29 +788,59 @@ extern float2 __attribute__((overloadable)) smoothstep(float, float, float2); extern float3 __attribute__((overloadable)) smoothstep(float, float, float3); extern float4 __attribute__((overloadable)) smoothstep(float, float, float4); +/** + * if (v < 0) return -1.f; + * else if (v > 0) return 1.f; + * else return 0.f; + * + * Supports 1,2,3,4 components + */ _RS_RUNTIME float __attribute__((overloadable)) sign(float v); FN_FUNC_FN(sign) -// 6.11.5 +/** + * Compute the cross product of two vectors. + * + * Supports 3,4 components + */ _RS_RUNTIME float3 __attribute__((overloadable)) cross(float3 lhs, float3 rhs); - _RS_RUNTIME float4 __attribute__((overloadable)) cross(float4 lhs, float4 rhs); +/** + * Compute the dot product of two vectors. + * + * Supports 1,2,3,4 components + */ _RS_RUNTIME float __attribute__((overloadable)) dot(float lhs, float rhs); _RS_RUNTIME float __attribute__((overloadable)) dot(float2 lhs, float2 rhs); _RS_RUNTIME float __attribute__((overloadable)) dot(float3 lhs, float3 rhs); _RS_RUNTIME float __attribute__((overloadable)) dot(float4 lhs, float4 rhs); +/** + * Compute the length of a vector. + * + * Supports 1,2,3,4 components + */ _RS_RUNTIME float __attribute__((overloadable)) length(float v); _RS_RUNTIME float __attribute__((overloadable)) length(float2 v); _RS_RUNTIME float __attribute__((overloadable)) length(float3 v); _RS_RUNTIME float __attribute__((overloadable)) length(float4 v); +/** + * Compute the distance between two points. + * + * Supports 1,2,3,4 components + */ _RS_RUNTIME float __attribute__((overloadable)) distance(float lhs, float rhs); _RS_RUNTIME float __attribute__((overloadable)) distance(float2 lhs, float2 rhs); _RS_RUNTIME float __attribute__((overloadable)) distance(float3 lhs, float3 rhs); _RS_RUNTIME float __attribute__((overloadable)) distance(float4 lhs, float4 rhs); +/** + * Normalize a vector. + * + * Supports 1,2,3,4 components + */ _RS_RUNTIME float __attribute__((overloadable)) normalize(float v); _RS_RUNTIME float2 __attribute__((overloadable)) normalize(float2 v); _RS_RUNTIME float3 __attribute__((overloadable)) normalize(float3 v); |