/* * Copyright (C) 2011-2012 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ /** @file rs_cl.rsh * \brief Basic math functions * * */ #ifndef __RS_CL_RSH__ #define __RS_CL_RSH__ // Conversions #define CVT_FUNC_2(typeout, typein) \ _RS_RUNTIME typeout##2 __attribute__((overloadable)) \ convert_##typeout##2(typein##2 v); \ _RS_RUNTIME typeout##3 __attribute__((overloadable)) \ convert_##typeout##3(typein##3 v); \ _RS_RUNTIME typeout##4 __attribute__((overloadable)) \ convert_##typeout##4(typein##4 v); #define CVT_FUNC(type) CVT_FUNC_2(type, uchar) \ CVT_FUNC_2(type, char) \ CVT_FUNC_2(type, ushort) \ CVT_FUNC_2(type, short) \ CVT_FUNC_2(type, uint) \ CVT_FUNC_2(type, int) \ CVT_FUNC_2(type, float) /** * Convert to char. * * Supports 2,3,4 components of uchar, char, ushort, short, uint, int, float. */ CVT_FUNC(char) /** * Convert to unsigned char. * * Supports 2,3,4 components of uchar, char, ushort, short, uint, int, float. */ CVT_FUNC(uchar) /** * Convert to short. * * Supports 2,3,4 components of uchar, char, ushort, short, uint, int, float. */ CVT_FUNC(short) /** * Convert to unsigned short. * * Supports 2,3,4 components of uchar, char, ushort, short, uint, int, float. */ CVT_FUNC(ushort) /** * Convert to int. * * Supports 2,3,4 components of uchar, char, ushort, short, uint, int, float. */ CVT_FUNC(int) /** * Convert to unsigned int. * * Supports 2,3,4 components of uchar, char, ushort, short, uint, int, float. */ CVT_FUNC(uint) /** * Convert to float. * * Supports 2,3,4 components of uchar, char, ushort, short, uint, int, float. */ CVT_FUNC(float) // Float ops, 6.11.2 #define FN_FUNC_FN(fnc) \ _RS_RUNTIME float2 __attribute__((overloadable)) fnc(float2 v); \ _RS_RUNTIME float3 __attribute__((overloadable)) fnc(float3 v); \ _RS_RUNTIME float4 __attribute__((overloadable)) fnc(float4 v); #define F_FUNC_FN(fnc) \ _RS_RUNTIME float __attribute__((overloadable)) fnc(float2 v); \ _RS_RUNTIME float __attribute__((overloadable)) fnc(float3 v); \ _RS_RUNTIME float __attribute__((overloadable)) fnc(float4 v); #define IN_FUNC_FN(fnc) \ _RS_RUNTIME int2 __attribute__((overloadable)) fnc(float2 v); \ _RS_RUNTIME int3 __attribute__((overloadable)) fnc(float3 v); \ _RS_RUNTIME int4 __attribute__((overloadable)) fnc(float4 v); #define FN_FUNC_FN_FN(fnc) \ _RS_RUNTIME float2 __attribute__((overloadable)) fnc(float2 v1, float2 v2); \ _RS_RUNTIME float3 __attribute__((overloadable)) fnc(float3 v1, float3 v2); \ _RS_RUNTIME float4 __attribute__((overloadable)) fnc(float4 v1, float4 v2); #define F_FUNC_FN_FN(fnc) \ _RS_RUNTIME float __attribute__((overloadable)) fnc(float2 v1, float2 v2); \ _RS_RUNTIME float __attribute__((overloadable)) fnc(float3 v1, float3 v2); \ _RS_RUNTIME float __attribute__((overloadable)) fnc(float4 v1, float4 v2); #define FN_FUNC_FN_F(fnc) \ _RS_RUNTIME float2 __attribute__((overloadable)) fnc(float2 v1, float v2); \ _RS_RUNTIME float3 __attribute__((overloadable)) fnc(float3 v1, float v2); \ _RS_RUNTIME float4 __attribute__((overloadable)) fnc(float4 v1, float v2); #define FN_FUNC_FN_IN(fnc) \ _RS_RUNTIME float2 __attribute__((overloadable)) fnc(float2 v1, int2 v2); \ _RS_RUNTIME float3 __attribute__((overloadable)) fnc(float3 v1, int3 v2); \ _RS_RUNTIME float4 __attribute__((overloadable)) fnc(float4 v1, int4 v2); \ #define FN_FUNC_FN_I(fnc) \ _RS_RUNTIME float2 __attribute__((overloadable)) fnc(float2 v1, int v2); \ _RS_RUNTIME float3 __attribute__((overloadable)) fnc(float3 v1, int v2); \ _RS_RUNTIME float4 __attribute__((overloadable)) fnc(float4 v1, int v2); #define FN_FUNC_FN_PFN(fnc) \ _RS_RUNTIME float2 __attribute__((overloadable)) \ fnc(float2 v1, float2 *v2); \ _RS_RUNTIME float3 __attribute__((overloadable)) \ fnc(float3 v1, float3 *v2); \ _RS_RUNTIME float4 __attribute__((overloadable)) \ fnc(float4 v1, float4 *v2); #define FN_FUNC_FN_PIN(fnc) \ _RS_RUNTIME float2 __attribute__((overloadable)) fnc(float2 v1, int2 *v2); \ _RS_RUNTIME float3 __attribute__((overloadable)) fnc(float3 v1, int3 *v2); \ _RS_RUNTIME float4 __attribute__((overloadable)) fnc(float4 v1, int4 *v2); #define FN_FUNC_FN_FN_FN(fnc) \ _RS_RUNTIME float2 __attribute__((overloadable)) \ fnc(float2 v1, float2 v2, float2 v3); \ _RS_RUNTIME float3 __attribute__((overloadable)) \ fnc(float3 v1, float3 v2, float3 v3); \ _RS_RUNTIME float4 __attribute__((overloadable)) \ fnc(float4 v1, float4 v2, float4 v3); #define FN_FUNC_FN_FN_F(fnc) \ _RS_RUNTIME float2 __attribute__((overloadable)) \ fnc(float2 v1, float2 v2, float v3); \ _RS_RUNTIME float3 __attribute__((overloadable)) \ fnc(float3 v1, float3 v2, float v3); \ _RS_RUNTIME float4 __attribute__((overloadable)) \ fnc(float4 v1, float4 v2, float v3); #define FN_FUNC_FN_F_F(fnc) \ _RS_RUNTIME float2 __attribute__((overloadable)) \ fnc(float2 v1, float v2, float v3); \ _RS_RUNTIME float3 __attribute__((overloadable)) \ fnc(float3 v1, float v2, float v3); \ _RS_RUNTIME float4 __attribute__((overloadable)) \ fnc(float4 v1, float v2, float v3); #define FN_FUNC_FN_FN_PIN(fnc) \ _RS_RUNTIME float2 __attribute__((overloadable)) \ fnc(float2 v1, float2 v2, int2 *v3); \ _RS_RUNTIME float3 __attribute__((overloadable)) \ fnc(float3 v1, float3 v2, int3 *v3); \ _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) /** * 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) /** * 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) /** * 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) /** * 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) /** * 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); /** * 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); /** * 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) /** * Return fractional part of v * * Supports float, float2, float3, float4. */ static inline float __attribute__((overloadable)) fract(float v) { float unused; return fract(v, &unused); } static inline float2 __attribute__((overloadable)) fract(float2 v) { float2 unused; return fract(v, &unused); } static inline float3 __attribute__((overloadable)) fract(float3 v) { float3 unused; return fract(v, &unused); } static inline float4 __attribute__((overloadable)) fract(float4 v) { float4 unused; return fract(v, &unused); } /** * 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) /** * 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) /** * 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) /** * 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) /** * 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) /** * 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) /** * 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); /** * 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) /** * Return (v ^ p). * * Supports 1,2,3,4 components */ _RS_RUNTIME float __attribute__((overloadable)) pown(float v, int 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); FN_FUNC_FN_FN(powr) /** * 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) /** * 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)). * * Supports 1,2,3,4 components */ _RS_RUNTIME float __attribute__((overloadable)) rsqrt(float v); FN_FUNC_FN(rsqrt) /** * 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); 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) /** * 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) #define XN_FUNC_YN(typeout, fnc, typein) \ extern typeout __attribute__((overloadable)) fnc(typein); \ _RS_RUNTIME typeout##2 __attribute__((overloadable)) fnc(typein##2 v); \ _RS_RUNTIME typeout##3 __attribute__((overloadable)) fnc(typein##3 v); \ _RS_RUNTIME typeout##4 __attribute__((overloadable)) fnc(typein##4 v); #define UIN_FUNC_IN(fnc) \ XN_FUNC_YN(uchar, fnc, char) \ XN_FUNC_YN(ushort, fnc, short) \ XN_FUNC_YN(uint, fnc, int) #define IN_FUNC_IN(fnc) \ XN_FUNC_YN(uchar, fnc, uchar) \ XN_FUNC_YN(char, fnc, char) \ XN_FUNC_YN(ushort, fnc, ushort) \ XN_FUNC_YN(short, fnc, short) \ XN_FUNC_YN(uint, fnc, uint) \ XN_FUNC_YN(int, fnc, int) #define XN_FUNC_XN_XN_BODY(type, fnc, body) \ _RS_RUNTIME type __attribute__((overloadable)) \ fnc(type v1, type v2); \ _RS_RUNTIME type##2 __attribute__((overloadable)) \ fnc(type##2 v1, type##2 v2); \ _RS_RUNTIME type##3 __attribute__((overloadable)) \ fnc(type##3 v1, type##3 v2); \ _RS_RUNTIME type##4 __attribute__((overloadable)) \ fnc(type##4 v1, type##4 v2); #define IN_FUNC_IN_IN_BODY(fnc, body) \ XN_FUNC_XN_XN_BODY(uchar, fnc, body) \ XN_FUNC_XN_XN_BODY(char, fnc, body) \ XN_FUNC_XN_XN_BODY(ushort, fnc, body) \ XN_FUNC_XN_XN_BODY(short, fnc, body) \ XN_FUNC_XN_XN_BODY(uint, fnc, body) \ XN_FUNC_XN_XN_BODY(int, fnc, body) \ XN_FUNC_XN_XN_BODY(float, fnc, body) /** * Return the absolute value of a value. * * Supports 1,2,3,4 components of char, short, int. */ UIN_FUNC_IN(abs) /** * Return the number of leading 0-bits in a value. * * Supports 1,2,3,4 components of uchar, char, ushort, short, uint, int. */ 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) /** * 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); FN_FUNC_FN_FN_FN(clamp) FN_FUNC_FN_F_F(clamp) /** * 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); FN_FUNC_FN_FN_FN(mix) FN_FUNC_FN_FN_F(mix) /** * 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); FN_FUNC_FN_FN(step) FN_FUNC_FN_F(step) // 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); extern float4 __attribute__((overloadable)) smoothstep(float4, float4, float4); extern float2 __attribute__((overloadable)) smoothstep(float, float, float2); extern float3 __attribute__((overloadable)) smoothstep(float, float, float3); extern float4 __attribute__((overloadable)) smoothstep(float, float, float4); /** * Return the sign of a value. * * 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) /** * 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); F_FUNC_FN_FN(dot) /** * Compute the length of a vector. * * Supports 1,2,3,4 components */ _RS_RUNTIME float __attribute__((overloadable)) length(float v); F_FUNC_FN(length) /** * Compute the distance between two points. * * Supports 1,2,3,4 components */ _RS_RUNTIME float __attribute__((overloadable)) distance(float lhs, float rhs); F_FUNC_FN_FN(distance) /** * Normalize a vector. * * Supports 1,2,3,4 components */ _RS_RUNTIME float __attribute__((overloadable)) normalize(float v); FN_FUNC_FN(normalize) // New approx API functions #if (defined(RS_VERSION) && (RS_VERSION >= 17)) /** * Return the approximate reciprocal of a value. * * Supports 1,2,3,4 components */ _RS_RUNTIME float __attribute__((overloadable)) half_recip(float); FN_FUNC_FN(half_recip) /** * Return the approximate square root of a value. * * Supports 1,2,3,4 components */ _RS_RUNTIME float __attribute__((overloadable)) half_sqrt(float); FN_FUNC_FN(half_sqrt) /** * Return the approximate value of (1 / sqrt(value)). * * Supports 1,2,3,4 components */ _RS_RUNTIME float __attribute__((overloadable)) half_rsqrt(float v); FN_FUNC_FN(half_rsqrt) /** * Compute the approximate length of a vector. * * Supports 1,2,3,4 components */ _RS_RUNTIME float __attribute__((overloadable)) fast_length(float v); F_FUNC_FN(fast_length) /** * Compute the approximate distance between two points. * * Supports 1,2,3,4 components */ _RS_RUNTIME float __attribute__((overloadable)) fast_distance(float lhs, float rhs); F_FUNC_FN_FN(fast_distance) /** * Approximately normalize a vector. * * Supports 1,2,3,4 components */ _RS_RUNTIME float __attribute__((overloadable)) fast_normalize(float v); F_FUNC_FN(fast_normalize) #endif // (defined(RS_VERSION) && (RS_VERSION >= 17)) #if (defined(RS_VERSION) && (RS_VERSION >= 18)) // Fast native math functions. /** * Fast approximate exp2 * valid for inputs -125.f to 125.f * Max 8192 ulps of error * * Supports 1,2,3,4 components */ _RS_RUNTIME float __attribute__((overloadable)) native_exp2(float v); FN_FUNC_FN(native_exp2) /** * Fast approximate exp * valid for inputs -86.f to 86.f * Max 8192 ulps of error * * Supports 1,2,3,4 components */ _RS_RUNTIME float __attribute__((overloadable)) native_exp(float v); FN_FUNC_FN(native_exp) /** * Fast approximate exp10 * valid for inputs -37.f to 37.f * Max 8192 ulps of error * * Supports 1,2,3,4 components */ _RS_RUNTIME float __attribute__((overloadable)) native_exp10(float v); FN_FUNC_FN(native_exp10) _RS_RUNTIME float __attribute__((overloadable)) native_log2(float v); FN_FUNC_FN(native_log2) _RS_RUNTIME float __attribute__((overloadable)) native_log(float v); FN_FUNC_FN(native_log) _RS_RUNTIME float __attribute__((overloadable)) native_log10(float v); FN_FUNC_FN(native_log10) _RS_RUNTIME float __attribute__((overloadable)) native_powr(float v, float y); FN_FUNC_FN_FN(native_powr) #endif // (defined(RS_VERSION) && (RS_VERSION >= 18)) #undef CVT_FUNC #undef CVT_FUNC_2 #undef FN_FUNC_FN #undef F_FUNC_FN #undef IN_FUNC_FN #undef FN_FUNC_FN_FN #undef F_FUNC_FN_FN #undef FN_FUNC_FN_F #undef FN_FUNC_FN_IN #undef FN_FUNC_FN_I #undef FN_FUNC_FN_PFN #undef FN_FUNC_FN_PIN #undef FN_FUNC_FN_FN_FN #undef FN_FUNC_FN_FN_F #undef FN_FUNC_FN_F_F #undef FN_FUNC_FN_FN_PIN #undef XN_FUNC_YN #undef UIN_FUNC_IN #undef IN_FUNC_IN #undef XN_FUNC_XN_XN_BODY #undef IN_FUNC_IN_IN_BODY #endif