KoSvgTextShape.h

Go to the documentation of this file.

/*
 *  SPDX-FileCopyrightText: 2017 Dmitry Kazakov <dimula73@gmail.com>
 *
 *  SPDX-License-Identifier: GPL-2.0-or-later
 */
 
#ifndef KOSVGTEXTSHAPE_H
#define KOSVGTEXTSHAPE_H
 
#include "kritaflake_export.h"
#include <KoSvgTextProperties.h>
 
#include <KoShapeFactoryBase.h>
#include <SvgShape.h>
#include <KoShape.h>
#include <KoSvgText.h>
#include "html/HtmlSavingContext.h"
#include <QFlags>
 
class KoSvgTextShapeMemento;
class KoSvgTextNodeIndex;
typedef QSharedPointer<KoSvgTextShapeMemento> KoSvgTextShapeMementoSP;
 
#define KoSvgTextShape_SHAPEID "KoSvgTextShapeID"
class KRITAFLAKE_EXPORT KoSvgTextShape : public KoShape, public SvgShape
{
public:
    KoSvgTextShape();
    KoSvgTextShape(const KoSvgTextShape &rhs);
    ~KoSvgTextShape() override;
 
    static const QString &defaultPlaceholderText();
 
    KoShape* cloneShape() const override;
 
    void paint(QPainter &painter) const override;
    void paintStroke(QPainter &painter) const override;
 
    QPainterPath outline() const override;
    QRectF outlineRect() const override;
    QRectF boundingRect() const override;
 
    enum class DebugElement {
        CharBbox = 1 << 0,
        LineBox = 1 << 1,
    };
    Q_DECLARE_FLAGS(DebugElements, DebugElement);
    void paintDebug(QPainter &painter, DebugElements elements) const;
 
    void relayout() const;
 
    KoShape * textOutline() const;
 
    enum TextType {
        PrePositionedText = 0, 
        PreformattedText, 
        InlineWrap, 
        TextInShape 
    };
    TextType textType() const;
 
    void setShapesInside(QList<KoShape*> shapesInside);
 
    QList<KoShape*> shapesInside() const;
 
    void setShapesSubtract(QList<KoShape*> shapesSubtract);
 
    QList<KoShape*> shapesSubtract() const;
 
    QMap<QString, QString> shapeTypeSpecificStyles(SvgSavingContext &context) const;
 
    void setResolution(qreal xRes, qreal yRes) override;
 
 
 
    int posLeft(int pos, bool visual = false);
    int posRight(int pos, bool visual = false);
    int posUp(int pos, bool visual = false);
    int posDown(int pos, bool visual = false);
 
    int lineStart(int pos);
    int lineEnd(int pos);
 
    int wordLeft(int pos, bool visual = false);
    int wordRight(int pos, bool visual = false);
 
    int nextIndex(int pos);
 
    int previousIndex(int pos);
 
    int nextLine(int pos);
    int previousLine(int pos);
 
    int wordEnd(int pos);
    int wordStart(int pos);
 
    QPainterPath cursorForPos(int pos, QLineF &caret, QColor &color, double bidiFlagSize = 1.0);
 
    QPainterPath selectionBoxes(int pos, int anchor);
 
    QPainterPath underlines(int pos, int anchor,
                            KoSvgText::TextDecorations decor,
                            KoSvgText::TextDecorationStyle style,
                            qreal minimum, bool thick);
 
    int posForPoint(QPointF point, int start = -1, int end = -1, bool *overlaps = nullptr);
 
    int posForPointLineSensitive(QPointF point);
    int posForIndex(int index, bool firstIndex = false, bool skipSynthetic = false) const;
    int indexForPos(int pos) const;
 
    QPointF initialTextPosition() const;
 
    /*--------------- Edit text ---------------*/
    bool insertText(int pos, QString text);
 
    bool removeText(int &index, int &length);
 
    KoSvgTextProperties propertiesForPos(const int pos, bool inherited = false) const;
 
    QList<KoSvgTextProperties> propertiesForRange(const int startPos, const int endPos, bool inherited = false) const;
 
    void setPropertiesAtPos(int pos, KoSvgTextProperties properties);
 
    void mergePropertiesIntoRange(const int startPos,
                                  const int endPos,
                                  const KoSvgTextProperties properties,
                                  const QSet<KoSvgTextProperties::PropertyId> removeProperties = QSet<KoSvgTextProperties::PropertyId>());
 
 
    std::unique_ptr<KoSvgTextShape> copyRange(int index, int length) const;
 
    bool insertRichText(int pos, const KoSvgTextShape *richText);
 
    void cleanUp();
 
/*****************************************************************************
 * KoSvgTextNodeIndex functions.
 *
 * SVG Text is internally a tree of nodes, with each node having text
 * properties, and the child nodes furthest from the root having text content.
 * While we can access the latter by using ranges, and we can easily access
 * the root node by using -1, there's no way to access the nodes that may
 * be inbetween. KoSvgTextNodeIndex allows accessing these nodes.
 *
 ****************************************************************************/
 
    KoSvgTextNodeIndex findNodeIndexForPropertyId(KoSvgTextProperties::PropertyId propertyId);
 
    QPair<int, int> findRangeForNodeIndex(const KoSvgTextNodeIndex &node) const;
 
    /*--------------- Properties ---------------*/
 
    KoSvgTextProperties textProperties() const;
    QSharedPointer<KoShapeBackground> background() const override;
    void setBackground(QSharedPointer<KoShapeBackground> background) override;
    KoShapeStrokeModelSP stroke() const override;
    void setStroke(KoShapeStrokeModelSP stroke) override;
    QVector<PaintOrder> paintOrder() const override;
    void setPaintOrder(PaintOrder first, PaintOrder second) override;
 
 
    QString plainText();
 
    KoSvgText::WritingMode writingMode() const;
 
    struct KRITAFLAKE_EXPORT TextCursorChangeListener : public ShapeChangeListener {
        void notifyShapeChanged(ChangeType type, KoShape *shape) override;
        virtual void notifyCursorPosChanged(int pos, int anchor) = 0;
        virtual void notifyMarkupChanged() = 0;
    };
    void notifyCursorPosChanged(int pos, int anchor);
    void notifyMarkupChanged();
 
    /*--------------- Converter functions ---------------*/
 
    void convertCharTransformsToPreformatted(bool makeInlineSize = false);
 
    void setCharacterTransformsFromLayout();
 
    /*--------------- Loading / Saving ------------------*/
 
    bool saveSvg(SvgSavingContext &context) override;
    // Used by the html writer.
    bool saveHtml(HtmlSavingContext &context);
 
    void enterNodeSubtree();
    void leaveNodeSubtree();
 
    KoSvgTextShapeMementoSP getMemento();
 
    void setMemento(const KoSvgTextShapeMementoSP memento);
 
    void setMemento(const KoSvgTextShapeMementoSP memento, int pos, int anchor);
 
    void debugParsing();
 
    /***
     * This blocks the shape from automatically calling relayout
     * when the text or properties change. Relayout needs to be called
     * in this mode.
     * Used in the SVGTextLabel.
     */
    void setRelayoutBlocked(const bool disable);
 
    bool relayoutIsBlocked() const;
 
    void setFontMatchingDisabled(const bool disable);
 
    bool fontMatchingDisabled() const;
 
protected:
 
    void shapeChanged(ChangeType type, KoShape *shape) override;
 
private:
    friend class TestSvgText;
    friend class KoSvgTextLoader;
    int nextPos(int pos, bool visual);
 
    int previousPos(int pos, bool visual);
 
    QPainterPath defaultCursorShape();
 
    void setMementoImpl(const KoSvgTextShapeMementoSP memento);
 
    class Private;
    QScopedPointer<Private> d;
};
 
Q_DECLARE_OPERATORS_FOR_FLAGS(KoSvgTextShape::DebugElements)
 
class KRITAFLAKE_EXPORT KoSvgTextShapeMemento {
public:
    KoSvgTextShapeMemento() {}
    virtual ~KoSvgTextShapeMemento() {}
private:
    friend class KoSvgTextShape;
};
 
class KRITAFLAKE_EXPORT KoSvgTextNodeIndex {
public:
    KoSvgTextNodeIndex(const KoSvgTextNodeIndex &rhs);
    ~KoSvgTextNodeIndex();
 
    KoSvgTextProperties *properties();
 
    KoSvgText::TextOnPathInfo *textPathInfo();
 
    KoShape *textPath();
 
private:
    // for internal factory use only
    KoSvgTextNodeIndex();
 
private:
    friend class KoSvgTextShape;
    struct Private;
    QScopedPointer<Private> d;
 
};
 
class KoSvgTextShapeFactory : public KoShapeFactoryBase
{
 
public:
    KoSvgTextShapeFactory();
    ~KoSvgTextShapeFactory() {}
 
    KoShape *createDefaultShape(KoDocumentResourceManager *documentResources = 0) const override;
 
    KoShape *createShape(const KoProperties *params, KoDocumentResourceManager *documentResources = 0) const override;
    bool supports(const QDomElement &e, KoShapeLoadingContext &context) const override;
};
 
 
 
#endif // KOSVGTEXTSHAPE_H