首页 > 代码库 > CG 标准函数库
CG 标准函数库
（1）数学函数
| 函数 | 功能描述 |
|---|---|
| abs(x) | 返回输入参数的绝对值 |
| acos(x) | 反余切函数，输入参数范围为[-1,1]， 返回[0,π]区间的角度值 |
| all(x) | 如果输入参数均不为0，则返回ture； 否则返回flase。&&运算 |
| any(x) | 输入参数只要有其中一个不为0，则返回true。 |
| asin(x) | 反正弦函数,输入参数取值区间为[−1,1]，返回角度值范围为, [−π2,π2] |
| atan(x) | 反正切函数，返回角度值范围为[−π2,π2] |
| atan2(y,x) | 计算y/x的反正切值。实际上和atan(x)函数功能完全一样，至少输入参数不同。atan(x) = atan2(x, float(1))。 |
| ceil(x) | 对输入参数向上取整。例如： ceil(float(1.3)) ，其返回值为2.0 |
| clamp(x,a,b) | 如果x值小于a，则返回a； 如果x值大于b，返回b； 否则，返回x。 |
| cos(x) | 返回弧度x的余弦值。返回值范围为[−1,1] |
| cosh(x) | 双曲余弦（hyperbolic cosine）函数，计算x的双曲余弦值。 |
| cross(A,B) | 返回两个三元向量的叉积(cross product)。注意，输入参数必须是三元向量！ |
| degrees(x) | 输入参数为弧度值(radians)，函数将其转换为角度值(degrees) |
| determinant(m) | 计算矩阵的行列式因子。 |
| dot(A,B) | 返回A和B的点积(dot product)。参数A和B可以是标量，也可以是向量（输入参数方面，点积和叉积函数有很大不同）。 |
| exp(x) | 计算ex的值，e=2.71828182845904523536 |
| exp2(x) | 计算2x的值 |
| floor(x) | 对输入参数向下取整。例如floor(float(1.3))返回的值为1.0；但是floor(float(-1.3))返回的值为-2.0。该函数与ceil(x)函数相对应。 |
| fmod(x,y) | 返回x/y的余数。如果y为0，结果不可预料。 |
| frac(x) | 返回标量或矢量的小数 |
| frexp(x, out i) | 将浮点数x分解为尾数和指数，即x=m∗2i， 返回m，并将指数存入i中；如果x为0，则尾数和指数都返回0 |
| isfinite(x) | 判断标量或者向量中的每个数据是否是有限数，如果是返回true；否则返回false; |
| isinf(x) | 判断标量或者向量中的每个数据是否是无限，如果是返回true；否则返回false; |
| isnan(x) | 判断标量或者向量中的每个数据是否是非数据(not-a-number NaN)，如果是返回true；否则返回false; |
| ldexp(x, n) | 计算x∗2n的值 |
| lerp(a, b, f) | 计算(1−f)∗a+b∗f或者a+f∗(b−a)的值。即在下限a和上限b之间进行插值，f表示权值。注意，如果a和b是向量，则权值f必须是标量或者等长的向量。 |
| lit(NdotL, NdotH, m) | N表示法向量； L表示入射光向量； H表示半角向量； m表示高光系数。 函数计算环境光、散射光、镜面光的贡献，返回的4元向量。 X位表示环境光的贡献，总是1.0; Y位代表散射光的贡献，如果 N?L<0，则为0；否则为N?L Z位代表镜面光的贡献，如果N?L<0 或者N?H<0，则位0；否则为(N?L)m; W位始终位1.0 |
| log(x) | 计算ln(x)的值，x必须大于0 |
| log2(x) | 计算log(x)2的值，x必须大于0 |
| log10(x) | 计算log(x)10的值，x必须大于0 |
| max(a, b) | 比较两个标量或等长向量元素，返回最大值。 |
| min(a,b) | 比较两个标量或等长向量元素，返回最小值。 |
| modf(x, out ip) | 把x分解成整数和分数两部分，每部分都和x有着相同的符号，整数部分被保存在ip中，分数部分由函数返回 |
| mul(M, N) | 矩阵M和矩阵N的积，计算方法如下 mul(M,N)=?????M11M12M13M14M21M22M23M24M31M32M33M34M41M42M43M44??????????N11N12N12N13N21N22N23N24N31N32N33N34N41N42N43N44 |