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⎤⎦⎥⎥⎥⎡⎣⎢⎢⎢N11N12N12N13N21N22N23N24N31N32N33N34N41N42N43N |