1 /***************************************************************************/
   2 /*                                                                         */
   3 /*  ftfntfmt.h                                                             */
   4 /*                                                                         */
   5 /*    Support functions for font formats.                                  */
   6 /*                                                                         */
   7 /*  Copyright 2002-2018 by                                                 */
   8 /*  David Turner, Robert Wilhelm, and Werner Lemberg.                      */
   9 /*                                                                         */
  10 /*  This file is part of the FreeType project, and may only be used,       */
  11 /*  modified, and distributed under the terms of the FreeType project      */
  12 /*  license, LICENSE.TXT.  By continuing to use, modify, or distribute     */
  13 /*  this file you indicate that you have read the license and              */
  14 /*  understand and accept it fully.                                        */
  15 /*                                                                         */
  16 /***************************************************************************/
  17 
  18 
  19 #ifndef FTFNTFMT_H_
  20 #define FTFNTFMT_H_
  21 
  22 #include <ft2build.h>
  23 #include FT_FREETYPE_H
  24 
  25 #ifdef FREETYPE_H
  26 #error "freetype.h of FreeType 1 has been loaded!"
  27 #error "Please fix the directory search order for header files"
  28 #error "so that freetype.h of FreeType 2 is found first."
  29 #endif
  30 
  31 
  32 FT_BEGIN_HEADER
  33 
  34 
  35   /*************************************************************************/
  36   /*                                                                       */
  37   /* <Section>                                                             */
  38   /*   font_formats                                                        */
  39   /*                                                                       */
  40   /* <Title>                                                               */
  41   /*   Font Formats                                                        */
  42   /*                                                                       */
  43   /* <Abstract>                                                            */
  44   /*   Getting the font format.                                            */
  45   /*                                                                       */
  46   /* <Description>                                                         */
  47   /*   The single function in this section can be used to get the font     */
  48   /*   format.  Note that this information is not needed normally;         */
  49   /*   however, there are special cases (like in PDF devices) where it is  */
  50   /*   important to differentiate, in spite of FreeType's uniform API.     */
  51   /*                                                                       */
  52   /*************************************************************************/
  53 
  54 
  55   /*************************************************************************/
  56   /*                                                                       */
  57   /* <Function>                                                            */
  58   /*   FT_Get_Font_Format                                                  */
  59   /*                                                                       */
  60   /* <Description>                                                         */
  61   /*   Return a string describing the format of a given face.  Possible    */
  62   /*   values are `TrueType', `Type~1', `BDF', `PCF', `Type~42',           */
  63   /*   `CID~Type~1', `CFF', `PFR', and `Windows~FNT'.                      */
  64   /*                                                                       */
  65   /*   The return value is suitable to be used as an X11 FONT_PROPERTY.    */
  66   /*                                                                       */
  67   /* <Input>                                                               */
  68   /*   face ::                                                             */
  69   /*     Input face handle.                                                */
  70   /*                                                                       */
  71   /* <Return>                                                              */
  72   /*   Font format string.  NULL in case of error.                         */
  73   /*                                                                       */
  74   /* <Note>                                                                */
  75   /*   A deprecated name for the same function is                          */
  76   /*   `FT_Get_X11_Font_Format'.                                           */
  77   /*                                                                       */
  78   FT_EXPORT( const char* )
  79   FT_Get_Font_Format( FT_Face  face );
  80 
  81 
  82   /* deprecated */
  83   FT_EXPORT( const char* )
  84   FT_Get_X11_Font_Format( FT_Face  face );
  85 
  86 
  87   /* */
  88 
  89 
  90 FT_END_HEADER
  91 
  92 #endif /* FTFNTFMT_H_ */
  93 
  94 
  95 /* END */