EnhancedPathShape.h

Go to the documentation of this file.

/* This file is part of the KDE project
 * SPDX-FileCopyrightText: 2007, 2010, 2011 Jan Hambrecht <jaham@gmx.net>
 * SPDX-FileCopyrightText: 2010 Carlos Licea <carlos@kdab.com>
 * SPDX-FileCopyrightText: 2010 Nokia Corporation and /or its subsidiary(-ies).
 *   Contact: Suresh Chande suresh.chande@nokia.com
 *
 * SPDX-License-Identifier: LGPL-2.0-or-later
 */
 
#ifndef KOENHANCEDPATHSHAPE_H
#define KOENHANCEDPATHSHAPE_H
 
#include <KoParameterShape.h>
#include <QList>
#include <QMap>
#include <QRectF>
#include <QStringList>
 
#define EnhancedPathShapeId "EnhancedPathShape"
 
class EnhancedPathCommand;
class EnhancedPathHandle;
class EnhancedPathFormula;
class EnhancedPathParameter;
class KoShapeSavingContext;
class KoShapeLoadingContext;
 
class EnhancedPathShape : public KoParameterShape
{
public:
    EnhancedPathShape(const QRect &viewBox);
    ~EnhancedPathShape() override;
 
    KoShape* cloneShape() const override;
 
    qreal evaluateReference(const QString &reference);
 
    qreal evaluateConstantOrReference(const QString &val);
 
    void modifyReference(const QString &reference, qreal value);
 
    // from KoShape
    void setSize(const QSizeF &newSize) override;
    // from KoParameterShape
    QPointF normalize() override;
 
    void addFormula(const QString &name, const QString &formula);
 
    void addHandle(const QMap<QString, QVariant> &handle);
 
    void addModifiers(const QString &modifiers);
 
    void addCommand(const QString &command);
 
    QRect viewBox() const;
 
    QPointF shapeToViewbox(const QPointF &point) const;
 
    //NOTE: in the standard nothing is mentioned about the priorities of the transformations"
    //it's assumed like this because of the behavior shown in OOo
    void setMirrorHorizontally(bool mirrorHorizontally);
 
    //NOTE: in the standard nothing is mentioned about the priorities of the transformations"
    //it's assumed like this because of the behavior shown in OOo
    void setMirrorVertically(bool mirrorVertically);
 
    // Sets member variable representing draw:path-stretchpoint-x attribute
    void setPathStretchPointX(qreal pathStretchPointX);
 
    // Sets member variable representing draw:path-stretchpoint-y attribute
    void setPathStretchPointY(qreal pathStretchPointY);
 
    EnhancedPathParameter *parameter(const QString &text);
 
protected:
    //from KoShape
    void shapeChanged(ChangeType type, KoShape *shape = 0) override;
    // from KoParameterShape
    void moveHandleAction(int handleId, const QPointF &point, Qt::KeyboardModifiers modifiers = Qt::NoModifier) override;
    // from KoParameterShape
    void updatePath(const QSizeF &size) override;
 
private:
    EnhancedPathShape(const EnhancedPathShape &rhs);
 
    void evaluateHandles();
    void reset();
 
    void parsePathData(const QString &data);
 
    void addCommand(const QString &command, bool triggerUpdate);
 
    void updateTextArea();
 
    void enableResultCache(bool enable);
 
    // This function checks if draw:path-stretchpoint-x or draw:path-stretchpoint-y attributes are set.
    // If the attributes are set the path shape coordinates (m_subpaths) are changed so that the form
    // of the shape is preserved after stretching. It is needed for example in round-rectangles, to
    // have the corners round after stretching. Without it the corners would be elliptical.
    // Returns true if any points were actually changed, otherwise false.
    bool useStretchPoints(const QSizeF &size, qreal &scale);
 
    typedef QMap<QString, EnhancedPathFormula *> FormulaStore;
    typedef QList<qreal> ModifierStore;
    typedef QMap<QString, EnhancedPathParameter *> ParameterStore;
 
    QRect m_viewBox;     
    QRectF m_viewBound;   
    QTransform m_viewMatrix; 
    QTransform m_mirrorMatrix; 
    QPointF m_viewBoxOffset;
    QStringList m_textArea;
    QList<EnhancedPathCommand *> m_commands; 
    QList<EnhancedPathHandle *> m_enhancedHandles; 
    FormulaStore m_formulae;     
    ModifierStore m_modifiers;   
    ParameterStore m_parameters; 
    bool m_mirrorVertically; 
    bool m_mirrorHorizontally; 
    qreal m_pathStretchPointX; 
    qreal m_pathStretchPointY; 
    QHash<QString, qreal> m_resultCache; 
    bool m_cacheResults; 
};
 
#endif // KOENHANCEDPATHSHAPE_H