pdfoptionsio.h

Go to the documentation of this file.

/*
For general Scribus (>=1.3.2) copyright and licensing information please refer
to the COPYING file provided with the program. Following this notice may exist
a copyright and/or license notice that predates the release of Scribus 1.3.2
for which a new license (GPL+exception) is in place.
*/
#ifndef PDFOPTIONSIO_H
#define PDFOPTIONSIO_H

#include <QDomElement>
#include <QList>

#include "pdfoptions.h"
#include "scribusapi.h"

class SCRIBUS_API PDFOptionsIO
{
public:
    PDFOptionsIO(PDFOptions& opts);

    bool writeTo(QIODevice& outDevice, bool includePasswords = false);
    bool writeTo(QString outFileName, bool includePasswords = false);

    bool readFrom(QIODevice& inStream);
    bool readFrom(QString inFileName);

    const QString& lastError() const;

protected:
    // Build and return an XML representation of the settings.
    // QString::null is returned on failure, in which case
    // the error string is set.
    QString buildXMLString();

    // Populate the current DOM tree with the settings from the
    // current PDFOptions instance.
    void buildSettings();

    // Helper functions. Add elements under the root element
    // with a single attribute "value=" set to the passed value.
    void addElem(QDomElement& addTo, QString name, bool value);
    void addElem(QDomElement& addTo, QString name, QString value);
    void addElem(QDomElement& addTo, QString name, int value);
    void addElem(QDomElement& addTo, QString name, double value);
    void addList(QDomElement& addTo, QString name, QList<QString>& value);

    // Helper: add the PresentVals data to the document
    void addPresentationData();
    // Helper: Add the LPI settings to the document
    void addLPISettings();

    // Helper: set the `opts' members from the current DOM tree
    bool readSettings();

    // Helper functions. Read various single elements into variables
    // All of these return true for success. On failure, the passed
    // value pointer is undefined.
    bool readElem(QDomElement& parent, QString name, bool* value);
    bool readElem(QDomElement& parent, QString name, int* value);
    bool readElem(QDomElement& parent, QString name, double* value);
    bool readElem(QDomElement& parent, QString name, QString* value);
    bool readList(QDomElement& parent, QString name, QList<QString>* value);

    bool readPDFVersion();
    bool readPDFFontEmbeddingMode();
    bool readPresentationData();
    bool readLPISettings();

    // Returns the named node under `parent' iff it's unique
    QDomNode getUniqueNode(QDomElement& parent, QString name);

    // Return a QDomElement corresponding to the passed node, ensuring it's a
    // valid element, the only one of its name under `parent', it has name
    // `name', and (by default) has a `value' attribute.
    QDomElement getValueElement(QDomNode& node, QString name, bool isValue = true);

    // The QDomDocument used by the class for all its XML work
    QDomDocument m_doc;
    // The root element
    QDomElement m_root;
    // The PDFOptions instance we're operating on
    PDFOptions* m_opts;
    // Whether to save passwords when writing out settings
    bool m_includePasswords;

    // Version, of the form Mmpr: Major, minor, patch, revision
    // eg 1300 - 1.3.0r0
    static const int formatVersion;

    // Error explanation if a function fails
    // For user only, do not depend on particular values of this.
    QString m_error;
};

#endif