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

目录

1. Command?概览??

2. Command2D

?

1. Command?概览??

?功能：命令栈基类，用来实现撤销和重做功能。

其子类Command2D和Command3D都是实现父类方法，除了构造函数没有自己的独有方法。

字段：

1. redoCommands：存储redo（重做）命令栈，其实就是QStack<QString> ；
2. undoCommands：存储undo（撤销）命令栈。

方法：

1. logAdd：记录添加标注
2. logDelete：记录删除标注
3. logMove：记录移动标注
4. logChange：记录更改标注
5. undo：撤销功能
6. redo：重做功能

#ifndef COMMAND_H
#define COMMAND_H
#include<QStack>
#include"Namespace.h"

/// \brief 命令栈基类，用来实现撤销和重做功能
class My::Command{

public:
    /// \brief 存储undo（撤销）命令栈
    QStack<QString> undoCommands;

    /// \brief 存储redo（重做）命令栈
    QStack<QString> redoCommands;

    /// \brief 记录添加标注
    virtual void logAdd(int index);

    /// \brief 记录删除标注
    virtual void logDelete(int index,int id);

    /// \brief 记录移动标注
    virtual void logMove(int index,float xoffset,float yoffset,int id=0);

    /// \brief 记录更改标注
    virtual void logChange(int index,QString s1,QString s2);

    /// \brief 撤销功能
    virtual void undo();

    /// \brief 重做功能
    virtual void redo();
    virtual ~Command()=0;  // 将其声明为纯虚函数强制要求任何继承自 Command 的类都要提供自己的析构函数实现。
};

#endif // COMMAND_H

2. Command2D

继承自Command类

字段（多了一个manager）：存放中心组件指针CentralWInit2D* manager（中心窗口）；

方法：和父类一样。

/*!
* \file command2d.cpp
* \brief 2d命令栈类
* \author 王澳
* \date 2019.09
*/

#include"Command2D.h"
#include"Label.h"
#include"mainwindow.h"
#include<QObject>


/// \brief 2d中心组件的记录添加  将添加标注的操作记录到命令栈中，以便后续进行撤销。
void My::Command2D::logAdd(int index){  // 表示添加标注的索引
    QString s=QString("Add %1").arg(index);  // s表示添加标注的命令
    undoCommands.push_back(s);
    redoCommands.clear();  // 在执行新的命令时，清空之前可能存在的可以重做的命令。
}

/// \brief 2d中心组件的记录删除  将删除标注的操作记录到命令栈中，以便后续进行撤销操作。
void My::Command2D::logDelete(int index,int id){  // index表示删除标注的索引。id表示删除标注的唯一标识符.
    QString s=QString("Delete %1 %2").arg(index).arg(id);
    undoCommands.push_back(s);
    redoCommands.clear();
}

/// \brief 2d中心组件的记录移动  将移动标注的操作记录到命令栈中，以便后续进行撤销操作。
void My::Command2D::logMove(int index,float xoffset,float yoffset,int id){
    QString s=QString("Move %1 %2 %3").arg(index).arg(xoffset).arg(yoffset);
    undoCommands.push_back(s);
    redoCommands.clear();
}

/// \brief 2d中心组件的记录改变  记录了标注的改变操作。当用户改变标注的文字时
void My::Command2D::logChange(int index,QString s1,QString s2){
    QString s=QString("Change %1 %2 %3").arg(index).arg(s1).arg(s2);
    undoCommands.push_back(s);  // 格式是类似于 "Change index oldLabel newLabel"
    redoCommands.clear();
}

/// \brief 2d中心组件的撤销动作  包含4中操作：Add, Delete, Move, Change
void My::Command2D::undo(){
    if(undoCommands.count()==0)return;
    // 获取最近一次的命令记录。
    QString s=undoCommands.top();
    undoCommands.pop_back();

    QStringList list=s.split(" ");  // 使用空格作为分隔符将命令字符串拆分为列表
    // 执行一次undo函数，只撤销一个命令。
    if(list[0]=="Add"){  // 命令格式："Add index"
        // 将形状移至 trashshapes 并更新 redoCommands 堆栈
        int index=list[1].toInt();
        manager->trashshapes.append(manager->label->shapes[index]);
        manager->label->shapes.removeAt(index);
        QString str=QString("Add %1 %2").arg(index).arg(manager->trashshapes.length()-1);
        redoCommands.push_back(str);  // 执行撤销命令后，有反悔药。
        // 发送删除label信号通知其他组件
        emit(manager->labelDeleted(index));
        manager->label->update();  // 并更新 label 小部件
    }
    if(list[0]=="Delete"){  // 命令格式："Delete index id"
        // 从 trashshapes 中检索形状并插入回 label->shapes，因为上一步删除后，形状会放置在trashshapes
        int index=list[1].toInt();
        int id=list[2].toInt();
        manager->label->shapes.insert(index,manager->trashshapes[id]);
        QString str=QString("Delete %1").arg(index);
        redoCommands.push_back(str);
        emit(manager->labelAdded(manager->trashshapes[id],index));
        manager->label->update();
    }
    if(list[0]=="Move"){  // 移动标注，命令格式："Move index xoffset yoffset"
        int index=list[1].toInt();
        float xoffset=0;
        float yoffset=0;
        xoffset-=list[2].toFloat();  // 减去offset就回到之前的位置。
        yoffset-=list[3].toFloat();
        manager->label->shapes[index]->offset(xoffset,yoffset);  // 形状对象修改自己的位置信息
        QString str=QString("Move %1 %2 %3").arg(index).arg(-xoffset).arg(-yoffset);
        redoCommands.push_back(str);
        manager->label->update();
    }
    if(list[0]=="Change"){  // 标注类别的改变，命令格式："Change index oldLabel newLabel"
        int index=list[1].toInt();
        QString s1=list[2];  // oldLabel
        QString s2=list[3];
        manager->label->shapes[index]->label=s1;  // 形状的属性label类别名称
        redoCommands.push_back(s);
        emit(manager->labelChanged(index,manager->label->shapes[index]));
        manager->label->update();
    }
}


/// \brief 2d中心组件的重做动作
void My::Command2D::redo(){
    if(redoCommands.count()==0)return;
    QString s=redoCommands.top();
    redoCommands.pop_back();
    QStringList list=s.split(" ");
    if(list[0]=="Add"){
        int index=list[1].toInt();
        int id=list[2].toInt();
        manager->label->shapes.insert(index,manager->trashshapes[id]);
        QString str=QString("Add %1").arg(index);
        undoCommands.push_back(str);
        emit(manager->labelAdded(manager->trashshapes[id],index));
        manager->label->update();
    }
    if(list[0]=="Delete"){
        int index=list[1].toInt();
        manager->trashshapes.append(manager->label->shapes[index]);
        int id=manager->trashshapes.length()-1;
        manager->label->shapes.removeAt(index);
        QString str=QString("Delete %1 %2").arg(index).arg(id);
        undoCommands.push_back(str);
        emit(manager->labelDeleted(index));
        manager->label->update();
    }
    if(list[0]=="Move"){
        int index=list[1].toInt();
        float xoffset=list[2].toFloat();
        float yoffset=list[3].toFloat();
        manager->label->shapes[index]->offset(xoffset,yoffset);
        QString str=QString("Move %1 %2 %3").arg(index).arg(xoffset).arg(yoffset);
        undoCommands.push_back(str);
        manager->label->update();
    }
    if(list[0]=="Change"){
        int index=list[1].toInt();
        manager->label->shapes[index]->label=list[3];
        undoCommands.push_back(s);
        emit(manager->labelChanged(index,manager->label->shapes[index]));
        manager->label->update();
    }
}