数学函数

坐标计算

6 个函数

基准范围转屏幕范围

Coordinate.toScreenRect(x: integer, y: integer, width: integer, height: integer): (integer, integer, integer, integer)

把基准 X、Y、宽、高一次转换为真实屏幕范围，按此顺序返回四个整数。

参数4 项
序号名称类型参数说明
1 x 整 图像识别结果的 X 坐标，例如 图像变量.x。
2 y 整 图像识别结果的 Y 坐标，例如 图像变量.y。
3 width 整 图像识别结果的宽，例如 图像变量.width。
4 height 整 图像识别结果的高，例如 图像变量.height。
返回值至少接收一个返回值
序号名称类型返回说明
1 屏幕X 整 真实屏幕 X 坐标
  • 屏幕X：转换成功
  • -1：坐标映射未就绪或参数无效
2 屏幕Y 整 真实屏幕 Y 坐标
  • 屏幕Y：转换成功
  • -1：坐标映射未就绪或参数无效
3 屏幕宽 整 真实屏幕宽
  • 屏幕宽：转换成功
  • -1：坐标映射未就绪或参数无效
4 屏幕高 整 真实屏幕高
  • 屏幕高：转换成功
  • -1：坐标映射未就绪或参数无效

两点距离

Math.distance(x1: integer, y1: integer, x2: integer, y2: integer): integer

计算两点间的直线像素距离，可用于判断角色是否到达目标。

参数4 项
序号名称类型参数说明
1 x1 整 当前位置 X 坐标。
2 y1 整 当前位置 Y 坐标。
3 x2 整 目标位置 X 坐标。
4 y2 整 目标位置 Y 坐标。
返回值至少接收一个返回值
序号名称类型返回说明
1 distance 整 两点间的像素距离。
  • 5：示例：(0,0) 到 (3,4)
  • -1：参数无效

两点角度

Math.angle(x1: integer, y1: integer, x2: integer, y2: integer): integer

计算第一点指向第二点的方向角度，可传给轮盘坐标函数。

参数4 项
序号名称类型参数说明
1 x1 整 当前位置 X 坐标。
2 y1 整 当前位置 Y 坐标。
3 x2 整 目标位置 X 坐标。
4 y2 整 目标位置 Y 坐标。
返回值至少接收一个返回值
序号名称类型返回说明
1 angle 整 方向角度，范围为 -180 至 180。
  • 0：向右
  • 90：向下
  • 180：向左
  • -90：向上
  • -1：参数无效

翻转角度

Math.flipAngle(angle: integer, mode: integer): integer

按上下或左右方向翻转角度。

参数2 项
序号名称类型参数说明
1 angle 整 两点角度返回值，或需要修正的方向角度。
2 mode 整 翻转方式：1 上下翻转，2 左右翻转。
返回值至少接收一个返回值
序号名称类型返回说明
1 angle 整 翻转后的方向角度。
  • 翻转角度：模式有效
  • -1：角度或模式无效

轮盘X坐标

Math.joystickX(centerX: integer, angle: integer, radius: integer): integer

根据轮盘中心、方向角度和半径计算拖拽终点 X 坐标。

参数3 项
序号名称类型参数说明
1 centerX 整 轮盘中心 X 坐标。
2 angle 整 两点角度或翻转角度的返回值。
3 radius 整 轮盘拖动半径，例如 80。
返回值至少接收一个返回值
序号名称类型返回说明
1 x 整 轮盘拖拽终点 X 坐标。
  • X坐标：计算成功
  • -1：参数无效

轮盘Y坐标

Math.joystickY(centerY: integer, angle: integer, radius: integer): integer

根据轮盘中心、方向角度和半径计算拖拽终点 Y 坐标。

参数3 项
序号名称类型参数说明
1 centerY 整 轮盘中心 Y 坐标。
2 angle 整 两点角度或翻转角度的返回值。
3 radius 整 轮盘拖动半径，例如 80。
返回值至少接收一个返回值
序号名称类型返回说明
1 y 整 轮盘拖拽终点 Y 坐标。
  • Y坐标：计算成功
  • -1：参数无效