Font.h

Go to the documentation of this file.

//---------------------------------------------------------------------------------------
// Copyright (c) 2001-2025 by Apryse Software Inc. All Rights Reserved.
// Consult legal.txt regarding legal and license information.
//---------------------------------------------------------------------------------------
#ifndef PDFTRON_H_CPPPDFFont
#define PDFTRON_H_CPPPDFFont
 
#include <Common/Matrix2D.h>
#include <Common/UString.h>
#include <Common/Iterator.h>
#include <PDF/Rect.h>
#include <PDF/PathData.h>
#include <PDF/ShapedText.h>
#include <C/PDF/TRN_Font.h>
#include <C/SDF/TRN_SDFDoc.h>
#include <vector>
 
namespace pdftron {
    namespace PDF {

class Font
{
public:
 
    enum StandardType1Font
    {
        e_times_roman = 0,
        e_times_bold,
        e_times_italic,
        e_times_bold_italic,
        e_helvetica,
        e_helvetica_bold,
        e_helvetica_oblique,
        e_helvetica_bold_oblique,
        e_courier,
        e_courier_bold,
        e_courier_oblique,
        e_courier_bold_oblique,
        e_symbol, 
        e_zapf_dingbats,
        e_null                // not a standard font
    };

     Font (SDF::Obj font_dict = 0);

     static Font Create(SDF::SDFDoc& doc, StandardType1Font type, bool embed = false );

     static Font CreateTrueTypeFont(SDF::SDFDoc& doc, const UString& font_path, 
        bool embed=true, bool subset=true);
 
    #ifdef _WIN32
     static Font CreateTrueTypeFont2(SDF::SDFDoc& doc, const void* logfont, 
        bool embed=true, bool subset=true);
    #endif
 
 
     enum Encoding
     {
         e_IdentityH=0,
         e_Indices 
     };

     static Font CreateCIDTrueTypeFont(SDF::SDFDoc& doc, const UString& font_path, 
        bool embed = true, bool subset = true, 
        Encoding encoding=e_IdentityH,
        UInt32 ttc_font_index=0);

    #ifdef _WIN32
     static Font CreateCIDTrueTypeFont2(SDF::SDFDoc& doc, const void* logfonta, 
        bool embed = true, bool subset = true, 
        Encoding encoding=e_IdentityH);
    #endif

#ifdef _WIN32
     static Font CreateCIDTrueTypeFont2Unicode(SDF::SDFDoc& doc, const void* logfontw,
         bool embed = true, bool subset = true,
         Encoding encoding = e_IdentityH);
#endif

    static Font Create(SDF::SDFDoc& doc, Font& from, const UString& char_set);

    static Font Create(SDF::SDFDoc& doc, const char* name, const UString& char_set);

     static Font CreateType1Font(SDF::SDFDoc& doc, const UString& font_path, bool embed = true);
 
    // Common Font methods ----------------------------------------------------------
 
    enum Type
    {
        e_Type1,         // Type 1 PostScript font   
        e_TrueType,           // TrueType font
        e_MMType1,         // Type 1 multiple master PostScript font
        e_Type3,         // Type 3 PostScript font
        e_Type0,         // Type 0 PostScript composite (CID) font
        e_CIDType0,           // Type 0 CID font
        e_CIDType2,           // Type 2 CID font
    };
 
 
     Font(const Font& c);
     Font& operator=(const Font& c);

     Type GetType();

     bool IsSimple();
 
#ifndef SWIG
     static Type GetType(SDF::Obj font_dict);
#endif

     SDF::Obj GetSDFObj ();

     SDF::Obj GetDescriptor();

     const char* GetName();

     const char* GetFamilyName();

     bool IsFixedWidth();

     bool IsSerif();

     bool IsSymbolic();

     bool IsItalic();

     bool IsAllCap();

     bool IsForceBold();

     bool IsHorizontalMode();

     double GetWidth(UInt32 char_code) const;

     double GetMaxWidth();

     double GetMissingWidth();

     Common::Iterator<UInt32> GetCharCodeIterator();
 

    PathData GetGlyphPath(UInt32 char_code,
                      bool conics2cubics, 
                      Common::Matrix2D* transform = 0);
 

    ShapedText GetShapedText(const UString& text_to_shape);

     UString MapToUnicode(UInt32 char_code);
 
#ifndef SWIG
     bool MapToUnicode(UInt32 char_code, 
            Unicode* out_uni_arr, const int in_uni_sz, 
            int &out_chars);
#endif
 
#ifndef SWIG
     const char** GetEncoding();
#endif
 
     bool IsEmbedded();

     const char* GetEmbeddedFontName();

     SDF::Obj GetEmbeddedFont();

     int GetEmbeddedFontBufSize();

     UInt16 GetUnitsPerEm();

     Rect GetBBox();

     double GetAscent();

     double GetDescent();
 
 
    // Type1 specific methods -------------------------------------------------------

     int GetStandardType1FontType();

     bool IsCFF();
 
    // Type3 specific methods -------------------------------------------------------
 
     Common::Matrix2D GetType3FontMatrix();
 
     SDF::Obj GetType3GlyphStream(UInt32 char_code);
 
 
    // Type0 specific methods -------------------------------------------------------
 
 
#ifndef SWIG
     double GetVerticalAdvance(UInt32 char_code, double &out_pos_vect_x, double &out_pos_vect_y);
#endif
 
     std::vector<double> GetVerticalAdvance(UInt32 char_code);

     Font GetDescendant();

     UInt32 MapToCID(UInt32 char_code) const;
 
#ifndef SWIG
     int MapToCID(const UChar* char_data, int char_data_avail, UInt32& out_charcode, UInt32& out_cid) const;
#endif

     void Destroy();
 
// @cond PRIVATE_DOC
#ifndef SWIGHIDDEN
    Font(TRN_Font impl);
    ~Font();   
    TRN_Font mp_font;
#endif
// @endcond
};
 
 
#include <Impl/Font.inl>
 
    };  // namespace PDF
};  // namespace pdftron
 
#endif // PDFTRON_H_CPPPDFFont