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