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