Utils

常量

常量
NetMode netMode 若当前脚本为服务端环境，值为NET_MODE_SERVER。 若当前脚本为客户端环境，值为NET_MODE_CLIENT。
double E = 2.71828175 自然常数
double LOG2E = 1.442695 以 2 为底 e 的对数
double LOG10E = 0.4342945 以 10 为底 e 的对数
double PI = 3.14159274 圆周率
double TWO_PI = 6.28318548 圆周率 x 2
double PI_OVER_2 = 1.57079637 圆周率 / 2
double PI_OVER_4 = 0.7853982 圆周率 / 4

函数

函数
int Utils.RandInt(int n) 若n大于0，返回[0, n)的随机整数，否则返回0。
int Utils.RandIntArea(int begin, int len) 若len大于0，返回[begin, begin + len)的随机整数，否则返回begin。
double Utils.RandDouble(double value) 若value大于0，返回[0, value)的随机浮点数，否则返回0。
double Utils.RandDoubleArea(double begin, double len) 若len大于0，返回[begin, begin + len)的随机浮点数，否则返回begin。
double Utils.RandSym(double value) 返回(-value, value)的随机浮点数。
bool Utils.RandTry(int n) 当n为正数时1/n概率返回true，否则始终返回false。 例1：Utils.RandTry(3)有1/3概率返回true。 例2：Utils.RandTry(2)有一半概率返回true。
int Utils.Cell(double a) 返回实际横/纵坐标对应的格子横/纵坐标。注意每个格子为16像素，实际结果为除以16后向下取整。
int Utils.PositiveMod(int a, int b) 返回a与b求余的非负数结果。 例1：Utils.PositiveMod(5, 3)返回2。 例2：Utils.PositiveMod(-5, 3)返回1。 int c = a % b; if (c < 0) c += b; return c;
int Utils.FloorDivide(int a, int b) 若b非0，返回a向下取整整除b的结果，否则返回0。 例1：Utils.FloorDivide(10, 3)返回3。 例2：Utils.FloorDivide(-4, 3)返回-2。 return a / b - ((a < 0 && a % b != 0) ? 1 : 0);
double Utils.SinValue(int phase, int period, int begin = 0) 返回以period为周期、以begin为初相位的正弦波在相位phase的值。 return sin(begin + 2 * PI * float(phase % period) / period);
double Utils.CosValue(int phase, int period, int begin = 0) 返回以period为周期、以begin为初相位的余弦波在相位phase的值。 return cos(begin + 2 * PI * float(phase % period) / period);
double Utils.ToTargetValue(double start, double target, double step) 返回start值往target值方向移动step长度的结果，若到达target值，则返回target值。 例1：Utils.ToTargetValue(1, 10, 5)返回6。 例2：Utils.ToTargetValue(6, 10, 5)返回10。 if (fabs(start - target) < step) start = target; else if (start > target) start -= step; else start += step; return start;
double Utils.GetPointsDistance(double x1, double y1, double x2, double y2) 返回点(x1, y1)到点(x2, y2)的距离。 例：Utils.GetPointsDistance(1.0,0.0,4.0,4.0)返回5.0。 return sqrt(pow((x1)-(x2), 2) + pow((y1)-(y2), 2));
double Utils.GetDistance(double x, double y) 返回点(x, y)到原点(0, 0)的距离。 例：Utils.GetDistance(3.0, 4.0)返回5.0。 return sqrt(pow(x, 2) + pow(y, 2));
double Utils.GetPointSegmentDistance(double x, double y, double x1, double y1, double x2, double y2) 返回点(x, y)到以点(x1, y1)和点(x2, y2)为两端点的线段的距离。 double cross = (x2 - x1) * (x - x1) + (y2 - y1) * (y - y1); if (cross <= 0) return sqrt((x - x1) * (x - x1) + (y - y1) * (y - y1)); double d2 = (x2 - x1) * (x2 - x1) + (y2 - y1) * (y2 - y1); if (cross >= d2) return sqrt((x - x2) * (x - x2) + (y - y2) * (y - y2)); double r = cross / d2; double px = x1 + (x2 - x1) * r; double py = y1 + (y2 - y1) * r; return sqrt((x - px) * (x - px) + (py - y) * (py - y));
double Utils.GetAngle(double x, double y) 返回向量(x, y)与横坐标的夹角。 例1：Utils.GetAngle(1, 1)返回π/4。 例2：Utils.GetAngle(0, 1)返回π/2。
double Utils.FixAngle(double angle) 将角度按2π周期增加或减少，返回最终限定在区间(-π, π]内的结果。 if (angle >= PI) angle -= 2 * PI * ceil((angle - PI) / (2 * PI)); else if (angle < -PI) angle += 2 * PI * ceil((-angle - PI) / (2 * PI)); return angle;
double, double Utils.GetXYFromPolar(double length, double angle) 将极坐标转换为直角坐标，返回横坐标和纵坐标。 x = length * cos(angle); y = length * sin(angle);
double, double Utils.RotateXY(double x, double y, double angle) 将点(x, y)绕原点旋转指定角度，返回旋转后的横坐标和纵坐标。 double dx = x, dy = y; x = dx * cos(angle) - dy * sin(angle); y = dx * sin(angle) + dy * cos(angle);
double, double Utils.SlowSpeed2D(double speedX, double speedY, double dec) 将一个二维速度(speedX, speedY)以恒定速度(dec)降低，返回新的横速度和纵速度。 double moveAngle = ut.getAngle(spx, spy); spx = ut.toTargetValue(spx, 0, cos(moveAngle)*dec); spy = ut.toTargetValue(spy, 0, sin(moveAngle)*dec);
double Utils.SlowSpeed1D(double speed, double dec) 将一个速度以恒定速度(dec)降低，返回新的速度。 return toTargetValue(speed, 0, dec);
double, double Utils.ForceSpeed2D(double speedX, double speedY, double force, double forceAngle, double maxSpeed) 将一个二维速度(speedX, speedY)进行受力，返回新的横速度和纵速度。 double forceX = force * cos(forceAngle); double forceY = force * sin(forceAngle); spx += forceX; spy += forceY; double moveAngle = GetAngle(spx, spy); double maxSpx = maxSpeed * cos(moveAngle); double maxSpy = maxSpeed * sin(moveAngle); if (maxSpx >= 0) { if (spx > maxSpx) spx = maxSpx; } else { if (spx < maxSpx) spx = maxSpx; } if (maxSpy >= 0) { if (spy > maxSpy) spy = maxSpy; } else { if (spy < maxSpy) spy = maxSpy; }