--- title: "数学 Math" description: "数学 / 随机 / 位运算" --- --- title: 数学 Math description: 数学 / 随机 / 位运算 --- `sa` · 扩展 `default` · SCM 原生命令共 38 条。写法见 [Lua](/docs/cleo/syntax) / [Redux](/docs/cleo/syntax-redux)。 ## 全局整型绝对值全局整型取绝对值（就地）。 ```text 0094 ABS_VAR_INT out: number ``` ```lua local number = absVarInt() ``` ```js Math.abs() ``` ## 局部整型绝对值局部整型取绝对值（就地）。 ```text 0095 ABS_LVAR_INT out: number ``` ```lua local number = absLvarInt() ``` ```js Math.abs() ``` ## 全局浮点绝对值全局浮点取绝对值（就地）。 ```text 0096 ABS_VAR_FLOAT out: number ``` ```lua local number = absVarFloat() ``` ```js Math.abs() ``` ## 局部浮点绝对值局部浮点取绝对值（就地）。 ```text 0097 ABS_LVAR_FLOAT out: number ``` ```lua local number = absLvarFloat() ``` ```js Math.abs() ``` ## 随机浮点随机浮点 `[0.0, 1.0)`。 ```text 0098 GENERATE_RANDOM_FLOAT out: float ``` ```lua local float = generateRandomFloat() ``` ```js Math.random() ``` ## 随机整型随机整型 `0..32767`。 ```text 0099 GENERATE_RANDOM_INT out: int ``` ```lua local int = generateRandomInt() ``` ```js Math.random() ``` ## 平方根平方根。 ```text 01FB SQRT in: num out: result ``` ```lua local result = sqrt(num) ``` ```js Math.sqrt(num) ``` ## 区间随机浮点区间内随机浮点，含 min/max。 ```text 0208 GENERATE_RANDOM_FLOAT_IN_RANGE in: min, max out: result ``` ```lua local result = generateRandomFloatInRange(min, max) ``` ```js Math.randomFloatInRange(min, max) ``` ## 区间随机整型区间内随机整型，含 min、不含 max。 ```text 0209 GENERATE_RANDOM_INT_IN_RANGE in: min, max out: result ``` ```lua local result = generateRandomIntInRange(min, max) ``` ```js Math.randomIntInRange(min, max) ``` ## 正弦正弦（角）。 ```text 02F6 SIN in: angle out: result ``` ```lua local result = sin(angle) ``` ```js Math.sin(angle) ``` ## 余弦余弦（角）。 ```text 02F7 COS in: angle out: result ``` ```lua local result = cos(angle) ``` ```js Math.cos(angle) ``` ## 米转英尺米 → 英尺（浮点）。 ```text 0425 CONVERT_METRES_TO_FEET in: meters out: feet ``` ```lua local feet = convertMetresToFeet(meters) ``` ```js Math.convertMetersToFeet(meters) ``` ## 米转英尺整型米 → 英尺（整型）。 ```text 042D CONVERT_METRES_TO_FEET_INT in: meters out: feet ``` ```lua local feet = convertMetresToFeetInt(meters) ``` ```js Math.convertMetersToFeet(meters) ``` ## 2D 距离两点 2D 距离。 ```text 0509 GET_DISTANCE_BETWEEN_COORDS_2D in: fromX, fromY, toX, toZ out: distance ``` ```lua local distance = getDistanceBetweenCoords2D(fromX, fromY, toX, toZ) ``` ```js Math.getDistanceBetweenCoords2D(fromX, fromY, toX, toZ) ``` ## 3D 距离两点 3D 距离。 ```text 050A GET_DISTANCE_BETWEEN_COORDS_3D in: fromX, fromY, fromZ, toX, toY, toZ out: distance ``` ```lua local distance = getDistanceBetweenCoords3D(fromX, fromY, fromZ, toX, toY, toZ) ``` ```js Math.getDistanceBetweenCoords3D(fromX, fromY, fromZ, toX, toY, toZ) ``` ## 2D 向量夹角两 2D 向量夹角。 ```text 05A4 GET_ANGLE_BETWEEN_2D_VECTORS in: x1, y1, x2, y2 out: angle ``` ```lua local angle = getAngleBetween2DVectors(x1, y1, x2, y2) ``` ```js Math.getAngleBetween2DVectors(x1, y1, x2, y2) ``` ## 2D 矩形相交用在 if：两 2D 矩形是否相交/包含。 ```text 05A5 DO_2D_RECTANGLES_COLLIDE in: rectangle1PositionX, rectangle1PositionY, rectangle1SizeX, rectangle1SizeY, rectangle2PositionX, rectangle2PositionY, rectangle2SizeX, rectangle2SizeY ``` ```lua do2DRectanglesCollide(rectangle1PositionX, rectangle1PositionY, rectangle1SizeX, rectangle1SizeY, rectangle2PositionX, rectangle2PositionY, rectangle2SizeX, rectangle2SizeY) ``` ```js Math.do2DRectanglesCollide(rectangle1PositionX, rectangle1PositionY, rectangle1SizeX, rectangle1SizeY, rectangle2PositionX, rectangle2PositionY, rectangle2SizeX, rectangle2SizeY) ``` ## 2D 线段交点两线段交点；不相交时返回 -1000000.0 且条件假。 ```text 05B0 GET_2D_LINES_INTERSECT_POINT in: line1StartX, line1StartY, line1EndX, line1EndY, line2StartX, line2StartY, line2EndX, line2EndY out: intersectPointX, intersectPointY ``` ```lua local intersectPointX, intersectPointY = get2DLinesIntersectPoint(line1StartX, line1StartY, line1EndX, line1EndY, line2StartX, line2StartY, line2EndX, line2EndY) ``` ```js Math.get2DLinesIntersectPoint(line1StartX, line1StartY, line1EndX, line1EndY, line2StartX, line2StartY, line2EndX, line2EndY) ``` ## 向量朝向角 XY 偏移换朝向角。 ```text 0604 GET_HEADING_FROM_VECTOR_2D in: x, y out: heading ``` ```lua local heading = getHeadingFromVector2D(x, y) ``` ```js Math.getHeadingFromVector2D(x, y) ``` ## 角度归一角度归一到有效范围。 ```text 0656 LIMIT_ANGLE in: value out: result ``` ```lua local result = limitAngle(value) ``` ```js Math.limitAngle(value) ``` ## 位是否置位全局·常量用在 if：数的第 n 位是否置位（全局·常量位）。 ```text 08B4 IS_GLOBAL_VAR_BIT_SET_CONST in: number, bitIndex ``` ```lua isGlobalVarBitSetConst(number, bitIndex) ``` ```js Math.isBitSet(number, bitIndex) ``` ## 位是否置位全局·变量用在 if：数的第 n 位是否置位（全局·变量位）。 ```text 08B5 IS_GLOBAL_VAR_BIT_SET_VAR in: number, bitIndex ``` ```lua isGlobalVarBitSetVar(number, bitIndex) ``` ```js Math.isBitSet(number, bitIndex) ``` ## 位是否置位全局·局部用在 if：数的第 n 位是否置位（全局·局部位）。 ```text 08B6 IS_GLOBAL_VAR_BIT_SET_LVAR in: number, bitIndex ``` ```lua isGlobalVarBitSetLvar(number, bitIndex) ``` ```js Math.isBitSet(number, bitIndex) ``` ## 位是否置位局部·常量用在 if：数的第 n 位是否置位（局部·常量位）。 ```text 08B7 IS_LOCAL_VAR_BIT_SET_CONST in: number, bitIndex ``` ```lua isLocalVarBitSetConst(number, bitIndex) ``` ```js Math.isBitSet(number, bitIndex) ``` ## 位是否置位局部·变量用在 if：数的第 n 位是否置位（局部·变量位）。 ```text 08B8 IS_LOCAL_VAR_BIT_SET_VAR in: number, bitIndex ``` ```lua isLocalVarBitSetVar(number, bitIndex) ``` ```js Math.isBitSet(number, bitIndex) ``` ## 位是否置位局部·局部用在 if：数的第 n 位是否置位（局部·局部位）。 ```text 08B9 IS_LOCAL_VAR_BIT_SET_LVAR in: number, bitIndex ``` ```lua isLocalVarBitSetLvar(number, bitIndex) ``` ```js Math.isBitSet(number, bitIndex) ``` ## 置位全局·常量置第 n 位（全局·常量位）。 ```text 08BA SET_GLOBAL_VAR_BIT_CONST in: number, bitIndex ``` ```lua setGlobalVarBitConst(number, bitIndex) ``` ```js Math.setBit(number, bitIndex) ``` ## 置位全局·变量置第 n 位（全局·变量位）。 ```text 08BB SET_GLOBAL_VAR_BIT_VAR in: number, bitIndex ``` ```lua setGlobalVarBitVar(number, bitIndex) ``` ```js Math.setBit(number, bitIndex) ``` ## 置位全局·局部置第 n 位（全局·局部位）。 ```text 08BC SET_GLOBAL_VAR_BIT_LVAR in: number, bitIndex ``` ```lua setGlobalVarBitLvar(number, bitIndex) ``` ```js Math.setBit(number, bitIndex) ``` ## 置位局部·常量置第 n 位（局部·常量位）。 ```text 08BD SET_LOCAL_VAR_BIT_CONST in: number, bitIndex ``` ```lua setLocalVarBitConst(number, bitIndex) ``` ```js Math.setBit(number, bitIndex) ``` ## 置位局部·变量置第 n 位（局部·变量位）。 ```text 08BE SET_LOCAL_VAR_BIT_VAR in: number, bitIndex ``` ```lua setLocalVarBitVar(number, bitIndex) ``` ```js Math.setBit(number, bitIndex) ``` ## 置位局部·局部置第 n 位（局部·局部位）。 ```text 08BF SET_LOCAL_VAR_BIT_LVAR in: number, bitIndex ``` ```lua setLocalVarBitLvar(number, bitIndex) ``` ```js Math.setBit(number, bitIndex) ``` ## 清位全局·常量清第 n 位（全局·常量位）。 ```text 08C0 CLEAR_GLOBAL_VAR_BIT_CONST in: number, bitIndex ``` ```lua clearGlobalVarBitConst(number, bitIndex) ``` ```js Math.clearBit(number, bitIndex) ``` ## 清位全局·变量清第 n 位（全局·变量位）。 ```text 08C1 CLEAR_GLOBAL_VAR_BIT_VAR in: number, bitIndex ``` ```lua clearGlobalVarBitVar(number, bitIndex) ``` ```js Math.clearBit(number, bitIndex) ``` ## 清位全局·局部清第 n 位（全局·局部位）。 ```text 08C2 CLEAR_GLOBAL_VAR_BIT_LVAR in: number, bitIndex ``` ```lua clearGlobalVarBitLvar(number, bitIndex) ``` ```js Math.clearBit(number, bitIndex) ``` ## 清位局部·常量清第 n 位（局部·常量位）。 ```text 08C3 CLEAR_LOCAL_VAR_BIT_CONST in: number, bitIndex ``` ```lua clearLocalVarBitConst(number, bitIndex) ``` ```js Math.clearBit(number, bitIndex) ``` ## 清位局部·变量清第 n 位（局部·变量位）。 ```text 08C4 CLEAR_LOCAL_VAR_BIT_VAR in: number, bitIndex ``` ```lua clearLocalVarBitVar(number, bitIndex) ``` ```js Math.clearBit(number, bitIndex) ``` ## 清位局部·局部清第 n 位（局部·局部位）。 ```text 08C5 CLEAR_LOCAL_VAR_BIT_LVAR in: number, bitIndex ``` ```lua clearLocalVarBitLvar(number, bitIndex) ``` ```js Math.clearBit(number, bitIndex) ```