SuperAPI AI 工具集

image-annotations

设计与创作

查看项目

更新于 10-15 21:52

技能介绍

用途:为截图、示意图、架构文档和演示帧添加视觉标注,突出显示变更点或需要关注的位置,便于评审者快速理解。

主要能力:使用 PIL/Pillow 绘制圆角矩形、引线、V 形箭头和文字标签;提供 annotate.py 模块实现多元素自动标签排布,避免重叠;支持 debug 模式查看候选位置热力图;提供 grid_image() 坐标网格辅助定位;支持 diff_images 图像差异对比(需 scipy)。

使用方式:先安装依赖 pip install Pillow -q(算法标注还需 numpy,diff 功能需 scipy)。基础用法为打开图像、创建 ImageDraw 对象,调用 draw.rounded_rectangle、draw.line、draw.text 绘制标注后保存。算法标注用法:from annotate import annotate_image,传入图像路径和标注列表,每项包含 elem(精确像素边界框)、label(支持换行)、draw_box(是否画圆角矩形,默认 False 则画 V 形箭头),可设 debug=True 查看排布过程。

配色规则:红色 #E63946 仅用于表示“坏”或“已移除”的内容;黄橙色 #FF9F1C 用于中性高亮。字体在 Windows 使用 Ink Free(C:/Windows/Fonts/Inkfree.ttf),Linux/macOS 回退到 ImageFont.load_default(),约 1400px 宽图像建议字号 36。

适用场景:PR 描述中高亮截图区域、前后对比图标注、示意图与架构图添加标签、动画 GIF 演示帧标注。

限制:elem 必须使用精确像素坐标,缩放预览会导致误差累积,建议先用 grid_image() 生成网格并裁剪验证;自动排布基于贪心策略,复杂场景可能无法找到理想位置;字体路径依赖平台,非 Windows 环境需回退默认字体。具体收费与平台支持信息暂未提供。