www.pudn.com > freetype.rar > tttypes.h
/***************************************************************************/ /* */ /* 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 "freetype/tttables.h" #include "freetype/internal/ftobjs.h" FT_BEGIN_HEADER /*************************************************************************/ /*************************************************************************/ /*************************************************************************/ /*** ***/ /*** ***/ /*** REQUIRED TRUETYPE/OPENTYPE TABLES DEFINITIONS ***/ /*** ***/ /*** ***/ /*************************************************************************/ /*************************************************************************/ /*************************************************************************/ /*************************************************************************/ /* */ /**/ /* TTC_HeaderRec */ /* */ /* */ /* TrueType collection header. This table contains the offsets of */ /* the font headers of each distinct TrueType face in the file. */ /* */ /* */ /* 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; /*************************************************************************/ /* */ /* */ /* SFNT_HeaderRec */ /* */ /* */ /* SFNT file format header. */ /* */ /* */ /* 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; /*************************************************************************/ /* */ /* */ /* TT_TableDirRec */ /* */ /* */ /* This structure models a TrueType table directory. It is used to */ /* access the various tables of the font face. */ /* */ /* */ /* version :: The version number; starts with 0x00010000. */ /* */ /* numTables :: The number of tables. */ /* */ /* searchRange :: Unused. */ /* */ /* entrySelector :: Unused. */ /* */ /* rangeShift :: Unused. */ /* */ /* */ /* 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; /*************************************************************************/ /* */ /* */ /* TT_TableRec */ /* */ /* */ /* This structure describes a given table of a TrueType font. */ /* */ /* */ /* 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; /*************************************************************************/ /* */ /* */ /* TT_CMapDirRec */ /* */ /* */ /* This structure describes the directory of the `cmap' table, */ /* containing the font's character mappings table. */ /* */ /* */ /* tableVersionNumber :: The version number. */ /* */ /* numCMaps :: The number of charmaps in the font. */ /* */ /* */ /* This structure is only used during font loading. */ /* */ typedef struct TT_CMapDirRec_ { FT_UShort tableVersionNumber; FT_UShort numCMaps; } TT_CMapDirRec, *TT_CMapDir; /*************************************************************************/ /* */ /* */ /* TT_CMapDirEntryRec */ /* */ /* */ /* This structure describes a charmap in a TrueType font. */ /* */ /* */ /* 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. */ /* */ /* */ /* 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; /*************************************************************************/ /* */ /* */ /* TT_LongMetricsRec */ /* */ /* */ /* A structure modeling the long metrics of the `hmtx' and `vmtx' */ /* TrueType tables. The values are expressed in font units. */ /* */ /* */ /* 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; /*************************************************************************/ /* */ /* */ /* TT_ShortMetrics */ /* */ /* */ /* A simple type to model the short metrics of the `hmtx' and `vmtx' */ /* tables. */ /* */ typedef FT_Short TT_ShortMetrics; /*************************************************************************/ /* */ /* */ /* TT_NameEntryRec */ /* */ /* */ /* 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). */ /* */ /* */ /* 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; /*************************************************************************/ /* */ /* */ /* TT_NameTableRec */ /* */ /* */ /* A structure modeling the TrueType name table. */ /* */ /* */ /* format :: The format of the name table. */ /* */ /* numNameRecords :: The number of names in table. */ /* */ /* storageOffset :: The offset of the name table in the `name' */ /* TrueType table. */ /* */ /* names :: An array of name records. */ /* */ /* stream :: the file's input stream. */ /* */ typedef struct TT_NameTableRec_ { FT_UShort format; FT_UInt numNameRecords; FT_UInt storageOffset; TT_NameEntryRec* names; FT_Stream stream; } TT_NameTableRec, *TT_NameTable; /*************************************************************************/ /*************************************************************************/ /*************************************************************************/ /*** ***/ /*** ***/ /*** OPTIONAL TRUETYPE/OPENTYPE TABLES DEFINITIONS ***/ /*** ***/ /*** ***/ /*************************************************************************/ /*************************************************************************/ /*************************************************************************/ /*************************************************************************/ /* */ /* */ /* TT_GaspRangeRec */ /* */ /* */ /* A tiny structure used to model a gasp range according to the */ /* TrueType specification. */ /* */ /* */ /* maxPPEM :: The maximum ppem value to which `gaspFlag' applies. */ /* */ /* gaspFlag :: A flag describing the grid-fitting and anti-aliasing */ /* modes to be used. */ /* */ typedef struct TT_GaspRangeRec_ { FT_UShort maxPPEM; FT_UShort gaspFlag; } TT_GaspRangeRec, *TT_GaspRange; #define TT_GASP_GRIDFIT 0x01 #define TT_GASP_DOGRAY 0x02 /*************************************************************************/ /* */ /* */ /* TT_GaspRec */ /* */ /* */ /* A structure modeling the TrueType `gasp' table used to specify */ /* grid-fitting and anti-aliasing behaviour. */ /* */ /* */ /* version :: The version number. */ /* */ /* numRanges :: The number of gasp ranges in table. */ /* */ /* gaspRanges :: An array of gasp ranges. */ /* */ typedef struct TT_Gasp_ { FT_UShort version; FT_UShort numRanges; TT_GaspRange gaspRanges; } TT_GaspRec; /*************************************************************************/ /* */ /* */ /* TT_HdmxEntryRec */ /* */ /* */ /* A small structure used to model the pre-computed widths of a given */ /* size. They are found in the `hdmx' table. */ /* */ /* */ /* ppem :: The pixels per EM value at which these metrics apply. */ /* */ /* max_width :: The maximum advance width for this metric. */ /* */ /* widths :: An array of widths. Note: These are 8-bit bytes. */ /* */ typedef struct TT_HdmxEntryRec_ { FT_Byte ppem; FT_Byte max_width; FT_Byte* widths; } TT_HdmxEntryRec, *TT_HdmxEntry; /*************************************************************************/ /* */ /* */ /* TT_HdmxRec */ /* */ /* */ /* A structure used to model the `hdmx' table, which contains */ /* pre-computed widths for a set of given sizes/dimensions. */ /* */ /* */ /* version :: The version number. */ /* */ /* num_records :: The number of hdmx records. */ /* */ /* records :: An array of hdmx records. */ /* */ typedef struct TT_HdmxRec_ { FT_UShort version; FT_Short num_records; TT_HdmxEntry records; } TT_HdmxRec, *TT_Hdmx; /*************************************************************************/ /* */ /* */ /* TT_Kern0_PairRec */ /* */ /* */ /* A structure used to model a kerning pair for the kerning table */ /* format 0. The engine now loads this table if it finds one in the */ /* font file. */ /* */ /* */ /* left :: The index of the left glyph in pair. */ /* */ /* right :: The index of the right glyph in pair. */ /* */ /* value :: The kerning distance. A positive value spaces the */ /* glyphs, a negative one makes them closer. */ /* */ typedef struct TT_Kern0_PairRec_ { FT_UShort left; /* index of left glyph in pair */ FT_UShort right; /* index of right glyph in pair */ FT_FWord value; /* kerning value */ } TT_Kern0_PairRec, *TT_Kern0_Pair; /*************************************************************************/ /*************************************************************************/ /*************************************************************************/ /*** ***/ /*** ***/ /*** EMBEDDED BITMAPS SUPPORT ***/ /*** ***/ /*** ***/ /*************************************************************************/ /*************************************************************************/ /*************************************************************************/ /*************************************************************************/ /* */ /* */ /* TT_SBit_MetricsRec */ /* */ /* */ /* A structure used to hold the big metrics of a given glyph bitmap */ /* in a TrueType or OpenType font. These are usually found in the */ /* `EBDT' (Microsoft) or `bloc' (Apple) table. */ /* */ /* */ /* height :: The glyph height in pixels. */ /* */ /* width :: The glyph width in pixels. */ /* */ /* horiBearingX :: The horizontal left bearing. */ /* */ /* horiBearingY :: The horizontal top bearing. */ /* */ /* horiAdvance :: The horizontal advance. */ /* */ /* vertBearingX :: The vertical left bearing. */ /* */ /* vertBearingY :: The vertical top bearing. */ /* */ /* vertAdvance :: The vertical advance. */ /* */ typedef struct TT_SBit_MetricsRec_ { FT_Byte height; FT_Byte width; FT_Char horiBearingX; FT_Char horiBearingY; FT_Byte horiAdvance; FT_Char vertBearingX; FT_Char vertBearingY; FT_Byte vertAdvance; } TT_SBit_MetricsRec, *TT_SBit_Metrics; /*************************************************************************/ /* */ /* */ /* TT_SBit_SmallMetricsRec */ /* */ /* */ /* A structure used to hold the small metrics of a given glyph bitmap */ /* in a TrueType or OpenType font. These are usually found in the */ /* `EBDT' (Microsoft) or the `bdat' (Apple) table. */ /* */ /* */ /* height :: The glyph height in pixels. */ /* */ /* width :: The glyph width in pixels. */ /* */ /* bearingX :: The left-side bearing. */ /* */ /* bearingY :: The top-side bearing. */ /* */ /* advance :: The advance width or height. */ /* */ typedef struct TT_SBit_Small_Metrics_ { FT_Byte height; FT_Byte width; FT_Char bearingX; FT_Char bearingY; FT_Byte advance; } TT_SBit_SmallMetricsRec, *TT_SBit_SmallMetrics; /*************************************************************************/ /* */ /* */ /* TT_SBit_LineMetricsRec */ /* */ /* */ /* A structure used to describe the text line metrics of a given */ /* bitmap strike, for either a horizontal or vertical layout. */ /* */ /* */ /* ascender :: The ascender in pixels. */ /* */ /* descender :: The descender in pixels. */ /* */ /* max_width :: The maximum glyph width in pixels. */ /* */ /* caret_slope_enumerator :: Rise of the caret slope, typically set */ /* to 1 for non-italic fonts. */ /* */ /* caret_slope_denominator :: Rise of the caret slope, typically set */ /* to 0 for non-italic fonts. */ /* */ /* caret_offset :: Offset in pixels to move the caret for */ /* proper positioning. */ /* */ /* min_origin_SB :: Minimum of horiBearingX (resp. */ /* vertBearingY). */ /* min_advance_SB :: Minimum of */ /* */ /* horizontal advance - */ /* ( horiBearingX + width ) */ /* */ /* resp. */ /* */ /* vertical advance - */ /* ( vertBearingY + height ) */ /* */ /* max_before_BL :: Maximum of horiBearingY (resp. */ /* vertBearingY). */ /* */ /* min_after_BL :: Minimum of */ /* */ /* horiBearingY - height */ /* */ /* resp. */ /* */ /* vertBearingX - width */ /* */ /* pads :: Unused (to make the size of the record */ /* a multiple of 32 bits. */ /* */ typedef struct TT_SBit_LineMetricsRec_ { FT_Char ascender; FT_Char descender; FT_Byte max_width; FT_Char caret_slope_numerator; FT_Char caret_slope_denominator; FT_Char caret_offset; FT_Char min_origin_SB; FT_Char min_advance_SB; FT_Char max_before_BL; FT_Char min_after_BL; FT_Char pads[2]; } TT_SBit_LineMetricsRec, *TT_SBit_LineMetrics; /*************************************************************************/ /* */ /* */ /* TT_SBit_RangeRec */ /* */ /* */ /* A TrueType/OpenType subIndexTable as defined in the `EBLC' */ /* (Microsoft) or `bloc' (Apple) tables. */ /* */ /* */ /* first_glyph :: The first glyph index in the range. */ /* */ /* last_glyph :: The last glyph index in the range. */ /* */ /* index_format :: The format of index table. Valid values are 1 */ /* to 5. */ /* */ /* image_format :: The format of `EBDT' image data. */ /* */ /* image_offset :: The offset to image data in `EBDT'. */ /* */ /* image_size :: For index formats 2 and 5. This is the size in */ /* bytes of each glyph bitmap. */ /* */ /* big_metrics :: For index formats 2 and 5. This is the big */ /* metrics for each glyph bitmap. */ /* */ /* num_glyphs :: For index formats 4 and 5. This is the number of */ /* glyphs in the code array. */ /* */ /* glyph_offsets :: For index formats 1 and 3. */ /* */ /* glyph_codes :: For index formats 4 and 5. */ /* */ /* table_offset :: The offset of the index table in the `EBLC' */ /* table. Only used during strike loading. */ /* */ typedef struct TT_SBit_RangeRec { FT_UShort first_glyph; FT_UShort last_glyph; FT_UShort index_format; FT_UShort image_format; FT_ULong image_offset; FT_ULong image_size; TT_SBit_MetricsRec metrics; FT_ULong num_glyphs; FT_ULong* glyph_offsets; FT_UShort* glyph_codes; FT_ULong table_offset; } TT_SBit_RangeRec, *TT_SBit_Range; /*************************************************************************/ /* */ /* */ /* TT_SBit_StrikeRec */ /* */ /* */ /* A structure used describe a given bitmap strike in the `EBLC' */ /* (Microsoft) or `bloc' (Apple) tables. */ /* */ /* */ /* num_index_ranges :: The number of index ranges. */ /* */ /* index_ranges :: An array of glyph index ranges. */ /* */ /* color_ref :: Unused. `color_ref' is put in for future */ /* enhancements, but these fields are already */ /* in use by other platforms (e.g. Newton). */ /* For details, please see */ /* */ /* http://fonts.apple.com/ */ /* TTRefMan/RM06/Chap6bloc.html */ /* */ /* hori :: The line metrics for horizontal layouts. */ /* */ /* vert :: The line metrics for vertical layouts. */ /* */ /* start_glyph :: The lowest glyph index for this strike. */ /* */ /* end_glyph :: The highest glyph index for this strike. */ /* */ /* x_ppem :: The number of horizontal pixels per EM. */ /* */ /* y_ppem :: The number of vertical pixels per EM. */ /* */ /* bit_depth :: The bit depth. Valid values are 1, 2, 4, */ /* and 8. */ /* */ /* flags :: Is this a vertical or horizontal strike? For */ /* details, please see */ /* */ /* http://fonts.apple.com/ */ /* TTRefMan/RM06/Chap6bloc.html */ /* */ typedef struct TT_SBit_StrikeRec_ { FT_Int num_ranges; TT_SBit_Range sbit_ranges; FT_ULong ranges_offset; FT_ULong color_ref; TT_SBit_LineMetricsRec hori; TT_SBit_LineMetricsRec vert; FT_UShort start_glyph; FT_UShort end_glyph; FT_Byte x_ppem; FT_Byte y_ppem; FT_Byte bit_depth; FT_Char flags; } TT_SBit_StrikeRec, *TT_SBit_Strike; /*************************************************************************/ /* */ /* */ /* TT_SBit_ComponentRec */ /* */ /* */ /* A simple structure to describe a compound sbit element. */ /* */ /* */ /* glyph_code :: The element's glyph index. */ /* */ /* x_offset :: The element's left bearing. */ /* */ /* y_offset :: The element's top bearing. */ /* */ typedef struct TT_SBit_ComponentRec_ { FT_UShort glyph_code; FT_Char x_offset; FT_Char y_offset; } TT_SBit_ComponentRec, *TT_SBit_Component; /*************************************************************************/ /* */ /* */ /* TT_SBit_ScaleRec */ /* */ /* */ /* A structure used describe a given bitmap scaling table, as defined */ /* in the `EBSC' table. */ /* */ /* */ /* hori :: The horizontal line metrics. */ /* */ /* vert :: The vertical line metrics. */ /* */ /* x_ppem :: The number of horizontal pixels per EM. */ /* */ /* y_ppem :: The number of vertical pixels per EM. */ /* */ /* x_ppem_substitute :: Substitution x_ppem value. */ /* */ /* y_ppem_substitute :: Substitution y_ppem value. */ /* */ typedef struct TT_SBit_ScaleRec_ { TT_SBit_LineMetricsRec hori; TT_SBit_LineMetricsRec vert; FT_Byte x_ppem; FT_Byte y_ppem; FT_Byte x_ppem_substitute; FT_Byte y_ppem_substitute; } TT_SBit_ScaleRec, *TT_SBit_Scale; /*************************************************************************/ /*************************************************************************/ /*************************************************************************/ /*** ***/ /*** ***/ /*** POSTSCRIPT GLYPH NAMES SUPPORT ***/ /*** ***/ /*** ***/ /*************************************************************************/ /*************************************************************************/ /*************************************************************************/ /*************************************************************************/ /* */ /* */ /* TT_Post_20Rec */ /* */ /* */ /* Postscript names sub-table, format 2.0. Stores the PS name of */ /* each glyph in the font face. */ /* */ /* */ /* num_glyphs :: The number of named glyphs in the table. */ /* */ /* num_names :: The number of PS names stored in the table. */ /* */ /* glyph_indices :: The indices of the glyphs in the names arrays. */ /* */ /* glyph_names :: The PS names not in Mac Encoding. */ /* */ typedef struct TT_Post_20Rec_ { FT_UShort num_glyphs; FT_UShort num_names; FT_UShort* glyph_indices; FT_Char** glyph_names; } TT_Post_20Rec, *TT_Post_20; /*************************************************************************/ /* */ /* */ /* TT_Post_25Rec */ /* */ /* */ /* Postscript names sub-table, format 2.5. Stores the PS name of */ /* each glyph in the font face. */ /* */ /* */ /* num_glyphs :: The number of glyphs in the table. */ /* */ /* offsets :: An array of signed offsets in a normal Mac */ /* Postscript name encoding. */ /* */ typedef struct TT_Post_25_ { FT_UShort num_glyphs; FT_Char* offsets; } TT_Post_25Rec, *TT_Post_25; /*************************************************************************/ /* */ /* */ /* TT_Post_NamesRec */ /* */ /* */ /* Postscript names table, either format 2.0 or 2.5. */ /* */ /* */ /* loaded :: A flag to indicate whether the PS names are loaded. */ /* */ /* format_20 :: The sub-table used for format 2.0. */ /* */ /* format_25 :: The sub-table used for format 2.5. */ /* */ typedef struct TT_Post_NamesRec_ { FT_Bool loaded; union { TT_Post_20Rec format_20; TT_Post_25Rec format_25; } names; } TT_Post_NamesRec, *TT_Post_Names; /*************************************************************************/ /*************************************************************************/ /*************************************************************************/ /*** ***/ /*** ***/ /*** TRUETYPE CHARMAPS SUPPORT ***/ /*** ***/ /*** ***/ /*************************************************************************/ /*************************************************************************/ /*************************************************************************/ /* format 0 */ typedef struct TT_CMap0_ { FT_ULong language; /* for Mac fonts (originally ushort) */ FT_Byte* glyphIdArray; } TT_CMap0Rec, *TT_CMap0; /* format 2 */ typedef struct TT_CMap2SubHeaderRec_ { FT_UShort firstCode; /* first valid low byte */ FT_UShort entryCount; /* number of valid low bytes */ FT_Short idDelta; /* delta value to glyphIndex */ FT_UShort idRangeOffset; /* offset from here to 1st code */ } TT_CMap2SubHeaderRec, *TT_CMap2SubHeader; typedef struct TT_CMap2Rec_ { FT_ULong language; /* for Mac fonts (originally ushort) */ FT_UShort* subHeaderKeys; /* high byte mapping table */ /* value = subHeader index * 8 */ TT_CMap2SubHeader subHeaders; FT_UShort* glyphIdArray; FT_UShort numGlyphId; /* control value */ } TT_CMap2Rec, *TT_CMap2; /* format 4 */ typedef struct TT_CMap4Segment_ { FT_UShort endCount; FT_UShort startCount; FT_Short idDelta; FT_UShort idRangeOffset; } TT_CMap4SegmentRec, *TT_CMap4Segment; typedef struct TT_CMap4Rec_ { FT_ULong language; /* for Mac fonts (originally ushort) */ FT_UShort segCountX2; /* number of segments * 2 */ FT_UShort searchRange; /* these parameters can be used */ FT_UShort entrySelector; /* for a binary search */ FT_UShort rangeShift; TT_CMap4Segment segments; FT_UShort* glyphIdArray; FT_UShort numGlyphId; /* control value */ TT_CMap4Segment last_segment; /* last used segment; this is a small */ /* cache to potentially increase speed */ } TT_CMap4Rec, *TT_CMap4; /* format 6 */ typedef struct TT_CMap6_ { FT_ULong language; /* for Mac fonts (originally ushort) */ FT_UShort firstCode; /* first character code of subrange */ FT_UShort entryCount; /* number of character codes in subrange */ FT_UShort* glyphIdArray; } TT_CMap6Rec, *TT_CMap6; /* auxiliary table for format 8 and 12 */ typedef struct TT_CMapGroupRec_ { FT_ULong startCharCode; FT_ULong endCharCode; FT_ULong startGlyphID; } TT_CMapGroupRec, *TT_CMapGroup; /* FreeType handles format 8 and 12 identically. It is not necessary to cover mixed 16bit and 32bit codes since FreeType always uses FT_ULong for input character codes -- converting Unicode surrogates to 32bit character codes must be done by the application. */ typedef struct TT_CMap8_12Rec_ { FT_ULong language; /* for Mac fonts */ FT_ULong nGroups; TT_CMapGroup groups; TT_CMapGroup last_group; /* last used group; this is a small */ /* cache to potentially increase speed */ } TT_CMap8_12Rec, *TT_CMap8_12; /* format 10 */ typedef struct TT_CMap10Rec_ { FT_ULong language; /* for Mac fonts */ FT_ULong startCharCode; /* first character covered */ FT_ULong numChars; /* number of characters covered */ FT_UShort* glyphs; } TT_CMap10Rec, *TT_CMap10; typedef struct TT_CMapTableRec_* TT_CMapTable; typedef FT_UInt (*TT_CharMap_Func)( TT_CMapTable charmap, FT_ULong char_code ); typedef FT_ULong (*TT_CharNext_Func)( TT_CMapTable charmap, FT_ULong char_code ); /* charmap table */ typedef struct TT_CMapTableRec_ { FT_UShort platformID; FT_UShort platformEncodingID; FT_UShort format; FT_ULong length; /* must be ulong for formats 8, 10, and 12 */ FT_Bool loaded; FT_ULong offset; union { TT_CMap0Rec cmap0; TT_CMap2Rec cmap2; TT_CMap4Rec cmap4; TT_CMap6Rec cmap6; TT_CMap8_12Rec cmap8_12; TT_CMap10Rec cmap10; } c; TT_CharMap_Func get_index; TT_CharNext_Func get_next_char; } TT_CMapTableRec; /*************************************************************************/ /* */ /* */ /* TT_CharMapRec */ /* */ /* */ /* The TrueType character map object type. */ /* */ /* */ /* root :: The parent character map structure. */ /* */ /* cmap :: The used character map. */ /* */ typedef struct TT_CharMapRec_ { FT_CharMapRec root; TT_CMapTableRec cmap; } TT_CharMapRec; /*************************************************************************/ /*************************************************************************/ /*************************************************************************/ /*** ***/ /*** ***/ /*** ORIGINAL TT_FACE CLASS DEFINITION ***/ /*** ***/ /*** ***/ /*************************************************************************/ /*************************************************************************/ /*************************************************************************/ /*************************************************************************/ /* */ /* This structure/class is defined here because it is common to the */ /* following formats: TTF, OpenType-TT, and OpenType-CFF. */ /* */ /* Note, however, that the classes TT_Size, TT_GlyphSlot, and TT_CharMap */ /* are not shared between font drivers, and are thus defined in */ /* `ttobjs.h'. */ /* */ /*************************************************************************/ /*************************************************************************/ /* */ /* */ /* TT_Face */ /* */ /* */ /* A handle to a TrueType face/font object. A TT_Face encapsulates */ /* the resolution and scaling independent parts of a TrueType font */ /* resource. */ /* */ /* */ /* The TT_Face structure is also used as a `parent class' for the */ /* OpenType-CFF class (T2_Face). */ /* */ typedef struct TT_FaceRec_* TT_Face; /*************************************************************************/ /* */ /* */ /* TT_CharMap */ /* */ /* */ /* A handle to a TrueType character mapping object. */ /* */ typedef struct TT_CharMapRec_* TT_CharMap; /* a function type used for the truetype bytecode interpreter hooks */ typedef FT_Error (*TT_Interpreter)( void* exec_context ); /* forward declaration */ typedef struct TT_LoaderRec_* TT_Loader; /*************************************************************************/ /* */ /* */ /* TT_Loader_GotoTableFunc */ /* */ /* */ /* Seeks a stream to the start of a given TrueType table. */ /* */ /* */ /* face :: A handle to the target face object. */ /* */ /* tag :: A 4-byte tag used to name the table. */ /* */ /* stream :: The input stream. */ /* */ /*