Index: third_party/freetype/include/tttables.h |
diff --git a/third_party/freetype/include/tttables.h b/third_party/freetype/include/tttables.h |
deleted file mode 100644 |
index e1d8b05e79c3a47025de0dc50656847e79a20e96..0000000000000000000000000000000000000000 |
--- a/third_party/freetype/include/tttables.h |
+++ /dev/null |
@@ -1,829 +0,0 @@ |
-/***************************************************************************/ |
-/* */ |
-/* tttables.h */ |
-/* */ |
-/* Basic SFNT/TrueType tables definitions and interface */ |
-/* (specification only). */ |
-/* */ |
-/* Copyright 1996-2005, 2008-2014 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 __TTTABLES_H__ |
-#define __TTTABLES_H__ |
- |
- |
-#include <ft2build.h> |
-#include FT_FREETYPE_H |
- |
-#ifdef FREETYPE_H |
-#error "freetype.h of FreeType 1 has been loaded!" |
-#error "Please fix the directory search order for header files" |
-#error "so that freetype.h of FreeType 2 is found first." |
-#endif |
- |
- |
-FT_BEGIN_HEADER |
- |
- /*************************************************************************/ |
- /* */ |
- /* <Section> */ |
- /* truetype_tables */ |
- /* */ |
- /* <Title> */ |
- /* TrueType Tables */ |
- /* */ |
- /* <Abstract> */ |
- /* TrueType specific table types and functions. */ |
- /* */ |
- /* <Description> */ |
- /* This section contains the definition of TrueType-specific tables */ |
- /* as well as some routines used to access and process them. */ |
- /* */ |
- /* <Order> */ |
- /* TT_Header */ |
- /* TT_HoriHeader */ |
- /* TT_VertHeader */ |
- /* TT_OS2 */ |
- /* TT_Postscript */ |
- /* TT_PCLT */ |
- /* TT_MaxProfile */ |
- /* */ |
- /* FT_Sfnt_Tag */ |
- /* FT_Get_Sfnt_Table */ |
- /* FT_Load_Sfnt_Table */ |
- /* FT_Sfnt_Table_Info */ |
- /* */ |
- /* FT_Get_CMap_Language_ID */ |
- /* FT_Get_CMap_Format */ |
- /* */ |
- /* FT_PARAM_TAG_UNPATENTED_HINTING */ |
- /* */ |
- /*************************************************************************/ |
- |
- |
- /*************************************************************************/ |
- /* */ |
- /* <Struct> */ |
- /* TT_Header */ |
- /* */ |
- /* <Description> */ |
- /* A structure used to model a TrueType font header table. All */ |
- /* fields follow the TrueType specification. */ |
- /* */ |
- typedef struct TT_Header_ |
- { |
- FT_Fixed Table_Version; |
- FT_Fixed Font_Revision; |
- |
- FT_Long CheckSum_Adjust; |
- FT_Long Magic_Number; |
- |
- FT_UShort Flags; |
- FT_UShort Units_Per_EM; |
- |
- FT_Long Created [2]; |
- FT_Long Modified[2]; |
- |
- FT_Short xMin; |
- FT_Short yMin; |
- FT_Short xMax; |
- FT_Short yMax; |
- |
- FT_UShort Mac_Style; |
- FT_UShort Lowest_Rec_PPEM; |
- |
- FT_Short Font_Direction; |
- FT_Short Index_To_Loc_Format; |
- FT_Short Glyph_Data_Format; |
- |
- } TT_Header; |
- |
- |
- /*************************************************************************/ |
- /* */ |
- /* <Struct> */ |
- /* TT_HoriHeader */ |
- /* */ |
- /* <Description> */ |
- /* A structure used to model a TrueType horizontal header, the `hhea' */ |
- /* table, as well as the corresponding horizontal metrics table, */ |
- /* i.e., the `hmtx' table. */ |
- /* */ |
- /* <Fields> */ |
- /* Version :: The table version. */ |
- /* */ |
- /* Ascender :: The font's ascender, i.e., the distance */ |
- /* from the baseline to the top-most of all */ |
- /* glyph points found in the font. */ |
- /* */ |
- /* This value is invalid in many fonts, as */ |
- /* it is usually set by the font designer, */ |
- /* and often reflects only a portion of the */ |
- /* glyphs found in the font (maybe ASCII). */ |
- /* */ |
- /* You should use the `sTypoAscender' field */ |
- /* of the OS/2 table instead if you want */ |
- /* the correct one. */ |
- /* */ |
- /* Descender :: The font's descender, i.e., the distance */ |
- /* from the baseline to the bottom-most of */ |
- /* all glyph points found in the font. It */ |
- /* is negative. */ |
- /* */ |
- /* This value is invalid in many fonts, as */ |
- /* it is usually set by the font designer, */ |
- /* and often reflects only a portion of the */ |
- /* glyphs found in the font (maybe ASCII). */ |
- /* */ |
- /* You should use the `sTypoDescender' */ |
- /* field of the OS/2 table instead if you */ |
- /* want the correct one. */ |
- /* */ |
- /* Line_Gap :: The font's line gap, i.e., the distance */ |
- /* to add to the ascender and descender to */ |
- /* get the BTB, i.e., the */ |
- /* baseline-to-baseline distance for the */ |
- /* font. */ |
- /* */ |
- /* advance_Width_Max :: This field is the maximum of all advance */ |
- /* widths found in the font. It can be */ |
- /* used to compute the maximum width of an */ |
- /* arbitrary string of text. */ |
- /* */ |
- /* min_Left_Side_Bearing :: The minimum left side bearing of all */ |
- /* glyphs within the font. */ |
- /* */ |
- /* min_Right_Side_Bearing :: The minimum right side bearing of all */ |
- /* glyphs within the font. */ |
- /* */ |
- /* xMax_Extent :: The maximum horizontal extent (i.e., the */ |
- /* `width' of a glyph's bounding box) for */ |
- /* all glyphs in the font. */ |
- /* */ |
- /* caret_Slope_Rise :: The rise coefficient of the cursor's */ |
- /* slope of the cursor (slope=rise/run). */ |
- /* */ |
- /* caret_Slope_Run :: The run coefficient of the cursor's */ |
- /* slope. */ |
- /* */ |
- /* Reserved :: 8~reserved bytes. */ |
- /* */ |
- /* metric_Data_Format :: Always~0. */ |
- /* */ |
- /* number_Of_HMetrics :: Number of HMetrics entries in the `hmtx' */ |
- /* table -- this value can be smaller than */ |
- /* the total number of glyphs in the font. */ |
- /* */ |
- /* long_metrics :: A pointer into the `hmtx' table. */ |
- /* */ |
- /* short_metrics :: A pointer into the `hmtx' table. */ |
- /* */ |
- /* <Note> */ |
- /* IMPORTANT: The TT_HoriHeader and TT_VertHeader structures should */ |
- /* be identical except for the names of their fields, */ |
- /* which are different. */ |
- /* */ |
- /* This ensures that a single function in the `ttload' */ |
- /* module is able to read both the horizontal and vertical */ |
- /* headers. */ |
- /* */ |
- typedef struct TT_HoriHeader_ |
- { |
- FT_Fixed Version; |
- FT_Short Ascender; |
- FT_Short Descender; |
- FT_Short Line_Gap; |
- |
- FT_UShort advance_Width_Max; /* advance width maximum */ |
- |
- FT_Short min_Left_Side_Bearing; /* minimum left-sb */ |
- FT_Short min_Right_Side_Bearing; /* minimum right-sb */ |
- FT_Short xMax_Extent; /* xmax extents */ |
- FT_Short caret_Slope_Rise; |
- FT_Short caret_Slope_Run; |
- FT_Short caret_Offset; |
- |
- FT_Short Reserved[4]; |
- |
- FT_Short metric_Data_Format; |
- FT_UShort number_Of_HMetrics; |
- |
- /* The following fields are not defined by the TrueType specification */ |
- /* but they are used to connect the metrics header to the relevant */ |
- /* `HMTX' table. */ |
- |
- void* long_metrics; |
- void* short_metrics; |
- |
- } TT_HoriHeader; |
- |
- |
- /*************************************************************************/ |
- /* */ |
- /* <Struct> */ |
- /* TT_VertHeader */ |
- /* */ |
- /* <Description> */ |
- /* A structure used to model a TrueType vertical header, the `vhea' */ |
- /* table, as well as the corresponding vertical metrics table, i.e., */ |
- /* the `vmtx' table. */ |
- /* */ |
- /* <Fields> */ |
- /* Version :: The table version. */ |
- /* */ |
- /* Ascender :: The font's ascender, i.e., the distance */ |
- /* from the baseline to the top-most of */ |
- /* all glyph points found in the font. */ |
- /* */ |
- /* This value is invalid in many fonts, as */ |
- /* it is usually set by the font designer, */ |
- /* and often reflects only a portion of */ |
- /* the glyphs found in the font (maybe */ |
- /* ASCII). */ |
- /* */ |
- /* You should use the `sTypoAscender' */ |
- /* field of the OS/2 table instead if you */ |
- /* want the correct one. */ |
- /* */ |
- /* Descender :: The font's descender, i.e., the */ |
- /* distance from the baseline to the */ |
- /* bottom-most of all glyph points found */ |
- /* in the font. It is negative. */ |
- /* */ |
- /* This value is invalid in many fonts, as */ |
- /* it is usually set by the font designer, */ |
- /* and often reflects only a portion of */ |
- /* the glyphs found in the font (maybe */ |
- /* ASCII). */ |
- /* */ |
- /* You should use the `sTypoDescender' */ |
- /* field of the OS/2 table instead if you */ |
- /* want the correct one. */ |
- /* */ |
- /* Line_Gap :: The font's line gap, i.e., the distance */ |
- /* to add to the ascender and descender to */ |
- /* get the BTB, i.e., the */ |
- /* baseline-to-baseline distance for the */ |
- /* font. */ |
- /* */ |
- /* advance_Height_Max :: This field is the maximum of all */ |
- /* advance heights found in the font. It */ |
- /* can be used to compute the maximum */ |
- /* height of an arbitrary string of text. */ |
- /* */ |
- /* min_Top_Side_Bearing :: The minimum top side bearing of all */ |
- /* glyphs within the font. */ |
- /* */ |
- /* min_Bottom_Side_Bearing :: The minimum bottom side bearing of all */ |
- /* glyphs within the font. */ |
- /* */ |
- /* yMax_Extent :: The maximum vertical extent (i.e., the */ |
- /* `height' of a glyph's bounding box) for */ |
- /* all glyphs in the font. */ |
- /* */ |
- /* caret_Slope_Rise :: The rise coefficient of the cursor's */ |
- /* slope of the cursor (slope=rise/run). */ |
- /* */ |
- /* caret_Slope_Run :: The run coefficient of the cursor's */ |
- /* slope. */ |
- /* */ |
- /* caret_Offset :: The cursor's offset for slanted fonts. */ |
- /* This value is `reserved' in vmtx */ |
- /* version 1.0. */ |
- /* */ |
- /* Reserved :: 8~reserved bytes. */ |
- /* */ |
- /* metric_Data_Format :: Always~0. */ |
- /* */ |
- /* number_Of_HMetrics :: Number of VMetrics entries in the */ |
- /* `vmtx' table -- this value can be */ |
- /* smaller than the total number of glyphs */ |
- /* in the font. */ |
- /* */ |
- /* long_metrics :: A pointer into the `vmtx' table. */ |
- /* */ |
- /* short_metrics :: A pointer into the `vmtx' table. */ |
- /* */ |
- /* <Note> */ |
- /* IMPORTANT: The TT_HoriHeader and TT_VertHeader structures should */ |
- /* be identical except for the names of their fields, */ |
- /* which are different. */ |
- /* */ |
- /* This ensures that a single function in the `ttload' */ |
- /* module is able to read both the horizontal and vertical */ |
- /* headers. */ |
- /* */ |
- typedef struct TT_VertHeader_ |
- { |
- FT_Fixed Version; |
- FT_Short Ascender; |
- FT_Short Descender; |
- FT_Short Line_Gap; |
- |
- FT_UShort advance_Height_Max; /* advance height maximum */ |
- |
- FT_Short min_Top_Side_Bearing; /* minimum left-sb or top-sb */ |
- FT_Short min_Bottom_Side_Bearing; /* minimum right-sb or bottom-sb */ |
- FT_Short yMax_Extent; /* xmax or ymax extents */ |
- FT_Short caret_Slope_Rise; |
- FT_Short caret_Slope_Run; |
- FT_Short caret_Offset; |
- |
- FT_Short Reserved[4]; |
- |
- FT_Short metric_Data_Format; |
- FT_UShort number_Of_VMetrics; |
- |
- /* The following fields are not defined by the TrueType specification */ |
- /* but they're used to connect the metrics header to the relevant */ |
- /* `HMTX' or `VMTX' table. */ |
- |
- void* long_metrics; |
- void* short_metrics; |
- |
- } TT_VertHeader; |
- |
- |
- /*************************************************************************/ |
- /* */ |
- /* <Struct> */ |
- /* TT_OS2 */ |
- /* */ |
- /* <Description> */ |
- /* A structure used to model a TrueType OS/2 table. All fields */ |
- /* comply to the OpenType specification. */ |
- /* */ |
- /* Note that we now support old Mac fonts that do not include an OS/2 */ |
- /* table. In this case, the `version' field is always set to 0xFFFF. */ |
- /* */ |
- typedef struct TT_OS2_ |
- { |
- FT_UShort version; /* 0x0001 - more or 0xFFFF */ |
- FT_Short xAvgCharWidth; |
- FT_UShort usWeightClass; |
- FT_UShort usWidthClass; |
- FT_Short fsType; |
- FT_Short ySubscriptXSize; |
- FT_Short ySubscriptYSize; |
- FT_Short ySubscriptXOffset; |
- FT_Short ySubscriptYOffset; |
- FT_Short ySuperscriptXSize; |
- FT_Short ySuperscriptYSize; |
- FT_Short ySuperscriptXOffset; |
- FT_Short ySuperscriptYOffset; |
- FT_Short yStrikeoutSize; |
- FT_Short yStrikeoutPosition; |
- FT_Short sFamilyClass; |
- |
- FT_Byte panose[10]; |
- |
- FT_ULong ulUnicodeRange1; /* Bits 0-31 */ |
- FT_ULong ulUnicodeRange2; /* Bits 32-63 */ |
- FT_ULong ulUnicodeRange3; /* Bits 64-95 */ |
- FT_ULong ulUnicodeRange4; /* Bits 96-127 */ |
- |
- FT_Char achVendID[4]; |
- |
- FT_UShort fsSelection; |
- FT_UShort usFirstCharIndex; |
- FT_UShort usLastCharIndex; |
- FT_Short sTypoAscender; |
- FT_Short sTypoDescender; |
- FT_Short sTypoLineGap; |
- FT_UShort usWinAscent; |
- FT_UShort usWinDescent; |
- |
- /* only version 1 and higher: */ |
- |
- FT_ULong ulCodePageRange1; /* Bits 0-31 */ |
- FT_ULong ulCodePageRange2; /* Bits 32-63 */ |
- |
- /* only version 2 and higher: */ |
- |
- FT_Short sxHeight; |
- FT_Short sCapHeight; |
- FT_UShort usDefaultChar; |
- FT_UShort usBreakChar; |
- FT_UShort usMaxContext; |
- |
- /* only version 5 and higher: */ |
- |
- FT_UShort usLowerOpticalPointSize; /* in twips (1/20th points) */ |
- FT_UShort usUpperOpticalPointSize; /* in twips (1/20th points) */ |
- |
- } TT_OS2; |
- |
- |
- /*************************************************************************/ |
- /* */ |
- /* <Struct> */ |
- /* TT_Postscript */ |
- /* */ |
- /* <Description> */ |
- /* A structure used to model a TrueType PostScript table. All fields */ |
- /* comply to the TrueType specification. This structure does not */ |
- /* reference the PostScript glyph names, which can be nevertheless */ |
- /* accessed with the `ttpost' module. */ |
- /* */ |
- typedef struct TT_Postscript_ |
- { |
- FT_Fixed FormatType; |
- FT_Fixed italicAngle; |
- FT_Short underlinePosition; |
- FT_Short underlineThickness; |
- FT_ULong isFixedPitch; |
- FT_ULong minMemType42; |
- FT_ULong maxMemType42; |
- FT_ULong minMemType1; |
- FT_ULong maxMemType1; |
- |
- /* Glyph names follow in the file, but we don't */ |
- /* load them by default. See the ttpost.c file. */ |
- |
- } TT_Postscript; |
- |
- |
- /*************************************************************************/ |
- /* */ |
- /* <Struct> */ |
- /* TT_PCLT */ |
- /* */ |
- /* <Description> */ |
- /* A structure used to model a TrueType PCLT table. All fields */ |
- /* comply to the TrueType specification. */ |
- /* */ |
- typedef struct TT_PCLT_ |
- { |
- FT_Fixed Version; |
- FT_ULong FontNumber; |
- FT_UShort Pitch; |
- FT_UShort xHeight; |
- FT_UShort Style; |
- FT_UShort TypeFamily; |
- FT_UShort CapHeight; |
- FT_UShort SymbolSet; |
- FT_Char TypeFace[16]; |
- FT_Char CharacterComplement[8]; |
- FT_Char FileName[6]; |
- FT_Char StrokeWeight; |
- FT_Char WidthType; |
- FT_Byte SerifStyle; |
- FT_Byte Reserved; |
- |
- } TT_PCLT; |
- |
- |
- /*************************************************************************/ |
- /* */ |
- /* <Struct> */ |
- /* TT_MaxProfile */ |
- /* */ |
- /* <Description> */ |
- /* The maximum profile is a table containing many max values, which */ |
- /* can be used to pre-allocate arrays. This ensures that no memory */ |
- /* allocation occurs during a glyph load. */ |
- /* */ |
- /* <Fields> */ |
- /* version :: The version number. */ |
- /* */ |
- /* numGlyphs :: The number of glyphs in this TrueType */ |
- /* font. */ |
- /* */ |
- /* maxPoints :: The maximum number of points in a */ |
- /* non-composite TrueType glyph. See also */ |
- /* the structure element */ |
- /* `maxCompositePoints'. */ |
- /* */ |
- /* maxContours :: The maximum number of contours in a */ |
- /* non-composite TrueType glyph. See also */ |
- /* the structure element */ |
- /* `maxCompositeContours'. */ |
- /* */ |
- /* maxCompositePoints :: The maximum number of points in a */ |
- /* composite TrueType glyph. See also the */ |
- /* structure element `maxPoints'. */ |
- /* */ |
- /* maxCompositeContours :: The maximum number of contours in a */ |
- /* composite TrueType glyph. See also the */ |
- /* structure element `maxContours'. */ |
- /* */ |
- /* maxZones :: The maximum number of zones used for */ |
- /* glyph hinting. */ |
- /* */ |
- /* maxTwilightPoints :: The maximum number of points in the */ |
- /* twilight zone used for glyph hinting. */ |
- /* */ |
- /* maxStorage :: The maximum number of elements in the */ |
- /* storage area used for glyph hinting. */ |
- /* */ |
- /* maxFunctionDefs :: The maximum number of function */ |
- /* definitions in the TrueType bytecode for */ |
- /* this font. */ |
- /* */ |
- /* maxInstructionDefs :: The maximum number of instruction */ |
- /* definitions in the TrueType bytecode for */ |
- /* this font. */ |
- /* */ |
- /* maxStackElements :: The maximum number of stack elements used */ |
- /* during bytecode interpretation. */ |
- /* */ |
- /* maxSizeOfInstructions :: The maximum number of TrueType opcodes */ |
- /* used for glyph hinting. */ |
- /* */ |
- /* maxComponentElements :: The maximum number of simple (i.e., non- */ |
- /* composite) glyphs in a composite glyph. */ |
- /* */ |
- /* maxComponentDepth :: The maximum nesting depth of composite */ |
- /* glyphs. */ |
- /* */ |
- /* <Note> */ |
- /* This structure is only used during font loading. */ |
- /* */ |
- typedef struct TT_MaxProfile_ |
- { |
- FT_Fixed version; |
- FT_UShort numGlyphs; |
- FT_UShort maxPoints; |
- FT_UShort maxContours; |
- FT_UShort maxCompositePoints; |
- FT_UShort maxCompositeContours; |
- FT_UShort maxZones; |
- FT_UShort maxTwilightPoints; |
- FT_UShort maxStorage; |
- FT_UShort maxFunctionDefs; |
- FT_UShort maxInstructionDefs; |
- FT_UShort maxStackElements; |
- FT_UShort maxSizeOfInstructions; |
- FT_UShort maxComponentElements; |
- FT_UShort maxComponentDepth; |
- |
- } TT_MaxProfile; |
- |
- |
- /*************************************************************************/ |
- /* */ |
- /* <Enum> */ |
- /* FT_Sfnt_Tag */ |
- /* */ |
- /* <Description> */ |
- /* An enumeration used to specify the index of an SFNT table. */ |
- /* Used in the @FT_Get_Sfnt_Table API function. */ |
- /* */ |
- /* <Values> */ |
- /* FT_SFNT_HEAD :: To access the font's @TT_Header structure. */ |
- /* */ |
- /* FT_SFNT_MAXP :: To access the font's @TT_MaxProfile structure. */ |
- /* */ |
- /* FT_SFNT_OS2 :: To access the font's @TT_OS2 structure. */ |
- /* */ |
- /* FT_SFNT_HHEA :: To access the font's @TT_HoriHeader structure. */ |
- /* */ |
- /* FT_SFNT_VHEA :: To access the font's @TT_VertHeader struture. */ |
- /* */ |
- /* FT_SFNT_POST :: To access the font's @TT_Postscript structure. */ |
- /* */ |
- /* FT_SFNT_PCLT :: To access the font's @TT_PCLT structure. */ |
- /* */ |
- typedef enum FT_Sfnt_Tag_ |
- { |
- FT_SFNT_HEAD, |
- FT_SFNT_MAXP, |
- FT_SFNT_OS2, |
- FT_SFNT_HHEA, |
- FT_SFNT_VHEA, |
- FT_SFNT_POST, |
- FT_SFNT_PCLT, |
- |
- FT_SFNT_MAX |
- |
- } FT_Sfnt_Tag; |
- |
- /* these constants are deprecated; use the corresponding `FT_Sfnt_Tag' */ |
- /* values instead */ |
-#define ft_sfnt_head FT_SFNT_HEAD |
-#define ft_sfnt_maxp FT_SFNT_MAXP |
-#define ft_sfnt_os2 FT_SFNT_OS2 |
-#define ft_sfnt_hhea FT_SFNT_HHEA |
-#define ft_sfnt_vhea FT_SFNT_VHEA |
-#define ft_sfnt_post FT_SFNT_POST |
-#define ft_sfnt_pclt FT_SFNT_PCLT |
- |
- |
- /*************************************************************************/ |
- /* */ |
- /* <Function> */ |
- /* FT_Get_Sfnt_Table */ |
- /* */ |
- /* <Description> */ |
- /* Return a pointer to a given SFNT table within a face. */ |
- /* */ |
- /* <Input> */ |
- /* face :: A handle to the source. */ |
- /* */ |
- /* tag :: The index of the SFNT table. */ |
- /* */ |
- /* <Return> */ |
- /* A type-less pointer to the table. This will be~0 in case of */ |
- /* error, or if the corresponding table was not found *OR* loaded */ |
- /* from the file. */ |
- /* */ |
- /* Use a typecast according to `tag' to access the structure */ |
- /* elements. */ |
- /* */ |
- /* <Note> */ |
- /* The table is owned by the face object and disappears with it. */ |
- /* */ |
- /* This function is only useful to access SFNT tables that are loaded */ |
- /* by the sfnt, truetype, and opentype drivers. See @FT_Sfnt_Tag for */ |
- /* a list. */ |
- /* */ |
- /* Here an example how to access the `vhea' table: */ |
- /* */ |
- /* { */ |
- /* TT_VertHeader* vert_header; */ |
- /* */ |
- /* */ |
- /* vert_header = */ |
- /* (TT_VertHeader*)FT_Get_Sfnt_Table( face, FT_SFNT_VHEA ); */ |
- /* } */ |
- /* */ |
- FT_EXPORT( void* ) |
- FT_Get_Sfnt_Table( FT_Face face, |
- FT_Sfnt_Tag tag ); |
- |
- |
- /************************************************************************** |
- * |
- * @function: |
- * FT_Load_Sfnt_Table |
- * |
- * @description: |
- * Load any font table into client memory. |
- * |
- * @input: |
- * face :: |
- * A handle to the source face. |
- * |
- * tag :: |
- * The four-byte tag of the table to load. Use the value~0 if you want |
- * to access the whole font file. Otherwise, you can use one of the |
- * definitions found in the @FT_TRUETYPE_TAGS_H file, or forge a new |
- * one with @FT_MAKE_TAG. |
- * |
- * offset :: |
- * The starting offset in the table (or file if tag == 0). |
- * |
- * @output: |
- * buffer :: |
- * The target buffer address. The client must ensure that the memory |
- * array is big enough to hold the data. |
- * |
- * @inout: |
- * length :: |
- * If the `length' parameter is NULL, then try to load the whole table. |
- * Return an error code if it fails. |
- * |
- * Else, if `*length' is~0, exit immediately while returning the |
- * table's (or file) full size in it. |
- * |
- * Else the number of bytes to read from the table or file, from the |
- * starting offset. |
- * |
- * @return: |
- * FreeType error code. 0~means success. |
- * |
- * @note: |
- * If you need to determine the table's length you should first call this |
- * function with `*length' set to~0, as in the following example: |
- * |
- * { |
- * FT_ULong length = 0; |
- * |
- * |
- * error = FT_Load_Sfnt_Table( face, tag, 0, NULL, &length ); |
- * if ( error ) { ... table does not exist ... } |
- * |
- * buffer = malloc( length ); |
- * if ( buffer == NULL ) { ... not enough memory ... } |
- * |
- * error = FT_Load_Sfnt_Table( face, tag, 0, buffer, &length ); |
- * if ( error ) { ... could not load table ... } |
- * } |
- * |
- * Note that structures like @TT_Header or @TT_OS2 can't be used with |
- * this function; they are limited to @FT_Get_Sfnt_Table. Reason is that |
- * those structures depend on the processor architecture, with varying |
- * size (e.g. 32bit vs. 64bit) or order (big endian vs. little endian). |
- * |
- */ |
- FT_EXPORT( FT_Error ) |
- FT_Load_Sfnt_Table( FT_Face face, |
- FT_ULong tag, |
- FT_Long offset, |
- FT_Byte* buffer, |
- FT_ULong* length ); |
- |
- |
- /************************************************************************** |
- * |
- * @function: |
- * FT_Sfnt_Table_Info |
- * |
- * @description: |
- * Return information on an SFNT table. |
- * |
- * @input: |
- * face :: |
- * A handle to the source face. |
- * |
- * table_index :: |
- * The index of an SFNT table. The function returns |
- * FT_Err_Table_Missing for an invalid value. |
- * |
- * @inout: |
- * tag :: |
- * The name tag of the SFNT table. If the value is NULL, `table_index' |
- * is ignored, and `length' returns the number of SFNT tables in the |
- * font. |
- * |
- * @output: |
- * length :: |
- * The length of the SFNT table (or the number of SFNT tables, depending |
- * on `tag'). |
- * |
- * @return: |
- * FreeType error code. 0~means success. |
- * |
- * @note: |
- * While parsing fonts, FreeType handles SFNT tables with length zero as |
- * missing. |
- * |
- */ |
- FT_EXPORT( FT_Error ) |
- FT_Sfnt_Table_Info( FT_Face face, |
- FT_UInt table_index, |
- FT_ULong *tag, |
- FT_ULong *length ); |
- |
- |
- /*************************************************************************/ |
- /* */ |
- /* <Function> */ |
- /* FT_Get_CMap_Language_ID */ |
- /* */ |
- /* <Description> */ |
- /* Return TrueType/sfnt specific cmap language ID. Definitions of */ |
- /* language ID values are in `ttnameid.h'. */ |
- /* */ |
- /* <Input> */ |
- /* charmap :: */ |
- /* The target charmap. */ |
- /* */ |
- /* <Return> */ |
- /* The language ID of `charmap'. If `charmap' doesn't belong to a */ |
- /* TrueType/sfnt face, just return~0 as the default value. */ |
- /* */ |
- /* For a format~14 cmap (to access Unicode IVS), the return value is */ |
- /* 0xFFFFFFFF. */ |
- /* */ |
- FT_EXPORT( FT_ULong ) |
- FT_Get_CMap_Language_ID( FT_CharMap charmap ); |
- |
- |
- /*************************************************************************/ |
- /* */ |
- /* <Function> */ |
- /* FT_Get_CMap_Format */ |
- /* */ |
- /* <Description> */ |
- /* Return TrueType/sfnt specific cmap format. */ |
- /* */ |
- /* <Input> */ |
- /* charmap :: */ |
- /* The target charmap. */ |
- /* */ |
- /* <Return> */ |
- /* The format of `charmap'. If `charmap' doesn't belong to a */ |
- /* TrueType/sfnt face, return -1. */ |
- /* */ |
- FT_EXPORT( FT_Long ) |
- FT_Get_CMap_Format( FT_CharMap charmap ); |
- |
- /* */ |
- |
- |
-FT_END_HEADER |
- |
-#endif /* __TTTABLES_H__ */ |
- |
- |
-/* END */ |