/***************************************************************************/ /* */ /* psnames.h */ /* */ /* High-level interface for the `PSNames' module (in charge of */ /* various functions related to Postscript glyph names conversion). */ /* */ /* 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 __PSNAMES_H__ #define __PSNAMES_H__ #include <ft2build.h> #include FT_FREETYPE_H FT_BEGIN_HEADER /*************************************************************************/ /* */ /* <FuncType> */ /* PS_Unicode_Value_Func */ /* */ /* <Description> */ /* A function used to return the Unicode index corresponding to a */ /* given glyph name. */ /* */ /* <Input> */ /* glyph_name :: The glyph name. */ /* */ /* <Return> */ /* The Unicode character index resp. the non-Unicode value 0xFFFF if */ /* the glyph name has no known Unicode meaning. */ /* */ /* <Note> */ /* This function is able to map several different glyph names to the */ /* same Unicode value, according to the rules defined in the Adobe */ /* Glyph List table. */ /* */ /* This function will not be compiled if the configuration macro */ /* FT_CONFIG_OPTION_ADOBE_GLYPH_LIST is undefined. */ /* */ typedef FT_UInt32 (*PS_Unicode_Value_Func)( const char* glyph_name ); /*************************************************************************/ /* */ /* <FuncType> */ /* PS_Unicode_Index_Func */ /* */ /* <Description> */ /* A function used to return the glyph index corresponding to a given */ /* Unicode value. */ /* */ /* <Input> */ /* num_glyphs :: The number of glyphs in the face. */ /* */ /* glyph_names :: An array of glyph name pointers. */ /* */ /* unicode :: The Unicode value. */ /* */ /* <Return> */ /* The glyph index resp. 0xFFFF if no glyph corresponds to this */ /* Unicode value. */ /* */ /* <Note> */ /* This function is able to recognize several glyph names per Unicode */ /* value, according to the Adobe Glyph List. */ /* */ /* This function will not be compiled if the configuration macro */ /* FT_CONFIG_OPTION_ADOBE_GLYPH_LIST is undefined. */ /* */ typedef FT_UInt (*PS_Unicode_Index_Func)( FT_UInt num_glyphs, const char** glyph_names, FT_ULong unicode ); /*************************************************************************/ /* */ /* <FuncType> */ /* PS_Macintosh_Name_Func */ /* */ /* <Description> */ /* A function used to return the glyph name corresponding to an Apple */ /* glyph name index. */ /* */ /* <Input> */ /* name_index :: The index of the Mac name. */ /* */ /* <Return> */ /* The glyph name, or 0 if the index is invalid. */ /* */ /* <Note> */ /* This function will not be compiled if the configuration macro */ /* FT_CONFIG_OPTION_POSTSCRIPT_NAMES is undefined. */ /* */ typedef const char* (*PS_Macintosh_Name_Func)( FT_UInt name_index ); typedef const char* (*PS_Adobe_Std_Strings_Func)( FT_UInt string_index ); typedef struct PS_UniMap_ { FT_UInt unicode; FT_UInt glyph_index; } PS_UniMap; /*************************************************************************/ /* */ /* <Struct> */ /* PS_Unicodes */ /* */ /* <Description> */ /* A simple table used to map Unicode values to glyph indices. It is */ /* built by the PS_Build_Unicodes table according to the glyphs */ /* present in a font file. */ /* */ /* <Fields> */ /* num_codes :: The number of glyphs in the font that match a given */ /* Unicode value. */ /* */ /* unicodes :: An array of unicode values, sorted in increasing */ /* order. */ /* */ /* gindex :: An array of glyph indices, corresponding to each */ /* Unicode value. */ /* */ /* <Note> */ /* Use the function PS_Lookup_Unicode() to retrieve the glyph index */ /* corresponding to a given Unicode character code. */ /* */ typedef struct PS_Unicodes_ { FT_UInt num_maps; PS_UniMap* maps; } PS_Unicodes; typedef FT_Error (*PS_Build_Unicodes_Func)( FT_Memory memory, FT_UInt num_glyphs, const char** glyph_names, PS_Unicodes* unicodes ); typedef FT_UInt (*PS_Lookup_Unicode_Func)( PS_Unicodes* unicodes, FT_UInt unicode ); typedef FT_ULong (*PS_Next_Unicode_Func)( PS_Unicodes* unicodes, FT_ULong unicode ); /*************************************************************************/ /* */ /* <Struct> */ /* PSNames_Interface */ /* */ /* <Description> */ /* This structure defines the PSNames interface. */ /* */ /* <Fields> */ /* unicode_value :: A function used to convert a glyph name */ /* into a Unicode character code. */ /* */ /* build_unicodes :: A function which builds up the Unicode */ /* mapping table. */ /* */ /* lookup_unicode :: A function used to return the glyph index */ /* corresponding to a given Unicode */ /* character. */ /* */ /* macintosh_name :: A function used to return the standard */ /* Apple glyph Postscript name corresponding */ /* to a given string index (used by the */ /* TrueType `post' table). */ /* */ /* adobe_std_strings :: A function that returns a pointer to a */ /* Adobe Standard String for a given SID. */ /* */ /* adobe_std_encoding :: A table of 256 unsigned shorts that maps */ /* character codes in the Adobe Standard */ /* Encoding to SIDs. */ /* */ /* adobe_expert_encoding :: A table of 256 unsigned shorts that maps */ /* character codes in the Adobe Expert */ /* Encoding to SIDs. */ /* */ /* <Note> */ /* `unicode_value' and `unicode_index' will be set to 0 if the */ /* configuration macro FT_CONFIG_OPTION_ADOBE_GLYPH_LIST is */ /* undefined. */ /* */ /* `macintosh_name' will be set to 0 if the configuration macro */ /* FT_CONFIG_OPTION_POSTSCRIPT_NAMES is undefined. */ /* */ typedef struct PSNames_Interface_ { PS_Unicode_Value_Func unicode_value; PS_Build_Unicodes_Func build_unicodes; PS_Lookup_Unicode_Func lookup_unicode; PS_Macintosh_Name_Func macintosh_name; PS_Adobe_Std_Strings_Func adobe_std_strings; const unsigned short* adobe_std_encoding; const unsigned short* adobe_expert_encoding; PS_Next_Unicode_Func next_unicode; } PSNames_Interface; typedef PSNames_Interface* PSNames_Service; FT_END_HEADER #endif /* __PSNAMES_H__ */ /* END */