/***************************************************************************//*                                                                         *//*  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_HFT_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 */