143 lines
3.1 KiB
Markdown
143 lines
3.1 KiB
Markdown
# 区域选择器 - 白色像素统计工具
|
|
|
|
## 功能说明
|
|
|
|
这个工具用于在图片上选择区域,圈出边框,并统计该区域内的白色像素数量。主要用于识别直播间图标等需要根据白色像素比例来判断的场景。
|
|
|
|
## 主要功能
|
|
|
|
1. **图片查看和导航**
|
|
- 支持多种图片格式:PNG, JPG, JPEG, BMP, WebP
|
|
- 上一张/下一张图片切换
|
|
- 拖放图片文件到窗口直接打开
|
|
|
|
2. **图片缩放和平移**
|
|
- 鼠标滚轮缩放
|
|
- Ctrl+滚轮快速缩放
|
|
- 右键拖拽平移图片
|
|
- 适应窗口大小
|
|
- 重置缩放
|
|
|
|
3. **区域选择**
|
|
- 左键拖拽选择矩形区域
|
|
- 红色虚线显示选择区域
|
|
- 实时显示选择区域坐标和尺寸
|
|
|
|
4. **白色像素分析**
|
|
- 统计选中区域内的白色像素数量
|
|
- 计算白色像素比例
|
|
- 计算置信度(基于白色比例与0.5的距离)
|
|
- 自动保存分析结果
|
|
|
|
5. **数据管理**
|
|
- 保存/加载区域数据到JSON文件
|
|
- 显示所有保存的区域
|
|
- 清除选择或清除所有区域
|
|
|
|
## 使用方法
|
|
|
|
### 启动工具
|
|
|
|
```bash
|
|
# 从tools目录运行
|
|
python region_selector.py
|
|
|
|
# 或者直接指定图片路径
|
|
python region_selector.py path/to/image.png
|
|
```
|
|
|
|
### 基本操作
|
|
|
|
1. **打开图片**
|
|
- 点击"文件" -> "打开" 或按 Ctrl+O
|
|
- 或者直接拖放图片文件到窗口
|
|
|
|
2. **选择区域**
|
|
- 按住鼠标左键拖拽选择矩形区域
|
|
- 红色虚线会显示选择的区域
|
|
|
|
3. **缩放和平移**
|
|
- 鼠标滚轮:缩放
|
|
- Ctrl+滚轮:快速缩放
|
|
- 右键拖拽:平移图片
|
|
- 视图菜单:放大/缩小/重置/适应窗口
|
|
|
|
4. **分析区域**
|
|
- 选择区域后,按 Enter 键或点击"分析区域"按钮
|
|
- 结果会显示在右侧面板和控制台
|
|
|
|
5. **管理数据**
|
|
- Ctrl+S:保存区域数据到JSON文件
|
|
- Ctrl+L:加载区域数据
|
|
- "显示所有":查看所有保存的区域数据
|
|
|
|
## 快捷键
|
|
|
|
| 快捷键 | 功能 |
|
|
|--------|------|
|
|
| Ctrl+O | 打开图片 |
|
|
| ← / → | 上一张/下一张图片 |
|
|
| + / - | 放大/缩小 |
|
|
| Ctrl+0 | 重置缩放 |
|
|
| Ctrl+F | 适应窗口 |
|
|
| Delete | 清除选择 |
|
|
| Enter | 分析区域 |
|
|
| Ctrl+S | 保存区域数据 |
|
|
| Ctrl+A | 显示所有区域 |
|
|
|
|
## 输出格式
|
|
|
|
分析结果包括:
|
|
- 区域坐标:(x1, y1) - (x2, y2)
|
|
- 区域尺寸:宽度x高度
|
|
- 总像素数
|
|
- 白色像素数
|
|
- 白色像素比例
|
|
- 置信度
|
|
|
|
## 数据文件格式
|
|
|
|
保存的JSON文件包含每个区域的完整信息:
|
|
|
|
```json
|
|
[
|
|
{
|
|
"coordinates": [x1, y1, x2, y2],
|
|
"size": [width, height],
|
|
"total_pixels": 1234,
|
|
"white_pixels": 567,
|
|
"white_ratio": 0.459,
|
|
"image_path": "path/to/image.png"
|
|
}
|
|
]
|
|
```
|
|
|
|
## 应用场景
|
|
|
|
- 直播间图标识别:通过白色像素比例判断是否为直播状态
|
|
- UI元素检测:识别界面上的特定图标或按钮
|
|
- 图像分析:统计图像中特定区域的颜色分布
|
|
|
|
## 技术说明
|
|
|
|
- 使用PIL (Pillow) 进行图像处理
|
|
- 使用tkinter创建GUI界面
|
|
- 支持numpy进行高效的像素统计
|
|
- 白色像素阈值:RGB值都≥240的像素被认为是白色
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|