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 32FT_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 90FT_END_HEADER 91 92#endif /* __FTFNTFMT_H__ */ 93