[Index] |  | [TOC]

# FreeType-2.4.4 API Reference

# Type 1 Tables

## Synopsis

| PS_FontInfoRec |  | T1_Private |  | CID_FaceInfo
| PS_FontInfo |  | T1_Blend_Flags |  | CID_Info
| T1_FontInfo |  | CID_FaceDictRec |  | FT_Has_PS_Glyph_Names
| PS_PrivateRec |  | CID_FaceDict |  | FT_Get_PS_Font_Info
| PS_Private |  | CID_FaceInfoRec |  | FT_Get_PS_Font_Private

This section contains the definition of Type 1-specific tables, including structures related to other PostScript font formats.

#### PS_FontInfoRec

Defined in FT_TYPE1_TABLES_H (freetype/t1tables.h).

      typedef struct  PS_FontInfoRec_
      {
        FT_String*  version;
        FT_String*  notice;
        FT_String*  full_name;
        FT_String*  family_name;
        FT_String*  weight;
        FT_Long     italic_angle;
        FT_Bool     is_fixed_pitch;
        FT_Short    underline_position;
        FT_UShort   underline_thickness;

      } PS_FontInfoRec;

A structure used to model a Type 1 or Type 2 FontInfo dictionary. Note that for Multiple Master fonts, each instance has its own FontInfo dictionary.

[Index] |  | [TOC]

#### PS_FontInfo

Defined in FT_TYPE1_TABLES_H (freetype/t1tables.h).

      typedef struct PS_FontInfoRec_*  PS_FontInfo;

A handle to a PS_FontInfoRec structure.

[Index] |  | [TOC]

#### T1_FontInfo

Defined in FT_TYPE1_TABLES_H (freetype/t1tables.h).

      typedef PS_FontInfoRec  T1_FontInfo;

This type is equivalent to PS_FontInfoRec. It is deprecated but kept to maintain source compatibility between various versions of FreeType.

[Index] |  | [TOC]

#### PS_PrivateRec

Defined in FT_TYPE1_TABLES_H (freetype/t1tables.h).

      typedef struct  PS_PrivateRec_
      {
        FT_Int     unique_id;
        FT_Int     lenIV;

        FT_Byte    num_blue_values;
        FT_Byte    num_other_blues;
        FT_Byte    num_family_blues;
        FT_Byte    num_family_other_blues;

        FT_Short   blue_values[14];
        FT_Short   other_blues[10];

        FT_Short   family_blues      [14];
        FT_Short   family_other_blues[10];

        FT_Fixed   blue_scale;
        FT_Int     blue_shift;
        FT_Int     blue_fuzz;

        FT_UShort  standard_width[1];
        FT_UShort  standard_height[1];

        FT_Byte    num_snap_widths;
        FT_Byte    num_snap_heights;
        FT_Bool    force_bold;
        FT_Bool    round_stem_up;

        FT_Short   snap_widths [13];  /* including std width  */
        FT_Short   snap_heights[13];  /* including std height */

        FT_Fixed   expansion_factor;

        FT_Long    language_group;
        FT_Long    password;

        FT_Short   min_feature[2];

      } PS_PrivateRec;

A structure used to model a Type 1 or Type 2 private dictionary. Note that for Multiple Master fonts, each instance has its own Private dictionary.

[Index] |  | [TOC]

#### PS_Private

Defined in FT_TYPE1_TABLES_H (freetype/t1tables.h).

      typedef struct PS_PrivateRec_*  PS_Private;

A handle to a PS_PrivateRec structure.

[Index] |  | [TOC]

#### T1_Private

Defined in FT_TYPE1_TABLES_H (freetype/t1tables.h).

      typedef PS_PrivateRec  T1_Private;

This type is equivalent to PS_PrivateRec. It is deprecated but kept to maintain source compatibility between various versions of FreeType.

[Index] |  | [TOC]

#### T1_Blend_Flags

Defined in FT_TYPE1_TABLES_H (freetype/t1tables.h).

      typedef enum  T1_Blend_Flags_
      {
        /*# required fields in a FontInfo blend dictionary */
        T1_BLEND_UNDERLINE_POSITION = 0,
        T1_BLEND_UNDERLINE_THICKNESS,
        T1_BLEND_ITALIC_ANGLE,

        /*# required fields in a Private blend dictionary */
        T1_BLEND_BLUE_VALUES,
        T1_BLEND_OTHER_BLUES,
        T1_BLEND_STANDARD_WIDTH,
        T1_BLEND_STANDARD_HEIGHT,
        T1_BLEND_STEM_SNAP_WIDTHS,
        T1_BLEND_STEM_SNAP_HEIGHTS,
        T1_BLEND_BLUE_SCALE,
        T1_BLEND_BLUE_SHIFT,
        T1_BLEND_FAMILY_BLUES,
        T1_BLEND_FAMILY_OTHER_BLUES,
        T1_BLEND_FORCE_BOLD,

        /*# never remove */
        T1_BLEND_MAX

      } T1_Blend_Flags;

A set of flags used to indicate which fields are present in a given blend dictionary (font info or private). Used to support Multiple Masters fonts.

[Index] |  | [TOC]

#### CID_FaceDictRec

Defined in FT_TYPE1_TABLES_H (freetype/t1tables.h).

      typedef struct  CID_FaceDictRec_
      {
        PS_PrivateRec  private_dict;

        FT_UInt        len_buildchar;
        FT_Fixed       forcebold_threshold;
        FT_Pos         stroke_width;
        FT_Fixed       expansion_factor;

        FT_Byte        paint_type;
        FT_Byte        font_type;
        FT_Matrix      font_matrix;
        FT_Vector      font_offset;

        FT_UInt        num_subrs;
        FT_ULong       subrmap_offset;
        FT_Int         sd_bytes;

      } CID_FaceDictRec;

A structure used to represent data in a CID top-level dictionary.

[Index] |  | [TOC]

#### CID_FaceDict

Defined in FT_TYPE1_TABLES_H (freetype/t1tables.h).

      typedef struct CID_FaceDictRec_*  CID_FaceDict;

A handle to a CID_FaceDictRec structure.

[Index] |  | [TOC]

#### CID_FaceInfoRec

Defined in FT_TYPE1_TABLES_H (freetype/t1tables.h).

      typedef struct  CID_FaceInfoRec_
      {
        FT_String*      cid_font_name;
        FT_Fixed        cid_version;
        FT_Int          cid_font_type;

        FT_String*      registry;
        FT_String*      ordering;
        FT_Int          supplement;

        PS_FontInfoRec  font_info;
        FT_BBox         font_bbox;
        FT_ULong        uid_base;

        FT_Int          num_xuid;
        FT_ULong        xuid[16];

        FT_ULong        cidmap_offset;
        FT_Int          fd_bytes;
        FT_Int          gd_bytes;
        FT_ULong        cid_count;

        FT_Int          num_dicts;
        CID_FaceDict    font_dicts;

        FT_ULong        data_offset;

      } CID_FaceInfoRec;

A structure used to represent CID Face information.

[Index] |  | [TOC]

#### CID_FaceInfo

Defined in FT_TYPE1_TABLES_H (freetype/t1tables.h).

      typedef struct CID_FaceInfoRec_*  CID_FaceInfo;

A handle to a CID_FaceInfoRec structure.

[Index] |  | [TOC]

#### CID_Info

Defined in FT_TYPE1_TABLES_H (freetype/t1tables.h).

      typedef CID_FaceInfoRec  CID_Info;

This type is equivalent to CID_FaceInfoRec. It is deprecated but kept to maintain source compatibility between various versions of FreeType.

[Index] |  | [TOC]

#### FT_Has_PS_Glyph_Names

Defined in FT_TYPE1_TABLES_H (freetype/t1tables.h).

      FT_EXPORT( FT_Int )
      FT_Has_PS_Glyph_Names( FT_Face  face );

Return true if a given face provides reliable PostScript glyph names. This is similar to using the FT_HAS_GLYPH_NAMES macro, except that certain fonts (mostly TrueType) contain incorrect glyph name tables. When this function returns true, the caller is sure that the glyph names returned by FT_Get_Glyph_Name are reliable.

input

face | face handle

return
Boolean. True if glyph names are reliable.

[Index] |  | [TOC]

#### FT_Get_PS_Font_Info

Defined in FT_TYPE1_TABLES_H (freetype/t1tables.h).

      FT_EXPORT( FT_Error )
      FT_Get_PS_Font_Info( FT_Face      face,
                           PS_FontInfo  afont_info );

Retrieve the PS_FontInfoRec structure corresponding to a given PostScript font.

input

face | PostScript face handle.

output

afont_info | Output font info structure pointer.

return
FreeType error code. 0 means success.

note
The string pointers within the font info structure are owned by the face and don't need to be freed by the caller. If the font's format is not PostScript-based, this function will return the ‘FT_Err_Invalid_Argument’ error code.

[Index] |  | [TOC]

#### FT_Get_PS_Font_Private

Defined in FT_TYPE1_TABLES_H (freetype/t1tables.h).

      FT_EXPORT( FT_Error )
      FT_Get_PS_Font_Private( FT_Face     face,
                              PS_Private  afont_private );

Retrieve the PS_PrivateRec structure corresponding to a given PostScript font.

input

face | PostScript face handle.

output

afont_private | Output private dictionary structure pointer.

return
FreeType error code. 0 means success.

note
The string pointers within the PS_PrivateRec structure are owned by the face and don't need to be freed by the caller. If the font's format is not PostScript-based, this function returns the ‘FT_Err_Invalid_Argument’ error code.

[Index] |  | [TOC]