PdfMetadata.h

// SPDX-FileCopyrightText: 2021 Francesco Pretto <ceztko@gmail.com>
// SPDX-License-Identifier: LGPL-2.0-or-later OR MPL-2.0
 
#ifndef PDF_METADATA
#define PDF_METADATA
 
#include "PdfInfo.h"
#include "PdfXMPPacket.h"
 
namespace PoDoFo
{
    class PdfMetadataStore;
    class PdfDocument;
 
    class PODOFO_API PdfMetadata final
    {
        friend class PdfDocument;
        friend class PdfCatalog;
 
    private:
        PdfMetadata(PdfDocument& doc);
        PdfMetadata(PdfMetadata&) = delete;
 
    public:
        ~PdfMetadata();
 
        void SetTitle(nullable<const PdfString&> title);
 
        nullable<const PdfString&> GetTitle() const;
 
        void SetAuthor(nullable<const PdfString&> author);
 
        nullable<const PdfString&> GetAuthor() const;
 
        void SetSubject(nullable<const PdfString&> subject);
 
        nullable<const PdfString&> GetSubject() const;
 
        nullable<const PdfString&> GetKeywordsRaw() const;
 
        void SetKeywords(std::vector<std::string> keywords);
 
        std::vector<std::string> GetKeywords() const;
 
        void SetCreator(nullable<const PdfString&> creator);
 
        nullable<const PdfString&> GetCreator() const;
 
        void SetProducer(nullable<const PdfString&> producer);
 
        nullable<const PdfString&> GetProducer() const;
 
        void SetCreationDate(nullable<PdfDate> date);
 
        nullable<const PdfDate&> GetCreationDate() const;
 
        void SetModifyDate(nullable<PdfDate> date);
 
        nullable<const PdfDate&> GetModifyDate() const;
 
        void SetTrapped(nullable<bool> trapped);
 
        nullable<bool>GetTrapped() const;
 
        void SetPdfVersion(PdfVersion version);
 
        PdfVersion GetPdfVersion() const;
 
        PdfALevel GetPdfALevel() const;
 
        void SetPdfALevel(PdfALevel level);
 
        PdfUALevel GetPdfUALevel() const;
 
        void SetPdfUALevel(PdfUALevel version);
 
        nullable<const PdfString&> GetProperty(PdfAdditionalMetadata prop) const;
 
        void SetProperty(PdfAdditionalMetadata prop, nullable<const PdfString&> value);
 
        void SyncXMPMetadata(bool resetXMPPacket = false);
 
        bool TrySyncXMPMetadata();
 
        std::unique_ptr<PdfXMPPacket> TakeXMPPacket();
 
    private:
        void Invalidate();
 
    private:
        PdfMetadata& operator=(PdfMetadata&) = delete;
 
        void setKeywords(nullable<const PdfString&> keywords);
        void ensureInitialized();
        void syncXMPMetadata(bool resetXMPPacket);
        void invalidate();
 
    private:
        PdfDocument* m_doc;
        PdfMetadataStore* m_metadata;
        bool m_xmpSynced;
        std::unique_ptr<PdfXMPPacket> m_packet;
    };
}
 
#endif // PDF_METADATA