fterrdef.h (12559B)
1 /**************************************************************************** 2 * 3 * fterrdef.h 4 * 5 * FreeType error codes (specification). 6 * 7 * Copyright (C) 2002-2025 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 /************************************************************************** 20 * 21 * @section: 22 * error_code_values 23 * 24 * @title: 25 * Error Code Values 26 * 27 * @abstract: 28 * All possible error codes returned by FreeType functions. 29 * 30 * @description: 31 * The list below is taken verbatim from the file `fterrdef.h` (loaded 32 * automatically by including `FT_FREETYPE_H`). The first argument of the 33 * `FT_ERROR_DEF_` macro is the error label; by default, the prefix 34 * `FT_Err_` gets added so that you get error names like 35 * `FT_Err_Cannot_Open_Resource`. The second argument is the error code, 36 * and the last argument an error string, which is not used by FreeType. 37 * 38 * Within your application you should **only** use error names and 39 * **never** its numeric values! The latter might (and actually do) 40 * change in forthcoming FreeType versions. 41 * 42 * Macro `FT_NOERRORDEF_` defines `FT_Err_Ok`, which is always zero. See 43 * the 'Error Enumerations' subsection how to automatically generate a 44 * list of error strings. 45 * 46 */ 47 48 49 /************************************************************************** 50 * 51 * @enum: 52 * FT_Err_XXX 53 * 54 */ 55 56 /* generic errors */ 57 58 FT_NOERRORDEF_( Ok, 0x00, 59 "no error" ) 60 61 FT_ERRORDEF_( Cannot_Open_Resource, 0x01, 62 "cannot open resource" ) 63 FT_ERRORDEF_( Unknown_File_Format, 0x02, 64 "unknown file format" ) 65 FT_ERRORDEF_( Invalid_File_Format, 0x03, 66 "broken file" ) 67 FT_ERRORDEF_( Invalid_Version, 0x04, 68 "invalid FreeType version" ) 69 FT_ERRORDEF_( Lower_Module_Version, 0x05, 70 "module version is too low" ) 71 FT_ERRORDEF_( Invalid_Argument, 0x06, 72 "invalid argument" ) 73 FT_ERRORDEF_( Unimplemented_Feature, 0x07, 74 "unimplemented feature" ) 75 FT_ERRORDEF_( Invalid_Table, 0x08, 76 "broken table" ) 77 FT_ERRORDEF_( Invalid_Offset, 0x09, 78 "broken offset within table" ) 79 FT_ERRORDEF_( Array_Too_Large, 0x0A, 80 "array allocation size too large" ) 81 FT_ERRORDEF_( Missing_Module, 0x0B, 82 "missing module" ) 83 FT_ERRORDEF_( Missing_Property, 0x0C, 84 "missing property" ) 85 86 /* glyph/character errors */ 87 88 FT_ERRORDEF_( Invalid_Glyph_Index, 0x10, 89 "invalid glyph index" ) 90 FT_ERRORDEF_( Invalid_Character_Code, 0x11, 91 "invalid character code" ) 92 FT_ERRORDEF_( Invalid_Glyph_Format, 0x12, 93 "unsupported glyph image format" ) 94 FT_ERRORDEF_( Cannot_Render_Glyph, 0x13, 95 "cannot render this glyph format" ) 96 FT_ERRORDEF_( Invalid_Outline, 0x14, 97 "invalid outline" ) 98 FT_ERRORDEF_( Invalid_Composite, 0x15, 99 "invalid composite glyph" ) 100 FT_ERRORDEF_( Too_Many_Hints, 0x16, 101 "too many hints" ) 102 FT_ERRORDEF_( Invalid_Pixel_Size, 0x17, 103 "invalid pixel size" ) 104 FT_ERRORDEF_( Invalid_SVG_Document, 0x18, 105 "invalid SVG document" ) 106 107 /* handle errors */ 108 109 FT_ERRORDEF_( Invalid_Handle, 0x20, 110 "invalid object handle" ) 111 FT_ERRORDEF_( Invalid_Library_Handle, 0x21, 112 "invalid library handle" ) 113 FT_ERRORDEF_( Invalid_Driver_Handle, 0x22, 114 "invalid module handle" ) 115 FT_ERRORDEF_( Invalid_Face_Handle, 0x23, 116 "invalid face handle" ) 117 FT_ERRORDEF_( Invalid_Size_Handle, 0x24, 118 "invalid size handle" ) 119 FT_ERRORDEF_( Invalid_Slot_Handle, 0x25, 120 "invalid glyph slot handle" ) 121 FT_ERRORDEF_( Invalid_CharMap_Handle, 0x26, 122 "invalid charmap handle" ) 123 FT_ERRORDEF_( Invalid_Cache_Handle, 0x27, 124 "invalid cache manager handle" ) 125 FT_ERRORDEF_( Invalid_Stream_Handle, 0x28, 126 "invalid stream handle" ) 127 128 /* driver errors */ 129 130 FT_ERRORDEF_( Too_Many_Drivers, 0x30, 131 "too many modules" ) 132 FT_ERRORDEF_( Too_Many_Extensions, 0x31, 133 "too many extensions" ) 134 135 /* memory errors */ 136 137 FT_ERRORDEF_( Out_Of_Memory, 0x40, 138 "out of memory" ) 139 FT_ERRORDEF_( Unlisted_Object, 0x41, 140 "unlisted object" ) 141 142 /* stream errors */ 143 144 FT_ERRORDEF_( Cannot_Open_Stream, 0x51, 145 "cannot open stream" ) 146 FT_ERRORDEF_( Invalid_Stream_Seek, 0x52, 147 "invalid stream seek" ) 148 FT_ERRORDEF_( Invalid_Stream_Skip, 0x53, 149 "invalid stream skip" ) 150 FT_ERRORDEF_( Invalid_Stream_Read, 0x54, 151 "invalid stream read" ) 152 FT_ERRORDEF_( Invalid_Stream_Operation, 0x55, 153 "invalid stream operation" ) 154 FT_ERRORDEF_( Invalid_Frame_Operation, 0x56, 155 "invalid frame operation" ) 156 FT_ERRORDEF_( Nested_Frame_Access, 0x57, 157 "nested frame access" ) 158 FT_ERRORDEF_( Invalid_Frame_Read, 0x58, 159 "invalid frame read" ) 160 161 /* raster errors */ 162 163 FT_ERRORDEF_( Raster_Uninitialized, 0x60, 164 "raster uninitialized" ) 165 FT_ERRORDEF_( Raster_Corrupted, 0x61, 166 "raster corrupted" ) 167 FT_ERRORDEF_( Raster_Overflow, 0x62, 168 "raster overflow" ) 169 FT_ERRORDEF_( Raster_Negative_Height, 0x63, 170 "negative height while rastering" ) 171 172 /* cache errors */ 173 174 FT_ERRORDEF_( Too_Many_Caches, 0x70, 175 "too many registered caches" ) 176 177 /* TrueType and SFNT errors */ 178 179 FT_ERRORDEF_( Invalid_Opcode, 0x80, 180 "invalid opcode" ) 181 FT_ERRORDEF_( Too_Few_Arguments, 0x81, 182 "too few arguments" ) 183 FT_ERRORDEF_( Stack_Overflow, 0x82, 184 "stack overflow" ) 185 FT_ERRORDEF_( Code_Overflow, 0x83, 186 "code overflow" ) 187 FT_ERRORDEF_( Bad_Argument, 0x84, 188 "bad argument" ) 189 FT_ERRORDEF_( Divide_By_Zero, 0x85, 190 "division by zero" ) 191 FT_ERRORDEF_( Invalid_Reference, 0x86, 192 "invalid reference" ) 193 FT_ERRORDEF_( Debug_OpCode, 0x87, 194 "found debug opcode" ) 195 FT_ERRORDEF_( ENDF_In_Exec_Stream, 0x88, 196 "found ENDF opcode in execution stream" ) 197 FT_ERRORDEF_( Nested_DEFS, 0x89, 198 "nested DEFS" ) 199 FT_ERRORDEF_( Invalid_CodeRange, 0x8A, 200 "invalid code range" ) 201 FT_ERRORDEF_( Execution_Too_Long, 0x8B, 202 "execution context too long" ) 203 FT_ERRORDEF_( Too_Many_Function_Defs, 0x8C, 204 "too many function definitions" ) 205 FT_ERRORDEF_( Too_Many_Instruction_Defs, 0x8D, 206 "too many instruction definitions" ) 207 FT_ERRORDEF_( Table_Missing, 0x8E, 208 "SFNT font table missing" ) 209 FT_ERRORDEF_( Horiz_Header_Missing, 0x8F, 210 "horizontal header (hhea) table missing" ) 211 FT_ERRORDEF_( Locations_Missing, 0x90, 212 "locations (loca) table missing" ) 213 FT_ERRORDEF_( Name_Table_Missing, 0x91, 214 "name table missing" ) 215 FT_ERRORDEF_( CMap_Table_Missing, 0x92, 216 "character map (cmap) table missing" ) 217 FT_ERRORDEF_( Hmtx_Table_Missing, 0x93, 218 "horizontal metrics (hmtx) table missing" ) 219 FT_ERRORDEF_( Post_Table_Missing, 0x94, 220 "PostScript (post) table missing" ) 221 FT_ERRORDEF_( Invalid_Horiz_Metrics, 0x95, 222 "invalid horizontal metrics" ) 223 FT_ERRORDEF_( Invalid_CharMap_Format, 0x96, 224 "invalid character map (cmap) format" ) 225 FT_ERRORDEF_( Invalid_PPem, 0x97, 226 "invalid ppem value" ) 227 FT_ERRORDEF_( Invalid_Vert_Metrics, 0x98, 228 "invalid vertical metrics" ) 229 FT_ERRORDEF_( Could_Not_Find_Context, 0x99, 230 "could not find context" ) 231 FT_ERRORDEF_( Invalid_Post_Table_Format, 0x9A, 232 "invalid PostScript (post) table format" ) 233 FT_ERRORDEF_( Invalid_Post_Table, 0x9B, 234 "invalid PostScript (post) table" ) 235 FT_ERRORDEF_( DEF_In_Glyf_Bytecode, 0x9C, 236 "found FDEF or IDEF opcode in glyf bytecode" ) 237 FT_ERRORDEF_( Missing_Bitmap, 0x9D, 238 "missing bitmap in strike" ) 239 FT_ERRORDEF_( Missing_SVG_Hooks, 0x9E, 240 "SVG hooks have not been set" ) 241 242 /* CFF, CID, and Type 1 errors */ 243 244 FT_ERRORDEF_( Syntax_Error, 0xA0, 245 "opcode syntax error" ) 246 FT_ERRORDEF_( Stack_Underflow, 0xA1, 247 "argument stack underflow" ) 248 FT_ERRORDEF_( Ignore, 0xA2, 249 "ignore" ) 250 FT_ERRORDEF_( No_Unicode_Glyph_Name, 0xA3, 251 "no Unicode glyph name found" ) 252 FT_ERRORDEF_( Glyph_Too_Big, 0xA4, 253 "glyph too big for hinting" ) 254 255 /* BDF errors */ 256 257 FT_ERRORDEF_( Missing_Startfont_Field, 0xB0, 258 "`STARTFONT' field missing" ) 259 FT_ERRORDEF_( Missing_Font_Field, 0xB1, 260 "`FONT' field missing" ) 261 FT_ERRORDEF_( Missing_Size_Field, 0xB2, 262 "`SIZE' field missing" ) 263 FT_ERRORDEF_( Missing_Fontboundingbox_Field, 0xB3, 264 "`FONTBOUNDINGBOX' field missing" ) 265 FT_ERRORDEF_( Missing_Chars_Field, 0xB4, 266 "`CHARS' field missing" ) 267 FT_ERRORDEF_( Missing_Startchar_Field, 0xB5, 268 "`STARTCHAR' field missing" ) 269 FT_ERRORDEF_( Missing_Encoding_Field, 0xB6, 270 "`ENCODING' field missing" ) 271 FT_ERRORDEF_( Missing_Bbx_Field, 0xB7, 272 "`BBX' field missing" ) 273 FT_ERRORDEF_( Bbx_Too_Big, 0xB8, 274 "`BBX' too big" ) 275 FT_ERRORDEF_( Corrupted_Font_Header, 0xB9, 276 "Font header corrupted or missing fields" ) 277 FT_ERRORDEF_( Corrupted_Font_Glyphs, 0xBA, 278 "Font glyphs corrupted or missing fields" ) 279 280 /* */ 281 282 283 /* END */