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; } |
Last modified 1yr ago