Home | History | Annotate | Download | only in include
      1 /***************************************************************************/
      2 /*                                                                         */
      3 /*  ftfntfmt.h                                                             */
      4 /*                                                                         */
      5 /*    Support functions for font formats.                                  */
      6 /*                                                                         */
      7 /*  Copyright 2002-2015 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