/***************************************************************************//*                                                                         *//*  tttypes.h                                                              *//*                                                                         *//*    Basic SFNT/TrueType type definitions and interface (specification    *//*    only).                                                               *//*                                                                         *//*  Copyright 1996-2001, 2002, 2004, 2005 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_H#ifdef TT_CONFIG_OPTION_GX_VAR_SUPPORT#include FT_MULTIPLE_MASTERS_H#endifFT_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_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_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;  } TT_LongMetricsRec, *TT_LongMetrics;  /*************************************************************************/  /*                                                                       */  /* <Type>                                                                */  /*    TT_ShortMetrics                                                    */  /*                                                                       */  /* <Description>                                                         */  /*    A simple type to model the short metrics of the `hmtx' and `vmtx'  */  /*    tables.                                                            */  /*                                                                       */  typedef FT_Short  TT_ShortMetrics;  /*************************************************************************/  /*                                                                       */  /* <Struct>                                                              */  /*    TT_NameEntryRec                                                    */  /*                                                                       */  /* <Description>                                                         */  /*    A structure modeling TrueType name records.  Name records are used */  /*    to store important strings like family name, style name,           */  /*    copyright, etc. in _localized_ versions (i.e., language, encoding, */  /*    etc).                                                              */  /*                                                                       */  /* <Fields>                                                              */  /*    platformID   :: The ID of the name's encoding platform.            */  /*                                                                       */  /*    encodingID   :: The platform-specific ID for the name's encoding.  */  /*                                                                       */  /*    languageID   :: The platform-specific ID for the name's language.  */  /*                                                                       */  /*    nameID       :: The ID specifying what kind of name this is.       */  /*                                                                       */  /*    stringLength :: The length of the string in bytes.                 */  /*                                                                       */  /*    stringOffset :: The offset to the string in the `name' table.      */  /*                                                                       */  /*    string       :: A pointer to the string's bytes.  Note that these  */  /*                    are usually UTF-16 encoded characters.             */  /*                                                                       */  typedef struct  TT_NameEntryRec_  {    FT_UShort  platformID;    FT_UShort  encodingID;    FT_UShort  languageID;    FT_UShort  nameID;    FT_UShort  stringLength;    FT_ULong   stringOffset;    /* this last field is not defined in the spec */    /* but used by the FreeType engine            */    FT_Byte*   string;  } TT_NameEntryRec, *TT_NameEntry;  /*************************************************************************/  /*                                                                       */