DAGraphicsLinkItem.h

#ifndef DAGRAPHICSLINKITEM_H
#define DAGRAPHICSLINKITEM_H
#include "DAGraphicsViewGlobal.h"
#include "DAGraphicsItem.h"
#include <QGraphicsItem>
class QDomDocument;
class QDomElement;
class QGraphicsSceneMouseEvent;
namespace DA
{
class DAGraphicsScene;
class DAGRAPHICSVIEW_API DAGraphicsLinkItem : public DAGraphicsItem
{
    Q_OBJECT
    DA_DECLARE_PRIVATE(DAGraphicsLinkItem)
public:
    enum AnonymousType
    {
        anonymous = DA::ItemType_DAGraphicsLinkItem
    };
    int type() const override
    {
        return (anonymous);
    }
    enum LinkLineStyle
    {
        LinkLineBezier,    
        LinkLineStraight,  
        LinkLineKnuckle    
    };
 
    enum Orientations
    {
        OrientationStart = 0,  
        OrientationEnd,        
        OrientationBoth        
    };
 
    enum EndPointType
    {
        EndPointNone,       
        EndPointTriangType  
    };
 
public:
    DAGraphicsLinkItem(QGraphicsItem* p = nullptr);
    ~DAGraphicsLinkItem();
    // 设置连接点的形式
    void setEndPointType(Orientations o, EndPointType epType);
    EndPointType getEndPointType(Orientations o) const;
    // 端点大小
    int getEndPointSize() const;
    void setEndPointSize(int v);
    // 连线方式
    void setLinkLineStyle(LinkLineStyle s);
    LinkLineStyle getLinkLineStyle() const;
 
    // 设置线的画笔
    void setLinePen(const QPen& p);
    QPen getLinePen() const;
 
    // 【重要虚函数】更新范围参数
    virtual QRectF updateBoundingRect();
 
    // 设置贝塞尔曲线的控制点的缩放比例，连线时按照控制点的方向延伸出贝塞尔曲线的控制点，延伸的控制点的长度w = length * bezierControlScale
    void setBezierControlScale(qreal rate = 0.25);
    qreal getBezierControlScale() const;
 
    // 开始连接点的位置,位置基于scene
    virtual void setStartScenePosition(const QPointF& scenepostion);
    QPointF getStartScenePosition() const;
 
    // 结束连接点的位置
    virtual void setEndScenePosition(const QPointF& scenepostion);
    QPointF getEndScenePosition() const;
    // 获取链接线
    QPainterPath getLinkLinePainterPath() const;
    // 获取末端(箭头)的绘图路径
    QPainterPath getEndPointPainterPath(Orientations epType) const;
    // 更新末端(箭头)
    void updateEndPoint();
    // 绘图
    virtual void paint(QPainter* painter, const QStyleOptionGraphicsItem* option, QWidget* widget = nullptr) override;
    // 绘制连接线
    virtual void paintLinkLine(QPainter* painter,
                               const QStyleOptionGraphicsItem* option,
                               QWidget* widget,
                               const QPainterPath& linkPath);
    // 绘制箭头
    virtual void paintEndPoint(QPainter* painter,
                               const QStyleOptionGraphicsItem* option,
                               const QPointF& pStart,
                               EndPointType etStart,
                               const QPainterPath& startPainterPath,
                               const QPointF& pEnd,
                               EndPointType etEnd,
                               const QPainterPath& endPainterPath,
                               const QPainterPath& linkPath);
 
    virtual QRectF boundingRect() const override;
    virtual QPainterPath shape() const override;
 
    // 生成painterpath
    virtual QPainterPath generateLinePainterPath(const QPointF& fromPoint,
                                                 const QPointF& toPoint,
                                                 LinkLineStyle linestyle = LinkLineStraight);
    // 生成箭头，绘制的时候需要根据情况进行旋转
    virtual QPainterPath generateEndPointPainterPath(EndPointType epType, int size);
    // 在将要结束链接的回调，通过此回调可以执行完成链接后的相关操作，例如判断末端链接的图元，从而实现路径调整
    // 如果此函数返回false，将代表不接受链接，这时候，结束动作会被跳过，也就是鼠标点击是没有无法结束链接而生成连接线
    virtual bool willCompleteLink();
    // 保存到xml中
    virtual bool saveToXml(QDomDocument* doc, QDomElement* parentElement, const QVersionNumber& ver) const override;
    virtual bool loadFromXml(const QDomElement* parentElement, const QVersionNumber& ver) override;
    // 设置在场景的位置，如果没有分组，和setPos一样，如果分组了，最终也能保证位置在pos位置
    void setScenePos(const QPointF& p);
    void setScenePos(qreal x, qreal y);
 
public:
    // 计算两个点的距离
    static qreal pointLength(const QPointF& a, const QPointF& b);
 
    // 延长线，以一个方向和距离延伸
    static QPointF elongation(const QPointF& orgPoint, AspectDirection d, qreal externLen);
 
    // 判断两个方向是否相对，也就是东对西，南对北就是相对，相对必定平行
    static bool isDirectionOpposite(AspectDirection d1, AspectDirection d2);
 
    // 判断两个方向是否平行
    static bool isDirectionParallel(AspectDirection d1, AspectDirection d2);
 
    // 顺着点1的方向看，点2是否在前面
    static bool isPointInFront(const QPointF& p1, AspectDirection d1, const QPointF& p2);
    // 点是否会相遇
    static bool isPointCanMeet(const QPointF& p1, AspectDirection d1, const QPointF& p2, AspectDirection d2);
    // 针对平行点线，沿着方向移动可以接近，此函数只对平行点线有用
    static bool isParallelPointApproachInDirection(const QPointF& p1, AspectDirection d1, const QPointF& p2, AspectDirection d2);
    // 翻转方向
    static AspectDirection oppositeDirection(AspectDirection d);
    // 返回点1相对点2的方位
    static AspectDirection relativeDirectionOfPoint(const QPointF& p1, const QPointF& p2);
    // 获取线段的末端，这个函数可以返回末端但有不是终端的点，这个点离终端的距离不会超过distanceMaxPx
    static QPointF calcPainterPathEndPoint(const QPainterPath& path,
                                           bool fromStart      = true,
                                           qreal distanceMaxPx = 18.0,
                                           int maxTryCnt       = 10);
 
protected:
    // 获取DAGraphicsScene
    DAGraphicsScene* daScene() const;
    // 开始连接点的位置
    void setStartPosition(const QPointF& p);
    const QPointF& getStartPosition() const;
 
    // 结束连接点的位置
    void setEndPosition(const QPointF& p);
    const QPointF& getEndPosition() const;
    // 获取绘图的画笔
    virtual QPen getPainterPen(const QStyleOptionGraphicsItem* option) const;
    // 生成painterpath
    virtual QPainterPath generateLinkLineBezierPainterPath(const QPointF& fromPos,
                                                           AspectDirection fromDirect,
                                                           const QPointF& toPos,
                                                           AspectDirection toDirect);
    // 生成直线
    virtual QPainterPath generateLinkLineStraightPainterPath(const QPointF& fromPos, const QPointF& toPos);
    // 生成直角线
    virtual QPainterPath generateLinkLineKnucklePainterPath(const QPointF& fromPos,
                                                            AspectDirection fromDirect,
                                                            const QPointF& toPos,
                                                            AspectDirection toDirect);
};
 
}  // end DA
 
#endif  // DAGRAPHICSLINKITEM_H