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;
}