font.h

// Copyright (c) 2009-2025 Avanquest Software. All rights reserved.
 
#ifndef PDFSDK_CXX_PDF_FONT_H_INCLUDED_
#define PDFSDK_CXX_PDF_FONT_H_INCLUDED_
 
#include <functional>
#include <memory>
#include <optional>
#include <string>
#include <string_view>
#include <vector>
 
#include <pdfsdk/core/content.h>
#include <pdfsdk/cxx/bytes.h>
#include <pdfsdk/cxx/math.h>
#include <pdfsdk/cxx/read_stream.h>
 
#include "forward_declarations.h"
#include "wrapper_base.h"
 
namespace PDF {
 
class OutlineEnumMonitor;

class Font : public detail::RefCountedHandle<PDEFont> {
public:
    static Font CreateFromPdfObject(const Object& object);

    Object GetPdfObject() const;

    PDEFontSubtype GetSubtype() const;

    PDAtom GetName() const;

    PDEFontMetrics GetMetrics() const;

    Matrix GetFontMatrix() const;

    RectF GetFontBBox() const;

    bool IsEmbedded() const;

    PDEFontFileFormat GetFontFileFormat() const;

    ReadStream OpenFontFileStream() const;

    std::vector<Byte> GetFontFileData() const;

    size_t GetFontFileSize() const;

    PDEWritingMode GetWritingMode() const;

    PDEType3GlyphInfo GetType3GlyphInfo(uint8_t charcode) const;

    Content GetType3CharProc(uint8_t charcode) const;

    void SetType3CharProc(uint8_t charcode, const PDEType3GlyphInfo& glyphInfo, const Content& content);
 
#ifndef SWIG
    void EnumCharOutline(const char* codepoint, size_t codepointLen, OutlineEnumMonitor& mon) const;
#endif

    void EnumCharOutline(const std::string& codepoint, OutlineEnumMonitor& mon) const;
 
#ifndef SWIG
    int16_t GetCharWidth(const char* codepoint, size_t codepointLen) const;
#endif

    int16_t GetCharWidth(const std::string& codepoint) const;
 
#ifndef SWIG
    bool IsGlyphPresent(const char* codepoint, size_t codepointLen) const;
#endif

    bool IsGlyphPresent(const std::string& codepoint) const;
 
#ifndef SWIG
    PDEGlyphVertMetric GetCharVertMetric(const char* codepoint, size_t codepointLen) const;
#endif

    PDEGlyphVertMetric GetCharVertMetric(const std::string& codepoint) const;

    PDFontStyle GetStyle() const;

    PDFontInfo GetFontInfo() const;
 
    PDECIDSystemInfo GetCIDSystemInfo() const;

    PDAtom GetEncodingName() const;

    bool CanTypeUnicode(const std::wstring& unicode) const;

    bool IsFauxed() const;

    PDFontInfo GetFauxFontInfo() const;

    std::optional<PDFontInfo> FindSubstFontInfo(bool forceBold = false, bool forceItalic = false) const;

    bool HasValidToUnicodeMap(PDEFontToUnicodeCheckFlags checkFlags = 0) const;

    void CreateToUnicodeMap(PDF::Document document, PDEFontToUnicodeCreateFlags createFlags = kPDEFontToUnicodeCreateDefault);

    bool HasValidWidths() const;

    void CreateWidths(PDF::Document document);

    bool HasValidCIDSet() const;

    bool HasRenderableGlyphs() const;

    void CreateCIDSet(PDF::Document document);

    bool HasValidCharSet() const;

    void CreateCharSet(PDF::Document document);
 
#ifndef SWIG
    std::wstring CharToUnicode(const char* codepoint, size_t codepointLen, bool useOnlyToUnicode = false) const;
#endif

    std::wstring CharToUnicode(const std::string& codepoint, bool useOnlyToUnicode = false) const;
 
#ifndef SWIG
    std::string UnicodeToChar(const UnicodeChar* unicode, size_t unicodeLen) const;
#endif

    std::string UnicodeToChar(const std::wstring& unicode) const;

    RectF GetType3GlyphsBBox() const;
 
    PDF_CXX_CORE_WRAPPER_DEFINE_MEMBERS_(Font, PDEFont)
};
 
class OutlineEnumMonitor {
public:
    virtual ~OutlineEnumMonitor() = default;
    virtual void MoveTo(const PDPointF& to) = 0;
    virtual void LineTo(const PDPointF& to) = 0;
    virtual void ConicCurveTo(const PDPointF& c, const PDPointF& to) = 0;
    virtual void CubicCurveTo(const PDPointF& c1, const PDPointF& c2, const PDPointF& to) = 0;
};

using FontSubstitutionID = uint32_t;

FontSubstitutionID AddFontNameSubstitution(PDAtom pdfFontName, PDAtom familyName, PDFontStyle style = kPDFontStyleRegular);

bool RemoveFontNameSubstitution(FontSubstitutionID id);

FontSubstitutionID AddCIDFontSubstitution(const PDECIDSystemInfo& cidSystemInfo, PDAtom familyName, PDFontStyle style = kPDFontStyleRegular);

bool RemoveCIDFontSubstitution(FontSubstitutionID id);
 
}  // namespace PDF
 
#include "font_impl.inl"
 
#endif  // PDFSDK_CXX_PDF_FONT_H_INCLUDED_