/***************************************************************************//*                                                                         *//*  tttypes.h                                                              *//*                                                                         *//*    Basic SFNT/TrueType type definitions and interface (specification    *//*    only).                                                               *//*                                                                         *//*  Copyright 1996-2001, 2002 by                                           *//*  David Turner, Robert Wilhelm, and Werner Lemberg.                      *//*                                                                         *//*  This file is part of the FreeType project, and may only be used,       *//*  modified, and distributed under the terms of the FreeType project      *//*  license, LICENSE.TXT.  By continuing to use, modify, or distribute     *//*  this file you indicate that you have read the license and              *//*  understand and accept it fully.                                        *//*                                                                         *//***************************************************************************/#ifndef __TTTYPES_H__#define __TTTYPES_H__#include <ft2build.h>#include FT_TRUETYPE_TABLES_H#include FT_INTERNAL_OBJECTS_HFT_BEGIN_HEADER  /*************************************************************************/  /*************************************************************************/  /*************************************************************************/  /***                                                                   ***/  /***                                                                   ***/  /***             REQUIRED TRUETYPE/OPENTYPE TABLES DEFINITIONS         ***/  /***                                                                   ***/  /***                                                                   ***/  /*************************************************************************/  /*************************************************************************/  /*************************************************************************/  /*************************************************************************/  /*                                                                       */  /* <Struct>                                                              */  /*    TTC_HeaderRec                                                      */  /*                                                                       */  /* <Description>                                                         */  /*    TrueType collection header.  This table contains the offsets of    */  /*    the font headers of each distinct TrueType face in the file.       */  /*                                                                       */  /* <Fields>                                                              */  /*    tag     :: Must be `ttc ' to indicate a TrueType collection.       */  /*                                                                       */  /*    version :: The version number.                                     */  /*                                                                       */  /*    count   :: The number of faces in the collection.  The             */  /*               specification says this should be an unsigned long, but */  /*               we use a signed long since we need the value -1 for     */  /*               specific purposes.                                      */  /*                                                                       */  /*    offsets :: The offsets of the font headers, one per face.          */  /*                                                                       */  typedef struct  TTC_HeaderRec_  {    FT_ULong   tag;    FT_Fixed   version;    FT_Long    count;    FT_ULong*  offsets;  } TTC_HeaderRec;  /*************************************************************************/  /*                                                                       */  /* <Struct>                                                              */  /*    SFNT_HeaderRec                                                     */  /*                                                                       */  /* <Description>                                                         */  /*    SFNT file format header.                                           */  /*                                                                       */  /* <Fields>                                                              */  /*    format_tag     :: The font format tag.                             */  /*                                                                       */  /*    num_tables     :: The number of tables in file.                    */  /*                                                                       */  /*    search_range   :: Must be `16 * (max power of 2 <= num_tables)'.   */  /*                                                                       */  /*    entry_selector :: Must be log2 of `search_range / 16'.             */  /*                                                                       */  /*    range_shift    :: Must be `num_tables * 16 - search_range'.        */  /*                                                                       */  typedef struct  SFNT_HeaderRec_  {    FT_ULong   format_tag;    FT_UShort  num_tables;    FT_UShort  search_range;    FT_UShort  entry_selector;    FT_UShort  range_shift;    FT_ULong   offset;  /* not in file */  } SFNT_HeaderRec, *SFNT_Header;  /*************************************************************************/  /*                                                                       */  /* <Struct>                                                              */  /*    TT_TableDirRec                                                     */  /*                                                                       */  /* <Description>                                                         */  /*    This structure models a TrueType table directory.  It is used to   */  /*    access the various tables of the font face.                        */  /*                                                                       */  /* <Fields>                                                              */  /*    version       :: The version number; starts with 0x00010000.       */  /*                                                                       */  /*    numTables     :: The number of tables.                             */  /*                                                                       */  /*    searchRange   :: Unused.                                           */  /*                                                                       */  /*    entrySelector :: Unused.                                           */  /*                                                                       */  /*    rangeShift    :: Unused.                                           */  /*                                                                       */  /* <Note>                                                                */  /*    This structure is only used during font opening.                   */  /*                                                                       */  typedef struct  TT_TableDirRec_  {    FT_Fixed   version;        /* should be 0x10000 */    FT_UShort  numTables;      /* number of tables  */    FT_UShort  searchRange;    /* These parameters are only used  */    FT_UShort  entrySelector;  /* for a dichotomy search in the   */    FT_UShort  rangeShift;     /* directory.  We ignore them.     */  } TT_TableDirRec;  /*************************************************************************/  /*                                                                       */  /* <Struct>                                                              */  /*    TT_TableRec                                                        */  /*                                                                       */  /* <Description>                                                         */  /*    This structure describes a given table of a TrueType font.         */  /*                                                                       */  /* <Fields>                                                              */  /*    Tag      :: A four-bytes tag describing the table.                 */  /*                                                                       */  /*    CheckSum :: The table checksum.  This value can be ignored.        */  /*                                                                       */  /*    Offset   :: The offset of the table from the start of the TrueType */  /*                font in its resource.                                  */  /*                                                                       */  /*    Length   :: The table length (in bytes).                           */  /*                                                                       */  typedef struct  TT_TableRec_  {    FT_ULong  Tag;        /*        table type */    FT_ULong  CheckSum;   /*    table checksum */    FT_ULong  Offset;     /* table file offset */    FT_ULong  Length;     /*      table length */  } TT_TableRec, *TT_Table;  /*************************************************************************/  /*                                                                       */  /* <Struct>                                                              */  /*    TT_CMapDirRec                                                      */  /*                                                                       */  /* <Description>                                                         */  /*    This structure describes the directory of the `cmap' table,        */  /*    containing the font's character mappings table.                    */  /*                                                                       */  /* <Fields>                                                              */  /*    tableVersionNumber :: The version number.                          */  /*                                                                       */  /*    numCMaps           :: The number of charmaps in the font.          */  /*                                                                       */  /* <Note>                                                                */  /*    This structure is only used during font loading.                   */  /*                                                                       */  typedef struct  TT_CMapDirRec_  {    FT_UShort  tableVersionNumber;    FT_UShort  numCMaps;  } TT_CMapDirRec, *TT_CMapDir;  /*************************************************************************/  /*                                                                       */  /* <Struct>                                                              */  /*    TT_CMapDirEntryRec                                                 */  /*                                                                       */  /* <Description>                                                         */  /*    This structure describes a charmap in a TrueType font.             */  /*                                                                       */  /* <Fields>                                                              */  /*    platformID :: An ID used to specify for which platform this        */  /*                  charmap is defined (FreeType manages all platforms). */  /*                                                                       */  /*    encodingID :: A platform-specific ID used to indicate which source */  /*                  encoding is used in this charmap.                    */  /*                                                                       */  /*    offset     :: The offset of the charmap relative to the start of   */  /*                  the `cmap' table.                                    */  /*                                                                       */  /* <Note>                                                                */  /*    This structure is only used during font loading.                   */  /*                                                                       */  typedef struct  TT_CMapDirEntryRec_  {    FT_UShort  platformID;    FT_UShort  platformEncodingID;    FT_Long    offset;  } TT_CMapDirEntryRec, *TT_CMapDirEntry;  /*************************************************************************/  /*                                                                       */  /* <Struct>                                                              */  /*    TT_LongMetricsRec                                                  */  /*                                                                       */  /* <Description>                                                         */  /*    A structure modeling the long metrics of the `hmtx' and `vmtx'     */  /*    TrueType tables.  The values are expressed in font units.          */  /*                                                                       */  /* <Fields>                                                              */  /*    advance :: The advance width or height for the glyph.              */  /*                                                                       */  /*    bearing :: The left-side or top-side bearing for the glyph.        */  /*                                                                       */  typedef struct  TT_LongMetricsRec_  {    FT_UShort  advance;    FT_Short   bearing;