qt项目-《图像标注软件》源码阅读笔记-类图

1. 开源项目链接

GitHub - jameslahm/labelme: A image annotation software for 2D or 3D images

2. 项目界面

3. 项目类图

全部类图：

3.1 Shape 形状的绘制及形状的存储

qt项目-《图像标注软件》源码阅读笔记-Shape类绘图及其子类-CSDN博客

负责形状的绘制及形状的存储

• Brush代表画刷形状，用于分割标注；
• Rectangle代表矩形形状；
• Polygons代表多边形形状；
• Circle代表圆形形状；
• Curve代表平滑曲线形状；
• Rectangle3D代表3d长方体形状；
• Brush3D代表3d画刷形状，用于3d分割标注。

3.2 CentralWidget主窗口中心组件的界面管理

qt项目-《图像标注软件》源码阅读笔记-CentralWidget类及其子类-CSDN博客

CentralWidget类负责主窗口中心组件的界面初始化以及后续中心组件的管理。
其两个派生类分别负责2D、3D中心组件，
2d和3d的模式可以进行切换。

• 内部的绘画以及标注相关的动作交由Label类（或Label3D类）进行处理；
• 命令的撤销和重做交由Command2D类（或Command3D）进行处理；
• 标注文件的解析和存储，以及3D图片系列文件的解析均交由Parse类进行处理。

3.3 Command负责实现撤销和重做功能

qt项目-《图像标注软件》源码阅读笔记-Command类绘图及其子类-CSDN博客

Command是命令栈基类，用来实现撤销和重做功能，有6个虚函数；

子类Command2D和Command3D实现这6个虚函数；

• logAdd：记录添加标注；
• logDelete：记录删除标注；
• logMove：记录移动标注；
• logChange：记录更改标注；
• undo：撤销功能；
• redo：重做功能。

3.4 其他类

3.4.1 Label 类

qt项目-《图像标注软件》源码阅读笔记-Label 2d绘制图片及标注类-CSDN博客

功能：

2d绘制图片及标注类，继承QLabel

内部具体的形状的绘制均交由Shape类进行处理，
Shape类为形状基类，
具体的绘制则会调用对应形状类的虚函数。

3.4.2 Parse类

标注文件信息的解析和保存。

3.4.3 ActionsInit

负责所有QAction的管理（有所有快捷键的设置），以及主窗口各组件QAction的初始化和状态管理

1. setUp(QMainWindow* w)：主窗口所有QAction的初始化
2. setUp(QMenuBar* mbar)：初始化菜单栏上的所有动作
3. setUp(QStatusBar* sbar)：初始化状态栏上的所有动作
4. setUp(QToolBar* tbar)：初始化工具栏上的所有动作
5. initStatus：负责状态初始化，当主窗口需要状态初始化时，调用该函数
6. enableAction：对外的接口，控制QAction的enable
7. disableAction：对外的接口，控制QAction的disable
8. setStatus：根据主窗口的状态，同步更改QAction的状态
9. toggleAction：切换动作的checkstate
10. setUpCentralWidget：中心组件右键菜单
11. setUpLabelsDWInit：标签列表组件右键菜单
12. createShape：创建标注时的动作状态管理

3.4.4 MainWindow类

主窗口

• MainWindow 类是主窗口类，采用策略模式进行管理，成员变量包括窗口的各个组件部分（代理）；
• 所有的UI界面的设计及初始化均在组件的setup函数中完成；
• MainWindow只负责消息的传递，包括信号与槽的连接、QAction的触发和消息的转发等等，不负责具体的处理，具体的处理全部分别交由具体的组件；
• 组件包括：动作管理组件，菜单栏管理组件，状态栏管理组件，工具栏管理组件，标签列表管理组件，文件列表管理组件以及中心窗口组件。

3.4.5 FilesDWInit 类

负责文件列表组件的初始化及状态管理

• 负责文件列表浮动窗口组件的界面初始化；
• 以及后续的文件列表的管理；
• 与文件相关的动作比如打开文件、打开文件夹等均由MainWindow进行消息传递转发到此处进行处理。

3.5 枚举

软件总共有4个枚举类型。

3.5.1 Status 主窗口的状态变量

enum Status {Edit,Focus,Create}; 

总共3个状态。

• edit为默认状态，此时处于编辑标注的状态;
• focus为选中状态，表明此时有标注被选中，可以进行响应的操作;
• create为创建标注状态，表明此时正在创建标注.

3.5.2  Mode 主窗口模式状态变量

enum Mode {TwoD,ThreeD}; 

• TwoD代表处于2d状态；
• ThreeD代表处于3d状态

3.5.3 shapeStatus 中心组件状态

enum shapeStatus {BrushShape,PolygonsShape,RectangleShape,CircleShape,CurveShape,NoShape,InShape};

总共7个状态。 

• noshape表明此时鼠标不在标注形状内部，且不在创建状态;
• inshape表明此时鼠标在标注形状内部;
• brushshape表明此时处于创建画刷状态，（分割标注）;
• rectangleshape表明此时处于绘制矩形状态;
• circleshape表明处于创建圆形状态;
• polygonsshape表明处于创建多边形状态;
• curveshape表明处于创建平滑曲线状态.

3.5.4 syncStatus 3d组件对label3d的统一接口中同步状态变量

enum syncStatus {AddShape,AddPoint,Selected,Remove,UnSelected,ChangePoint,ShowMessage,Hovered,UnHovered,Offset};

总共10个状态。

• addshape表明添加标注形状；
• addpoint表明添加像素点；
• selected表明选中；
• unselected表明未选中；
• remove表明移除正在创建的形状；
• changepoint表明更改正在绘制的像素点；
• showmessage表明显示鼠标坐标；
• hovered表明鼠标在该标注形状内；
• unhovered表明鼠标已不在该标注形状内；
• offset表明偏移标注位置