跳到主要内容

# 取色器

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

## 打开取色器和图片​

常见入口：

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

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

## 记录一个点位​

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`。

## 常见问题​

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

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