1 /***************************************************************************/ 2 /* */ 3 /* ftbdf.h */ 4 /* */ 5 /* FreeType API for accessing BDF-specific strings (specification). */ 6 /* */ 7 /* Copyright 2002, 2003, 2004, 2006, 2009 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 __FTBDF_H__ 20 #define __FTBDF_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 /* bdf_fonts */ 39 /* */ 40 /* <Title> */ 41 /* BDF and PCF Files */ 42 /* */ 43 /* <Abstract> */ 44 /* BDF and PCF specific API. */ 45 /* */ 46 /* <Description> */ 47 /* This section contains the declaration of functions specific to BDF */ 48 /* and PCF fonts. */ 49 /* */ 50 /*************************************************************************/ 51 52 53 /********************************************************************** 54 * 55 * @enum: 56 * FT_PropertyType 57 * 58 * @description: 59 * A list of BDF property types. 60 * 61 * @values: 62 * BDF_PROPERTY_TYPE_NONE :: 63 * Value~0 is used to indicate a missing property. 64 * 65 * BDF_PROPERTY_TYPE_ATOM :: 66 * Property is a string atom. 67 * 68 * BDF_PROPERTY_TYPE_INTEGER :: 69 * Property is a 32-bit signed integer. 70 * 71 * BDF_PROPERTY_TYPE_CARDINAL :: 72 * Property is a 32-bit unsigned integer. 73 */ 74 typedef enum BDF_PropertyType_ 75 { 76 BDF_PROPERTY_TYPE_NONE = 0, 77 BDF_PROPERTY_TYPE_ATOM = 1, 78 BDF_PROPERTY_TYPE_INTEGER = 2, 79 BDF_PROPERTY_TYPE_CARDINAL = 3 80 81 } BDF_PropertyType; 82 83 84 /********************************************************************** 85 * 86 * @type: 87 * BDF_Property 88 * 89 * @description: 90 * A handle to a @BDF_PropertyRec structure to model a given 91 * BDF/PCF property. 92 */ 93 typedef struct BDF_PropertyRec_* BDF_Property; 94 95 96 /********************************************************************** 97 * 98 * @struct: 99 * BDF_PropertyRec 100 * 101 * @description: 102 * This structure models a given BDF/PCF property. 103 * 104 * @fields: 105 * type :: 106 * The property type. 107 * 108 * u.atom :: 109 * The atom string, if type is @BDF_PROPERTY_TYPE_ATOM. 110 * 111 * u.integer :: 112 * A signed integer, if type is @BDF_PROPERTY_TYPE_INTEGER. 113 * 114 * u.cardinal :: 115 * An unsigned integer, if type is @BDF_PROPERTY_TYPE_CARDINAL. 116 */ 117 typedef struct BDF_PropertyRec_ 118 { 119 BDF_PropertyType type; 120 union { 121 const char* atom; 122 FT_Int32 integer; 123 FT_UInt32 cardinal; 124 125 } u; 126 127 } BDF_PropertyRec; 128 129 130 /********************************************************************** 131 * 132 * @function: 133 * FT_Get_BDF_Charset_ID 134 * 135 * @description: 136 * Retrieve a BDF font character set identity, according to 137 * the BDF specification. 138 * 139 * @input: 140 * face :: 141 * A handle to the input face. 142 * 143 * @output: 144 * acharset_encoding :: 145 * Charset encoding, as a C~string, owned by the face. 146 * 147 * acharset_registry :: 148 * Charset registry, as a C~string, owned by the face. 149 * 150 * @return: 151 * FreeType error code. 0~means success. 152 * 153 * @note: 154 * This function only works with BDF faces, returning an error otherwise. 155 */ 156 FT_EXPORT( FT_Error ) 157 FT_Get_BDF_Charset_ID( FT_Face face, 158 const char* *acharset_encoding, 159 const char* *acharset_registry ); 160 161 162 /********************************************************************** 163 * 164 * @function: 165 * FT_Get_BDF_Property 166 * 167 * @description: 168 * Retrieve a BDF property from a BDF or PCF font file. 169 * 170 * @input: 171 * face :: A handle to the input face. 172 * 173 * name :: The property name. 174 * 175 * @output: 176 * aproperty :: The property. 177 * 178 * @return: 179 * FreeType error code. 0~means success. 180 * 181 * @note: 182 * This function works with BDF _and_ PCF fonts. It returns an error 183 * otherwise. It also returns an error if the property is not in the 184 * font. 185 * 186 * A `property' is a either key-value pair within the STARTPROPERTIES 187 * ... ENDPROPERTIES block of a BDF font or a key-value pair from the 188 * `info->props' array within a `FontRec' structure of a PCF font. 189 * 190 * Integer properties are always stored as `signed' within PCF fonts; 191 * consequently, @BDF_PROPERTY_TYPE_CARDINAL is a possible return value 192 * for BDF fonts only. 193 * 194 * In case of error, `aproperty->type' is always set to 195 * @BDF_PROPERTY_TYPE_NONE. 196 */ 197 FT_EXPORT( FT_Error ) 198 FT_Get_BDF_Property( FT_Face face, 199 const char* prop_name, 200 BDF_PropertyRec *aproperty ); 201 202 /* */ 203 204 FT_END_HEADER 205 206 #endif /* __FTBDF_H__ */ 207 208 209 /* END */ 210