// Copyright (C) 2018 Jakub Melka // // This file is part of PdfForQt. // // PdfForQt is free software: you can redistribute it and/or modify // it under the terms of the GNU Lesser General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // PdfForQt 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 Lesser General Public License for more details. // // You should have received a copy of the GNU Lesser General Public License // along with PDFForQt. If not, see . #ifndef PDFDOCUMENT_H #define PDFDOCUMENT_H #include "pdfglobal.h" #include "pdfobject.h" #include #include namespace pdf { /// Storage for objects. This class is not thread safe for writing (calling non-const functions). Caller must ensure /// locking, if this object is used from multiple threads. Calling const functions should be thread safe. class PDFObjectStorage { public: constexpr inline PDFObjectStorage() = default; constexpr inline PDFObjectStorage(const PDFObjectStorage&) = default; constexpr inline PDFObjectStorage(PDFObjectStorage&&) = default; constexpr inline PDFObjectStorage& operator=(const PDFObjectStorage&) = default; constexpr inline PDFObjectStorage& operator=(PDFObjectStorage&&) = default; struct Entry { constexpr inline explicit Entry() = default; inline explicit Entry(PDFInteger generation, PDFObject object) : generation(generation), object(std::move(object)) { } PDFInteger generation = 0; PDFObject object; }; using PDFObjects = std::vector; explicit PDFObjectStorage(PDFObjects&& objects, PDFObject&& trailerDictionary) : m_objects(std::move(objects)), m_trailerDictionary(std::move(trailerDictionary)) { } /// Returns object from the object storage. If invalid reference is passed, /// then null object is returned (no exception is thrown). const PDFObject& getObject(PDFObjectReference reference) const; /// Returns array of objects stored in this storage const PDFObjects& getObjects() const { return m_objects; } /// Returns trailer dictionary const PDFObject& getTrailerDictionary() const { return m_trailerDictionary; } private: PDFObjects m_objects; PDFObject m_trailerDictionary; }; /// PDF document main class. class PDFDocument { Q_DECLARE_TR_FUNCTIONS(pdf::PDFDocument) public: explicit PDFDocument() = default; const PDFObjectStorage& getStorage() const { return m_pdfObjectStorage; } /// Info about the document. Title, Author, Keywords... struct Info { /// Indicates, that document was modified that it includes trapping information. /// See PDF Reference 1.7, Section 10.10.5 "Trapping Support". enum class Trapped { True, ///< Fully trapped False, ///< Not yet trapped Unknown ///< Either unknown, or it has been trapped partly, not fully }; QString title; QString author; QString subject; QString keywords; QString creator; QString producer; QDateTime creationDate; QDateTime modifiedDate; Trapped trapped = Trapped::Unknown; }; /// Returns info about the document (title, author, etc.) const Info* getInfo() const { return &m_info; } private: friend class PDFDocumentReader; explicit PDFDocument(PDFObjectStorage&& storage) : m_pdfObjectStorage(std::move(storage)) { init(); } /// Initialize data based on object in the storage. /// Can throw exception if error is detected. void init(); /// Initialize the document info from the trailer dictionary. /// If document info is not present, then default document /// info is used. If error is detected, exception is thrown. void initInfo(); /// If object is reference, the dereference attempt is performed /// and object is returned. If it is not a reference, then self /// is returned. If dereference attempt fails, then null object /// is returned (no exception is thrown). const PDFObject& getObject(const PDFObject& object) const; /// Storage of objects PDFObjectStorage m_pdfObjectStorage; /// Info about the PDF document Info m_info; }; inline const PDFObject& PDFDocument::getObject(const PDFObject& object) const { if (object.isReference()) { // Try to dereference the object return m_pdfObjectStorage.getObject(object.getReference()); } return object; } } // namespace pdf #endif // PDFDOCUMENT_H