跳到主要内容

取色器

取色器适合从设备截图或图片中记录脚本会用到的坐标、颜色和区域。第一次使用时,可以先完成一个简单目标:打开截图,点一下目标位置,复制坐标和颜色到脚本里。

打开取色器和图片​

常见入口:

  • 在主界面更多工具或动作入口中打开 样本工作台,默认进入 取色器 页。
  • 在设备列表中右键设备,选择 截图并用取色器打开。
  • 在远控面板中截取当前画面后,选择用取色器打开。
  • 在文件管理器或开发项目图片预览中,点击 用取色器打开。
  • 先打开样本工作台,再把本地图片拖到画布区域,或在工作台激活时粘贴剪贴板中的图片。

样本工作台支持同时打开多个图片标签。处理不同截图时,可以在顶部标签间切换、拖动调整顺序,或关闭不再需要的标签。

记录一个点位​

  1. 打开图片后,用鼠标滚轮缩放,按住左键拖动画面,把目标位置放大到容易点击。
  2. 在图片上移动鼠标,放大镜会显示当前坐标和颜色。
  3. 单击目标位置,点位会进入 点色列表。
  4. 在 点色列表 中查看坐标和颜色值,并复制到脚本中使用。
  5. 如果要固定几个常用点,可以使用 点色记录。鼠标指向图像时按 1 到 5,会写入对应记录位。

随机取色 用于在选区内自动生成多个颜色点,适合需要多点比色的场景。代码模板 会把已取到的坐标、颜色或区域套成脚本片段,复制后可以直接粘到脚本中再按需要调整。

框选和保存小图​

当脚本需要识别一小块图片时,可以先框选区域再保存:

  1. 按住 Shift 并拖拽,建立普通选区。
  2. 需要第二个区域时,按住 Meta/Ctrl 并拖拽,建立另一组选区。
  3. 在 代码模板 中点击 保存区域图像。
  4. 输入文件名称。
  5. 选择保存位置:小图保存路径、项目路径/res/ 或 下载。
  6. 点击 拷贝代码并保存图像。

这样会同时保存区域图片,并把对应代码复制到剪贴板。通常把代码粘到脚本中需要找图或载入小图的位置。

保存区域图像模板与点阵图模板分别保存。它支持文件名变量 $imgFileBaseName,也支持取色器代码模板的全部变量:

  • 点位与记录:$pointInitList、$pointList、$recordInitList、$recordList、$point[n].x、$point[n].y、$point[n].c、$record[n].x、$record[n].y、$record[n].c。
  • 坐标范围:$xMin、$yMin、$xMax、$yMax、$xFirst、$yFirst。
  • 选区:$shiftRect.left、$shiftRect.top、$shiftRect.right、$shiftRect.bottom、$metaRect.left、$metaRect.top、$metaRect.right、$metaRect.bottom。
  • 选区图像数据:$shiftRectImgData、$metaRectImgData。

在设备测试模板​

在文本编辑器或设备右键菜单设置当前开发测试设备,再点击“拷贝”左侧的“在设备测试”。取色器支持 5 个模板、find_image、load_data 和保存区域图像;点阵页支持 6 个模板和点阵图像。两页统一使用当前开发测试设备,切换后立即跟随;截图设备、设备列表和分组的勾选不会改变测试目标。未设置或设备不可用时,请先通过上述入口设置可用设备。

点击取色器模板标题旁的铅笔图标可以编辑名称、原代码和测试包装,并查看生成结果;点阵模板在原有编辑弹窗中修改。输入会自动保存,关闭或按 Escape 保留修改。模板 1~5 的空名称会显示当前语言的默认名称;清空测试包装会禁用该项测试。“恢复默认模板”会同时恢复对应名称、原代码和测试包装。

测试包装用 $code 插入当前生成的原代码,插入内容不会再次展开变量。$screenOrient 是截图方向,默认 0;点阵还可用 $coreLine 插入核心行。图像测试支持 $testResourceRoot 和 $testImagePath。保存区域图像、点阵图像可直接测试当前 PNG,无需先保存到本机。

点击后会打开编辑器并展开设备日志,保留已有文件、日志与工作台内容。日志连接就绪后才发送代码,工作台显示发送状态,结果和错误显示在日志中。设备有脚本正在运行或编辑器正在运行、调试时,请先结束任务。发送结果未确认时先检查设备日志,再决定是否重试。

常见问题​

  • 截图失败:先确认设备在线、已授权,并且设备本身可以正常截图。
  • 粘贴图片没有反应:确认剪贴板里确实是图片,再让样本工作台保持激活后粘贴。
  • 保存到本机指定路径失败:需要先在 系统配置 中开启本地保存相关权限;没有开启时,可以选择 下载 保存到浏览器下载目录。
  • 复制失败:可以手动选中代码框或坐标文本,再复制。

如果需要从同一张截图继续制作点阵或抓取文本元素,可以切换到 点阵字库工具 或 文本元素抓取器。