Files
douyin_guaji-main/tools/README_Region_Selector.md
T

3.1 KiB

区域选择器 - 白色像素统计工具

功能说明

这个工具用于在图片上选择区域,圈出边框,并统计该区域内的白色像素数量。主要用于识别直播间图标等需要根据白色像素比例来判断的场景。

主要功能

  1. 图片查看和导航

    • 支持多种图片格式:PNG, JPG, JPEG, BMP, WebP
    • 上一张/下一张图片切换
    • 拖放图片文件到窗口直接打开
  2. 图片缩放和平移

    • 鼠标滚轮缩放
    • Ctrl+滚轮快速缩放
    • 右键拖拽平移图片
    • 适应窗口大小
    • 重置缩放
  3. 区域选择

    • 左键拖拽选择矩形区域
    • 红色虚线显示选择区域
    • 实时显示选择区域坐标和尺寸
  4. 白色像素分析

    • 统计选中区域内的白色像素数量
    • 计算白色像素比例
    • 计算置信度(基于白色比例与0.5的距离)
    • 自动保存分析结果
  5. 数据管理

    • 保存/加载区域数据到JSON文件
    • 显示所有保存的区域
    • 清除选择或清除所有区域

使用方法

启动工具

# 从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文件包含每个区域的完整信息:

[
  {
    "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的像素被认为是白色