README_cn.md

SUSTechPOINTS: 3D Point Cloud Annotation Tool

UI说明

屏幕左上区域

 Scene选择
 Frame选择
 目标id选择(试验用，会启动batchedit模式,显示该物体的多个实例)
 相机选择 在不同相机间切换,选择3dbox时也会自动切换
 Box信息
      *(表示已更改未保存) 类别-ID |距离| x y z | 长宽高 | roll pitch yaw | 点数 |F:n(follow obj n)

配置菜单(右上角)

• point size 增加/减小点的大小
• point brightness 增强/减弱点的亮度
• hide box 隐藏3dbox
• theme 暗/亮模式选择
• color objects 目标着色方案：按id/类别，无色
• batch mode max box number: 批编辑模式下显示的实例个数
• data settings: 是否显示雷达数据
• experimental：　实验，标定用
• take screenshot 下载屏幕截图(仅3D场景)
• Help

相机图片

拖动图片的右下角可以调整大小, 选择不同的相机会显示不同图片．

输出窗口

右下角窗口会输出运行信息, 可以点击标题栏隐藏/显示．

右键菜单

右键点击空白区域

• New 在鼠标当前位置创建对应的box
• Paste 在鼠标当前位置paste
• goto
• play
• pause/resume
• stop
• save 保存
• save all
• reload 放弃当前修改刷新上一次保存的内容
• reload all
• frame info
• stat

右键点击box

• delete 删除该box
• delete other instance 删除其他framｅ里该object的box
• sync object type 其它frame中该物体的类型设置为当前box的类型
• sync object size 其它frame中该物体的大小设置为当前box的类型
• inspect all instances 唤起批量标注界面
• select as ref 选择当前box为参考box (同copy)
• follows ref　设置当前box为跟随参考box(即相对位置固定)
• sync followers　将所有跟随当前box的物体标注出来．

(该菜单部分功能处于试验状态，尚不完善．)

操作

调整视角

在主窗口里可以通过鼠标左键旋转, 右键移动, 滚轮缩放视角.

新加Box

方法1: 鼠标移动到目标物体上, 右键选择new-物体种类, 会自动生成box并尝试自动旋转角度和调整box大小.

方法2: 按住ctrl键, 鼠标左键拉一个矩形, 会自动生成box并尝试自动旋转角度和调整box大小.

方法3: 按住shift键,鼠标左键拉一个矩形, 会生成一个box, 包含矩形框围住的点, 方向为屏幕向上的方向. 注意该操作不会自动调整box的大小和方向.

注:

• 画矩形时尽量避免将目标物体之外的点选中,可以少选.
• 上述操作方法是通过矩形投影,将范围内的点进行region grow找到目标物体所有的点. 为了避免选中太多的错误点,建议将视角旋转到接近鸟瞰视角.
• region grow算法会受到地面的影响, 目前采用的方式是将最低的30cm部分先删除再region grow,如果地面非常倾斜,会影响效果, box生成之后需要手工调整.
• region grow算法比较慢(需要优化), 对于超大的物体如bus尽量框选完整,可以加快速度
• shift+矩形选择不会自动识别方向,为了让初始方向大致正确,建议将主视图旋转到物体的方向是沿屏幕向上或者向下,如果方向反了,按g键旋转180度.

box操作

左键点击一个目标,会选中该目标物体．　选择的物体同时会在屏幕左侧显示３个投影窗口,分别是鸟瞰视图,侧视图和后视图．　如果有相机图片的话,还会显示box在图片上的投影．同时在box的旁边还会显示快速工具栏(下图)．

在快速工具栏上可以修改目标类别和tracking ID. 鼠标悬浮在工具按钮上会有相应的功能提示．

点击选中的box会激活主窗口的box调整模式,多次点击会在box大小／角度／位置３中调整模型中切换,　拖动可对box进行调整．　键盘z/x/c可以切换x/y/z轴. 使用v键也可以切换模式.

点击空白处可以取消box的编辑模式,或者取消box的选择, ESC键有同样的功能.

box被选择后, 左边的３个子窗口都可以对box进行调整．鼠标移动到某个子窗口即可在该子窗口进行调整, 调整操作方式相同, 但是各自针对不同的轴. 每个窗口可以调节2个轴的参数.

子窗口内滚动鼠标可调节显示的大小. 拉动虚线/角落可以调节box的大小和旋转角度. 双击虚线/角落/中心位置可以自动缩小box使其和点贴近. 双击旋转线会将box旋转180度.

按住Ctrl键拖动虚线, 释放鼠标会让对应的虚线自动向内侧贴近点. 按照Shift键拖动虚线有类似的效果, 但是会保持box的大小不变, 对box进行平移.

鸟瞰视图里的toolbox提供了几个常用功能的按钮:

分别是自动平移, 自动旋转, 自动旋转加缩放, 重置功能.

除鼠标和toolbox外, 还支持键盘操作.

 a: 左移
 s: 下移
 d: 右移
 w: 上移动
 q: 逆时针旋转
 e: 顺时针旋转
 r: 逆时针旋转同时自动调整box大小
 f: 顺时针选择同时自动调整box大小
 g: 反向
 t: 重置

鸟瞰图的红色圆圈表示lidar(xy平面的原点)的位置所处的方向．

侧视图和后视图提供和鸟瞰图相同的功能(自动旋转除外).

其他功能

 -/=: 调整点的大小
 ctrl+s  保存标注结果（暂不支持自动保存）
 del/ctrl+d  remove selected box

 1,2  选择上一个／下一个box
 3,4  切换到上一帧／下一帧
 5,6,7  显示／隐藏３个子视图的相机参数（调试功能）

 space: 暂停／继续播放

批量编辑

批量编辑界面可以同时对同一目标物体的多个实例(不同frame)进行编辑．　

• 激活方式1, 右键点击某box, 选择inspect all instances
• 激活方式2, 屏幕左上角窗口选择obj (试验用，不能自动切换到合适的frame)

默认一次显示20帧进行编辑．　每个子窗口的操作方式与非批量模式相同． 在配置界面可以选择一次选择的帧数． 第一个实例的图片右下角可以调节每个编辑窗口的大小，可以根据需要调节．

右上角的功能按钮如下：

 Trajectory 显示轨迹

 Auto　自动标注
 Auto(no rotation)
 Interpolate　仅插值，不进行旋转和位置的调整．

 Reload  　放弃本次编辑的内容，重新加载
 Finalize　将所有自动标注的内容标记为已确认（等同于人工标注）．
 
 Save　保存
 Previous　前20帧(有10帧重叠)
 Next　后20帧(有10帧重叠)
 Exit　退出

说明

• 人工修改过的标注不会受到自动标注和插值的影响．finalize就是将所有的自动标注的box标记为等同人工调整过的．　标注完后需要finalize, save.
• 每个小窗口的标题是帧号,如果有M字母表示是由machine自动标注的,否则表示为人工修改过或者确认过的.
• 鼠标移动到某个小窗口, Ctrl+D可以删除box　（或者右键操作）

右键菜单

Object type configuration

如果需要修改模型的目标类型/大小/颜色,可以修改 obj_cfg.js文件.