/************************************************************************ ** ** @file vdomdocument.h ** @author Roman Telezhynskyi ** @date November 15, 2013 ** ** @brief ** @copyright ** This source code is part of the Valentina project, a pattern making ** program that allows creating and modelling patterns of clothing. ** Copyright (C) 2013-2015 Valentina project ** All Rights Reserved. ** ** Valentina is free software: you can redistribute it and/or modify ** it under the terms of the GNU General Public License as published by ** the Free Software Foundation, either version 3 of the License, or ** (at your option) any later version. ** ** Valentina is distributed in the hope that it will be useful, ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** GNU General Public License for more details. ** ** You should have received a copy of the GNU General Public License ** along with Valentina. If not, see . ** *************************************************************************/ #ifndef VDOMDOCUMENT_H #define VDOMDOCUMENT_H #include #include #include #include #include #include #include #include #include #include #include #include #include "../ifc/ifcdef.h" #include "../vmisc/def.h" #include "../vmisc/diagnostic.h" #include "../vmisc/logging.h" class QDomElement; class QDomNode; template class QVector; template class QFutureWatcher; Q_DECLARE_LOGGING_CATEGORY(vXML) QT_WARNING_PUSH QT_WARNING_DISABLE_GCC("-Weffc++") QT_WARNING_DISABLE_GCC("-Wnon-virtual-dtor") /** * @brief The VDomDocument class represents a Valentina document (.val file). * * A Valentina document describes the construction of a sewing pattern. The * information is stored in XML format. By parsing a VDomDocument, the contained * pattern is rendered to a Valentina graphics scene (VMainGraphicsScene). * * A sewing pattern consists of zero or more increments and one * or more pattern pieces. * * An increment is an auxiliary variable that is calculated from regular measurement * variables (that belong to the multisize measurements table). Increments are used to * create a graduation schema for the sewing pattern. * * A pattern piece contains * 1) auxiliary pattern construction elements (calculation), * 2) pattern construction elements (modeling), and * 3) special markers, e.g. seam allowances (details). * Of these, 2) and 3) are visible in the final pattern (draw mode 'Modeling'), * 1) is only displayed when editing (draw mode 'Calculation') the pattern. */ class VDomDocument : public QObject, public QDomDocument { Q_OBJECT public: static const QString AttrId; static const QString AttrText; static const QString AttrBold; static const QString AttrItalic; static const QString AttrAlignment; static const QString AttrFSIncrement; static const QString TagVersion; static const QString TagUnit; static const QString TagLine; explicit VDomDocument(QObject *parent = nullptr); virtual ~VDomDocument(); QDomElement elementById(quint32 id, const QString &tagName = QString()); template void SetAttribute(QDomElement &domElement, const QString &name, const T &value) const; static quint32 GetParametrUInt(const QDomElement& domElement, const QString &name, const QString &defValue); static bool GetParametrBool(const QDomElement& domElement, const QString &name, const QString &defValue); static NodeUsage GetParametrUsage(const QDomElement& domElement, const QString &name); static void SetParametrUsage(QDomElement& domElement, const QString &name, const NodeUsage &value); static QString GetParametrString(const QDomElement& domElement, const QString &name, const QString &defValue = QString()); static QString GetParametrEmptyString(const QDomElement& domElement, const QString &name); static qreal GetParametrDouble(const QDomElement& domElement, const QString &name, const QString &defValue); static quint32 GetParametrId(const QDomElement& domElement); Unit MUnit() const; static void ValidateXML(const QString &schema, const QString &fileName); virtual void setXMLContent(const QString &fileName); static QString UnitsHelpString(); virtual bool SaveDocument(const QString &fileName, QString &error); QString Major() const; QString Minor() const; QString Patch() const; QString GetFormatVersionStr() const; static int GetFormatVersion(const QString &version); static void RemoveAllChildren(QDomElement &domElement); QDomNode ParentNodeById(const quint32 &nodeId); QDomElement CloneNodeById(const quint32 &nodeId); QDomElement NodeById(const quint32 &nodeId); static bool SafeCopy(const QString &source, const QString &destination, QString &error); QVector GetLabelTemplate(const QDomElement &element) const; void SetLabelTemplate(QDomElement &element, const QVector &lines); void TestUniqueId() const; protected: bool setTagText(const QString &tag, const QString &text); bool setTagText(const QDomElement &domElement, const QString &text); QString UniqueTagText(const QString &tagName, const QString &defVal = QString()) const; void CollectId(const QDomElement &node, QVector &vector)const; static void ValidateVersion(const QString &version); protected slots: void RefreshElementIdCache(); private slots: void CacheRefreshed(); private: Q_DISABLE_COPY(VDomDocument) /** @brief Map used for finding element by id. */ QHash m_elementIdCache; QFutureWatcher> *m_watcher; static bool find(QHash &cache, const QDomElement &node, quint32 id); QHash RefreshCache(const QDomElement &root) const; bool SaveCanonicalXML(QIODevice *file, int indent, QString &error) const; }; //--------------------------------------------------------------------------------------------------------------------- template /** * @brief SetAttribute set attribute in pattern file. Replace "," by ".". * @param domElement element in xml tree. * @param name name of attribute. * @param value value of attribute. */ inline void VDomDocument::SetAttribute(QDomElement &domElement, const QString &name, const T &value) const { // See specification for xs:decimal const QLocale locale = QLocale::c(); domElement.setAttribute(name, locale.toString(value).remove(locale.groupSeparator())); } //--------------------------------------------------------------------------------------------------------------------- template <> inline void VDomDocument::SetAttribute(QDomElement &domElement, const QString &name, const QString &value) const { domElement.setAttribute(name, value); } //--------------------------------------------------------------------------------------------------------------------- template <> inline void VDomDocument::SetAttribute(QDomElement &domElement, const QString &name, const QChar &value) const { domElement.setAttribute(name, value); } //--------------------------------------------------------------------------------------------------------------------- template <> inline void VDomDocument::SetAttribute(QDomElement &domElement, const QString &name, const bool &value) const { domElement.setAttribute(name, value ? trueStr : falseStr); } //--------------------------------------------------------------------------------------------------------------------- template <> inline void VDomDocument::SetAttribute(QDomElement &domElement, const QString &name, const MeasurementsType &value) const { domElement.setAttribute(name, value == MeasurementsType::Multisize ? QStringLiteral("multisize") : QStringLiteral("individual")); } QT_WARNING_POP #endif // VDOMDOCUMENT_H