该工具基于labelme做了深度的修改
界面及功能介绍
工具栏
文件工具栏
- 打开目录 支持打开图片文件目录
- 打开文件 支持打开单个图片,或者 MP4等格式的视频文件,打开视频标注时会生产和视频名字一样的文件夹,里面保存标注的帧的图片和标注数据
编辑工具栏
- 自动粘贴: 当选中自动粘贴后,切换图片时会将复制的图形粘贴到下一张图片上
- 统计标签: 统计标注的各个标签数量以及总数
- 删除图片: 删除当前图片,如果已经标注会连带标签文件一并删除
- 删除标签:会删除当前文件的标签文件
- 删除图形: 删除当前标注选中的图形
- 编辑标签: 编辑选中的图形的标签名称
绘制工具栏
支持绘制多边形、矩形、折线、直线、圆和点
填充:绘制后也是一个标签,配合批量操作中的区域填充使用,填充时以这个标签来填充的
删除:配合批量操作中的删除标签使用的,如果只需要在某些区域删除标签,可用该标签绘制区域
替换:同上,替换标签时,可以绘制特定的区域,只替换该区域中的选定标签
快捷设置工具栏
帧数间隔:标注视频时,可以设置下一张的帧间隔数
自动线宽:可以点击变为设置线宽,然后进行手动设置
图形标签
该控件记录当前图片中标注的标签信息,支持以树形层级结构展示
编辑状态下可以单击选中一个标签或按住Ctrl
选中多个标签,进行删除操作,按Ese
可取消选择
在编辑状态下双击标签可以直接编辑标签名字
可以直接在标签上进行拖拽,以便将标签保存到正确的层级中
shap_id 中可以看出标签的父级,如上图 耳朵和眼睛是属于猫的
标签列表
- 隐藏全部 点击后会隐藏标注好的标签,再次点击会显示,也可在标签前面选框中选择部分显示
- 保留标注 当打开没有标注的图片时,点击次按钮会将当前图片中的标注信息复制到新的图片中
- 标签排序 点击会对标签按字母进行排序
- 导入标签 支持导入标签 标签之间以空格或逗号分开
- 导出标签 以列表的形式将标签输出供复制用
该控件记录标注的标签类别
在新标注的图形结束时如果有标签对话框,对话框中会有该标签信息,如果不想每次都弹出,可以在标签列表中一个标签作为默认标签,当新的图形完成时,默认属于该类,不再弹出对话框,在标签列表按Esc
或点击空白处可取消默认标签
文件列表
该控件显示打开目录中的文件(打开视频时显示标注好的文件)
前面的对对号代表该图片已经标注过
可以直接在搜索框中进行查找,可以直接点击跳到需要查看的图片
在批量编辑标签时需要设置作用范围,可以双击列表文件进行设置
设置菜单
这些设置一看就懂,不再赘述,通常情况下不需要设置
旋转180°目前只对视频有用
功能菜单
批量删除标签文件
将标注生成的标签文件全部删除
批量删除不成对文件
将未标注的图片文件
或没有对应图片文件的标注文件
全部删除
批量格式转换
支持 xml
格式和 json
格式相互装换,标注文件如果不是 utf-8
编码的也可将其转码为 utf-8
批量修改文件名
批量为文件名加前缀
预标注
如果有模型,标注工具可以设置预标注,开启后未标注图片可以将模型识别结果标注在图片上,该功能需要配合预标注服务才能使用
裁剪图片
对于批量图片,图片四周的区域可能不是我们想要的,可以进行范围设置
批量编辑标签
批量编辑——删除标签
批量编辑支持对已加载的文件全部或部分进行批量操作
批量删除可以同时批量删除多个标签,也可以指定删除的区域(首先要在图片上绘制删除区域)进行删除
批量编辑——添加标签
对于大量图片上的一些目标都在一个位置时,可以用批量添加标签,在图片中选择标签,指定范围,可以将这些标签统一添加到其他图片中
批量编辑——替换标签
对批量图片上的标签进行替换,支持特定区域(首先要在图片上绘制替换区域)
批量编辑——区域填充
有些图片上有些目标,我们需要将其遮挡,可以在图片中绘制填充区域进行统一填充。支持以当前图片的区域将所有图片进行填充,也可以以每个图片上的填充区域为准进行填充。可以设置填充颜色
默认快捷键
快捷键 | 功能 | 备注说明 |
---|---|---|
Q | 绘制多边形 | |
W | 绘制矩形 | |
E | 绘制折线 | |
R | 绘制直线 | |
T | 绘制圆 | |
Y | 绘制点 | |
A | 上一张(视频标注时上一帧) | 可以设置帧间隔(默认5帧) |
D | 下一张(视频标注时下一帧) | |
Shift+A | 视频标注时跳至上一张图片 | 视频标注时快速查看上一张已标注图片 |
Shift+D | 视频标注时跳至下一张图片 | 视频标注时快速查看下一张已标注图片 |
F | 编辑图形 | |
G | 删除选中图形 | |
H | 删除图片 | |
J | 编辑标签 | |
K | 删除标签 | |
P | 保留标注 | 将当前页面的标注图形保留至下一个打开的图片(只对未标注图片有效) |
C | 复制选中的图形 | |
V | 粘贴选中的图形 | |
N | 自动粘贴已复制的图形 | 当切换图片时自动粘贴 |
Ctrl+Z | 撤销 | |
Ctrl+=(滚轮上) | 放大图片 | |
Ctrl±(滚轮下) | 缩小图片 | |
Ctrl+0(数字0) | 图片自身大小 | |
Ctrl+F | 图片适应窗口 | |
Ctrl+Shift+F | 图片适应宽度 | |
按压滚轮 | 图片适应窗口 | |
鼠标右键 | 拖动图片 | 当图片放大超过显示区域时拖动有用 |
Shift+左键 | 添加点/删除点 | 在编辑模式下在多边形或折线的边上添加或去除点 |
Ctrl+O | 打开目录 | |
Ctrl+U | 打开文件 | |
Ctrl+W | 关闭标注 |
配置说明
auto_save: true # 自动保存
display_label_popup: false # 是否显示标签弹窗
store_data: false # 是否在标签文件中
keep_prev: false # 是否保留之前的
keep_prev_scale: false #
keep_prev_brightness: false
keep_prev_contrast: false
logger_level: info
flags: null
label_flags: null
labels: null # 标签 以逗号分开
file_search: null
sort_labels: true # 标签对话框中标签是否排序
validate_label: null # 验证标签
default_shape_color: [0, 255, 0]
shape_color: auto # null, 'auto', 'manual'
shift_auto_shape_color: 0
label_colors: null
shape:
# drawing
line_color: [0, 255, 0, 128] # 绘制图形时图形的颜色
fill_color: [0, 255, 0, 0]
vertex_fill_color: [0, 255, 0, 255] # 绘制图形时顶点填充颜色g
# selecting / hovering
select_line_color: [255, 255, 255, 255] # 选中图形时线条的颜色
select_fill_color: [0, 255, 0, 155]
hvertex_fill_color: [255, 255, 255, 255] # 选中顶点时顶点填充颜色
# main
flag_dock: # flag控件配置
show: true # 是否显示
closable: true # 是否可关闭
movable: true # 是否可移动
floatable: true # 是否可浮动
label_dock: # label 控件配置
show: true
closable: true
movable: true
floatable: true
shape_dock: # shape 控件
show: true
closable: true
movable: true
floatable: true
file_dock: # 文件控件
show: true
closable: true
movable: true
floatable: true
# label_dialog
show_label_text_field: true
label_completion: startswith
fit_to_content: # 设置新标签对话框中竖直和水平滚动条是否隐藏
column: true
row: false
# canvas
epsilon: 10.0 # 阈值 判断鼠标是否在点上或边上
canvas:
# None: do nothing
# close: close polygon
double_click: close # 双击完成绘制
shortcuts: # 快捷键
close: Ctrl+W #关闭文件
open: Ctrl+U #打开文件 支持 mp4
open_dir: Ctrl+O # 打开文件夹
quit: Ctrl+Q # 目前没有使用
save: Ctrl+S
save_as: Ctrl+Shift+S
save_to: null
delete_file: K # 删除标签文件
delete_img: H # 删除图片文件(标注好的会将标签文件一起删除)
open_next: D # 上一张
open_prev: A # 下一张
zoom_in: [Ctrl++, Ctrl+=] # 放大
zoom_out: Ctrl+- # 缩小
zoom_to_original: Ctrl+0 # 还原图片原始大小
fit_window: Ctrl+F # 适应窗口
fit_width: Ctrl+Shift+F # 适应宽度
create_polygon: Q # 创建多边形
create_rectangle: W # 创建矩形
create_circle: T # 创建圆
create_line: R # 创建直线
create_point: Y # 创建点
create_linestrip: E # 创建折线
edit_polygon: F # 编辑图形
delete_polygon: G # 删除图形
duplicate_polygon: C # 复制图形
paste_polygon: V # 粘贴图形
undo: Ctrl+Z # 撤回
undo_last_point: Ctrl+Z# 撤销
add_point_to_edge: Ctrl+Shift+P # 在边上添加一点(只对折线和多边形有效)
edit_label: J # 编辑标签名称
auto_paste: N # 设置自动粘贴(在复制图形的情况下,打开其他张图片会自动粘贴)
statistics: L # 统计标签
toggle_keep_prev_mode: P # 设置(保留/舍弃)标注到下一个打开的图片
以上配置一般只需根据自己习惯修改快捷键即可
首次运行会在用户根目录下创建一个 .labeltoolrc
的配置文件,
一定要按格式修改好,否则文件有可能不能正常打开(如果找不到原因可以删除该文件重新打开会再生产)
该版本为旧版,最新版参考 LabelDuck标注工具使用说明