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