DAGraphicsScene.h

#ifndef DAGRAPHICSSCENE_H
#define DAGRAPHICSSCENE_H
#include "DAGraphicsViewGlobal.h"
#include <QGraphicsScene>
#include <QUndoStack>
#include <QImage>
#include <QTextDocument>
namespace DA
{
class DAGraphicsResizeableItem;
class DAGraphicsItem;
class DAGraphicsTextItem;
class DAGraphicsRectItem;
class DAGraphicsLinkItem;
class DAGraphicsItemGroup;
class DAAbstractGraphicsSceneAction;
class DAGraphicsLayout;
class DAGraphicsCommandsFactory;
class DAGRAPHICSVIEW_API DAGraphicsScene : public QGraphicsScene
{
    Q_OBJECT
    DA_DECLARE_PRIVATE(DAGraphicsScene)
    friend class DAGraphicsResizeableItem;
 
public:
    enum LinkMode
    {
        LinkModeAutoStartEndFollowMouseClick
    };
 
public:
    DAGraphicsScene(QObject* p = nullptr);
    DAGraphicsScene(const QRectF& sceneRect, QObject* p = nullptr);
    DAGraphicsScene(qreal x, qreal y, qreal width, qreal height, QObject* p = nullptr);
    ~DAGraphicsScene();
    // 获取当前鼠标在scene的位置
    QPointF getCurrentMouseScenePos() const;
    // 获取最后鼠标在scene点击的位置
    QPointF getLastMousePressScenePos() const;
    // 获取选中且能移动的item
    QList< QGraphicsItem* > getSelectedMovableItems();
    // 等同additem，但使用redo/undo来添加，可以进行redo/undo操作
    QUndoCommand* addItem_(QGraphicsItem* item);
    QUndoCommand* addItems_(const QList< QGraphicsItem* >& its);
    // 等同removeItem，但使用redo/undo来添加，可以进行redo/undo操作
    QUndoCommand* removeItem_(QGraphicsItem* item);
    QUndoCommand* removeItems_(const QList< QGraphicsItem* >& its);
    // 导出为pixmap,dpi=0代表不考虑dpi
    QPixmap toPixamp(int dpi = 0);
    // 保存为图片
    QImage toImage(int dpi = 0);
    // 链接模式
    void beginLink(DAGraphicsLinkItem* linkItem, LinkMode lm = LinkModeAutoStartEndFollowMouseClick);
    // 判断当前是否是链接模式
    bool isStartLink() const;
    // 结束链接模式，结束后会发出linkCompleted信号
    void endLink();
    // 取消链接模式
    virtual void cancelLink();
    // 取消
    virtual void cancel();
    // 获取当前正在进行连线的连接线item
    DAGraphicsLinkItem* getCurrentLinkItem() const;
    // 设置忽略链接事件的处理，主要忽略mousePressEvent，mouseMoveEvent的链接事件，
    // 这个函数一般是在子类中的重载函数中调用，用于进行一些特殊处理需要暂时屏蔽掉链接事件
    void setIgnoreLinkEvent(bool on);
    bool isIgnoreLinkEvent() const;
    // 选中的item进行分组，支持redo/undo
    void groupingSelectItems_();
    // 移除选中的分组
    void removeSelectItemGroup_();
    // 是否允许对齐网格
    bool isEnableSnapToGrid() const;
    // 是否显示网格
    bool isShowGridLine();
    // 设置网格尺寸
    void setGridSize(const QSize& gs);
    QSize getGridSize() const;
    // 网格画笔
    void setGridLinePen(const QPen& p);
    QPen getGridLinePen() const;
    // 设置绘制背景使用缓冲
    void setPaintBackgroundInCache(bool on);
    bool isPaintBackgroundInCache() const;
 
    // 回退栈操作
    QUndoStack& undoStack();
    const QUndoStack& undoStack() const;
    QUndoStack* getUndoStack() const;
    void setUndoStackActive();
    void push(QUndoCommand* cmd);
 
    // 通过id查找item,此函数性能为O(n)
    QGraphicsItem* findItemByID(uint64_t id, bool recursion = false) const;
    static QGraphicsItem* findItemByID(const QList< QGraphicsItem* >& its, uint64_t id, bool recursion = false);
 
    // 返回所有顶层的item
    QList< QGraphicsItem* > topItems() const;
    QList< QGraphicsItem* > topItems(const QPointF& scenePos) const;
    // 选中的item
    QList< DAGraphicsItem* > selectedDAItems() const;
    // 设置场景就绪，如果场景还没加载完成，ready为false，一般这个函数在工程加载的时候应用
    void setReady(bool on);
    bool isReady() const;
 
    // 是否当前存在场景动作
    bool isHaveSceneAction() const;
 
    // 获取图层
    QList< DAGraphicsLayout* > getLayouts() const;
    // 是否为只读模式，只读模式不能编辑
    bool isReadOnly() const;
    // 创建文本框
    DAGraphicsTextItem* createText_(const QString& str = QString());
    // 创建矩形
    DAGraphicsRectItem* createRect_(const QPointF& p = QPointF());
    // 注册命令工厂
    void registCommandsFactory(DAGraphicsCommandsFactory* fac);
    DAGraphicsCommandsFactory* commandsFactory();
 
    // 判断点击的item是否可以移动
    virtual bool isItemCanMove(QGraphicsItem* positem, const QPointF& scenePos);
 
public:
    // 获取默认的dpi
    static int getDefaultDPI();
    // dpi转为像素
    static int dpiToPx(int dpi, int r);
    // 把item添加到分组
    static void addItemToGroup(QGraphicsItemGroup* group, const QList< QGraphicsItem* >& willGroupItems);
public slots:
    // 设置对齐网格
    void setEnableSnapToGrid(bool on = true);
    // 显示网格
    void showGridLine(bool on);
    // 选中所有item
    int selectAll();
    // 取消选择
    int unselectAll();
    // 取消选中
    void clearSelection();
    // 设置item的选中状态
    int setSelectionState(const QList< QGraphicsItem* >& its, bool isSelect);
    // 锁定,具体的锁定，有item自行处理，scene只是持有只读的状态，一般item在itemChange中判断是否只读，然后进行动作判断
    void setReadOnly(bool on);
    // 激活一个场景动作，DAAbstractGraphicsSceneAction的内存归scene管理,此函数发射sceneActionActived
    void setupSceneAction(DA::DAAbstractGraphicsSceneAction* act);
    // 清除场景动作，发射sceneActionDeactived信号
    void clearSceneAction();
signals:
    void itemsPositionChanged(const QList< QGraphicsItem* >& items,
                              const QList< QPointF >& oldPos,
                              const QList< QPointF >& newPos);
 
    void itemBodySizeChanged(DAGraphicsResizeableItem* item, const QSizeF& oldSize, const QSizeF& newSize);
 
    void itemRotationChanged(DAGraphicsResizeableItem* item, const qreal& rotation);
 
    void linkCompleted(DAGraphicsLinkItem* linkItem);
 
    void selectItemChanged(DAGraphicsItem* item);
 
    void selectLinkChanged(DAGraphicsLinkItem* item);
 
    void itemsAdded(const QList< QGraphicsItem* >& its);
 
    void itemsRemoved(const QList< QGraphicsItem* >& its);
 
    void sceneActionActived(DA::DAAbstractGraphicsSceneAction* act);
 
    void sceneActionDeactived(DA::DAAbstractGraphicsSceneAction* act);
 
protected:
    // 调用此函数 主动触发itemsPositionChanged信号，这个函数用于 继承此类例如实现了键盘移动item，主动触发此信号
    void emitItemsPositionChanged(const QList< QGraphicsItem* >& items,
                                  const QList< QPointF >& oldPos,
                                  const QList< QPointF >& newPos);
    // 调用此函数 主动触发itemBodySizeChanged信号
    void emitItemBodySizeChanged(DAGraphicsResizeableItem* item, const QSizeF& oldSize, const QSizeF& newSize);
    // 调用此函数 主动触发itemRotationed信号
    void emitItemRotationChanged(DAGraphicsResizeableItem* item, const qreal& rotation);
    // 带信号的addItm
    void addItemWithSignal(QGraphicsItem* item);
 
protected:
    // 鼠标点击事件
    void mousePressEvent(QGraphicsSceneMouseEvent* mouseEvent) override;
    // 鼠标移动事件
    void mouseMoveEvent(QGraphicsSceneMouseEvent* mouseEvent) override;
    // 鼠标释放
    void mouseReleaseEvent(QGraphicsSceneMouseEvent* mouseEvent) override;
    // 绘制背景
    void drawBackground(QPainter* painter, const QRectF& rect) override;
private slots:
    //
    void onSelectionChanged();
 
private:
    void init();
    void checkSelectItem(QGraphicsItem* item);
    int changeAllSelection(bool setSelect);
};
}
#endif  // DAGRAPHICSSCENEWITHUNDOSTACK_H