Home | History | Annotate | Download | only in internal
      1 /***************************************************************************/
      2 /*                                                                         */
      3 /*  t1types.h                                                              */
      4 /*                                                                         */
      5 /*    Basic Type1/Type2 type definitions and interface (specification      */
      6 /*    only).                                                               */
      7 /*                                                                         */
      8 /*  Copyright 1996-2018 by                                                 */
      9 /*  David Turner, Robert Wilhelm, and Werner Lemberg.                      */
     10 /*                                                                         */
     11 /*  This file is part of the FreeType project, and may only be used,       */
     12 /*  modified, and distributed under the terms of the FreeType project      */
     13 /*  license, LICENSE.TXT.  By continuing to use, modify, or distribute     */
     14 /*  this file you indicate that you have read the license and              */
     15 /*  understand and accept it fully.                                        */
     16 /*                                                                         */
     17 /***************************************************************************/
     18 
     19 
     20 #ifndef T1TYPES_H_
     21 #define T1TYPES_H_
     22 
     23 
     24 #include <ft2build.h>
     25 #include FT_TYPE1_TABLES_H
     26 #include FT_INTERNAL_POSTSCRIPT_HINTS_H
     27 #include FT_INTERNAL_SERVICE_H
     28 #include FT_INTERNAL_HASH_H
     29 #include FT_SERVICE_POSTSCRIPT_CMAPS_H
     30 
     31 
     32 FT_BEGIN_HEADER
     33 
     34 
     35   /*************************************************************************/
     36   /*************************************************************************/
     37   /*************************************************************************/
     38   /***                                                                   ***/
     39   /***                                                                   ***/
     40   /***              REQUIRED TYPE1/TYPE2 TABLES DEFINITIONS              ***/
     41   /***                                                                   ***/
     42   /***                                                                   ***/
     43   /*************************************************************************/
     44   /*************************************************************************/
     45   /*************************************************************************/
     46 
     47 
     48   /*************************************************************************/
     49   /*                                                                       */
     50   /* <Struct>                                                              */
     51   /*    T1_EncodingRec                                                     */
     52   /*                                                                       */
     53   /* <Description>                                                         */
     54   /*    A structure modeling a custom encoding.                            */
     55   /*                                                                       */
     56   /* <Fields>                                                              */
     57   /*    num_chars  :: The number of character codes in the encoding.       */
     58   /*                  Usually 256.                                         */
     59   /*                                                                       */
     60   /*    code_first :: The lowest valid character code in the encoding.     */
     61   /*                                                                       */
     62   /*    code_last  :: The highest valid character code in the encoding     */
     63   /*                  + 1. When equal to code_first there are no valid     */
     64   /*                  character codes.                                     */
     65   /*                                                                       */
     66   /*    char_index :: An array of corresponding glyph indices.             */
     67   /*                                                                       */
     68   /*    char_name  :: An array of corresponding glyph names.               */
     69   /*                                                                       */
     70   typedef struct  T1_EncodingRecRec_
     71   {
     72     FT_Int       num_chars;
     73     FT_Int       code_first;
     74     FT_Int       code_last;
     75 
     76     FT_UShort*   char_index;
     77     FT_String**  char_name;
     78 
     79   } T1_EncodingRec, *T1_Encoding;
     80 
     81 
     82   /* used to hold extra data of PS_FontInfoRec that
     83    * cannot be stored in the publicly defined structure.
     84    *
     85    * Note these can't be blended with multiple-masters.
     86    */
     87   typedef struct  PS_FontExtraRec_
     88   {
     89     FT_UShort  fs_type;
     90 
     91   } PS_FontExtraRec;
     92 
     93 
     94   typedef struct  T1_FontRec_
     95   {
     96     PS_FontInfoRec   font_info;         /* font info dictionary   */
     97     PS_FontExtraRec  font_extra;        /* font info extra fields */
     98     PS_PrivateRec    private_dict;      /* private dictionary     */
     99     FT_String*       font_name;         /* top-level dictionary   */
    100 
    101     T1_EncodingType  encoding_type;
    102     T1_EncodingRec   encoding;
    103 
    104     FT_Byte*         subrs_block;
    105     FT_Byte*         charstrings_block;
    106     FT_Byte*         glyph_names_block;
    107 
    108     FT_Int           num_subrs;
    109     FT_Byte**        subrs;
    110     FT_UInt*         subrs_len;
    111     FT_Hash          subrs_hash;
    112 
    113     FT_Int           num_glyphs;
    114     FT_String**      glyph_names;       /* array of glyph names       */
    115     FT_Byte**        charstrings;       /* array of glyph charstrings */
    116     FT_UInt*         charstrings_len;
    117 
    118     FT_Byte          paint_type;
    119     FT_Byte          font_type;
    120     FT_Matrix        font_matrix;
    121     FT_Vector        font_offset;
    122     FT_BBox          font_bbox;
    123     FT_Long          font_id;
    124 
    125     FT_Fixed         stroke_width;
    126 
    127   } T1_FontRec, *T1_Font;
    128 
    129 
    130   typedef struct  CID_SubrsRec_
    131   {
    132     FT_Int     num_subrs;
    133     FT_Byte**  code;
    134 
    135   } CID_SubrsRec, *CID_Subrs;
    136 
    137 
    138   /*************************************************************************/
    139   /*************************************************************************/
    140   /*************************************************************************/
    141   /***                                                                   ***/
    142   /***                                                                   ***/
    143   /***                AFM FONT INFORMATION STRUCTURES                    ***/
    144   /***                                                                   ***/
    145   /***                                                                   ***/
    146   /*************************************************************************/
    147   /*************************************************************************/
    148   /*************************************************************************/
    149 
    150   typedef struct  AFM_TrackKernRec_
    151   {
    152     FT_Int    degree;
    153     FT_Fixed  min_ptsize;
    154     FT_Fixed  min_kern;
    155     FT_Fixed  max_ptsize;
    156     FT_Fixed  max_kern;
    157 
    158   } AFM_TrackKernRec, *AFM_TrackKern;
    159 
    160   typedef struct  AFM_KernPairRec_
    161   {
    162     FT_UInt  index1;
    163     FT_UInt  index2;
    164     FT_Int   x;
    165     FT_Int   y;
    166 
    167   } AFM_KernPairRec, *AFM_KernPair;
    168 
    169   typedef struct  AFM_FontInfoRec_
    170   {
    171     FT_Bool        IsCIDFont;
    172     FT_BBox        FontBBox;
    173     FT_Fixed       Ascender;
    174     FT_Fixed       Descender;
    175     AFM_TrackKern  TrackKerns;   /* free if non-NULL */
    176     FT_UInt        NumTrackKern;
    177     AFM_KernPair   KernPairs;    /* free if non-NULL */
    178     FT_UInt        NumKernPair;
    179 
    180   } AFM_FontInfoRec, *AFM_FontInfo;
    181 
    182 
    183   /*************************************************************************/
    184   /*************************************************************************/
    185   /*************************************************************************/
    186   /***                                                                   ***/
    187   /***                                                                   ***/
    188   /***                ORIGINAL T1_FACE CLASS DEFINITION                  ***/
    189   /***                                                                   ***/
    190   /***                                                                   ***/
    191   /*************************************************************************/
    192   /*************************************************************************/
    193   /*************************************************************************/
    194 
    195 
    196   typedef struct T1_FaceRec_*   T1_Face;
    197   typedef struct CID_FaceRec_*  CID_Face;
    198 
    199 
    200   typedef struct  T1_FaceRec_
    201   {
    202     FT_FaceRec      root;
    203     T1_FontRec      type1;
    204     const void*     psnames;
    205     const void*     psaux;
    206     const void*     afm_data;
    207     FT_CharMapRec   charmaprecs[2];
    208     FT_CharMap      charmaps[2];
    209 
    210     /* support for Multiple Masters fonts */
    211     PS_Blend        blend;
    212 
    213     /* undocumented, optional: indices of subroutines that express      */
    214     /* the NormalizeDesignVector and the ConvertDesignVector procedure, */
    215     /* respectively, as Type 2 charstrings; -1 if keywords not present  */
    216     FT_Int           ndv_idx;
    217     FT_Int           cdv_idx;
    218 
    219     /* undocumented, optional: has the same meaning as len_buildchar */
    220     /* for Type 2 fonts; manipulated by othersubrs 19, 24, and 25    */
    221     FT_UInt          len_buildchar;
    222     FT_Long*         buildchar;
    223 
    224     /* since version 2.1 - interface to PostScript hinter */
    225     const void*     pshinter;
    226 
    227   } T1_FaceRec;
    228 
    229 
    230   typedef struct  CID_FaceRec_
    231   {
    232     FT_FaceRec       root;
    233     void*            psnames;
    234     void*            psaux;
    235     CID_FaceInfoRec  cid;
    236     PS_FontExtraRec  font_extra;
    237 #if 0
    238     void*            afm_data;
    239 #endif
    240     CID_Subrs        subrs;
    241 
    242     /* since version 2.1 - interface to PostScript hinter */
    243     void*            pshinter;
    244 
    245     /* since version 2.1.8, but was originally positioned after `afm_data' */
    246     FT_Byte*         binary_data; /* used if hex data has been converted */
    247     FT_Stream        cid_stream;
    248 
    249   } CID_FaceRec;
    250 
    251 
    252 FT_END_HEADER
    253 
    254 #endif /* T1TYPES_H_ */
    255 
    256 
    257 /* END */
    258