ReactOS 0.4.15-dev-8096-ga0eec98
ftdebug.c
Go to the documentation of this file.
1/***************************************************************************/
2/* */
3/* ftdebug.c */
4/* */
5/* Debugging and logging component (body). */
6/* */
7/* Copyright 1996-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 /* This component contains various macros and functions used to ease the */
22 /* debugging of the FreeType engine. Its main purpose is in assertion */
23 /* checking, tracing, and error detection. */
24 /* */
25 /* There are now three debugging modes: */
26 /* */
27 /* - trace mode */
28 /* */
29 /* Error and trace messages are sent to the log file (which can be the */
30 /* standard error output). */
31 /* */
32 /* - error mode */
33 /* */
34 /* Only error messages are generated. */
35 /* */
36 /* - release mode: */
37 /* */
38 /* No error message is sent or generated. The code is free from any */
39 /* debugging parts. */
40 /* */
41 /*************************************************************************/
42
43
44#include <ft2build.h>
45#include FT_FREETYPE_H
46#include FT_INTERNAL_DEBUG_H
47
48
49#ifdef FT_DEBUG_LEVEL_ERROR
50
51 /* documentation is in ftdebug.h */
52
53 FT_BASE_DEF( void )
54 FT_Message( const char* fmt,
55 ... )
56 {
57 va_list ap;
58
59
60 va_start( ap, fmt );
61 vfprintf( stderr, fmt, ap );
62 va_end( ap );
63 }
64
65
66 /* documentation is in ftdebug.h */
67
68 FT_BASE_DEF( void )
69 FT_Panic( const char* fmt,
70 ... )
71 {
72 va_list ap;
73
74
75 va_start( ap, fmt );
76 vfprintf( stderr, fmt, ap );
77 va_end( ap );
78
80 }
81
82
83 /* documentation is in ftdebug.h */
84
85 FT_BASE_DEF( int )
86 FT_Throw( FT_Error error,
87 int line,
88 const char* file )
89 {
91 FT_UNUSED( line );
92 FT_UNUSED( file );
93
94 return 0;
95 }
96
97#endif /* FT_DEBUG_LEVEL_ERROR */
98
99
100
101#ifdef FT_DEBUG_LEVEL_TRACE
102
103 /* array of trace levels, initialized to 0 */
104 int ft_trace_levels[trace_count];
105
106
107 /* define array of trace toggle names */
108#define FT_TRACE_DEF( x ) #x ,
109
110 static const char* ft_trace_toggles[trace_count + 1] =
111 {
112#include FT_INTERNAL_TRACE_H
113 NULL
114 };
115
116#undef FT_TRACE_DEF
117
118
119 /* documentation is in ftdebug.h */
120
122 FT_Trace_Get_Count( void )
123 {
124 return trace_count;
125 }
126
127
128 /* documentation is in ftdebug.h */
129
130 FT_BASE_DEF( const char * )
132 {
133 int max = FT_Trace_Get_Count();
134
135
136 if ( idx < max )
137 return ft_trace_toggles[idx];
138 else
139 return NULL;
140 }
141
142
143 /*************************************************************************/
144 /* */
145 /* Initialize the tracing sub-system. This is done by retrieving the */
146 /* value of the `FT2_DEBUG' environment variable. It must be a list of */
147 /* toggles, separated by spaces, `;', or `,'. Example: */
148 /* */
149 /* export FT2_DEBUG="any:3 memory:7 stream:5" */
150 /* */
151 /* This requests that all levels be set to 3, except the trace level for */
152 /* the memory and stream components which are set to 7 and 5, */
153 /* respectively. */
154 /* */
155 /* See the file `include/freetype/internal/fttrace.h' for details of */
156 /* the available toggle names. */
157 /* */
158 /* The level must be between 0 and 7; 0 means quiet (except for serious */
159 /* runtime errors), and 7 means _very_ verbose. */
160 /* */
161 FT_BASE_DEF( void )
162 ft_debug_init( void )
163 {
164 const char* ft2_debug = ft_getenv( "FT2_DEBUG" );
165
166
167 if ( ft2_debug )
168 {
169 const char* p = ft2_debug;
170 const char* q;
171
172
173 for ( ; *p; p++ )
174 {
175 /* skip leading whitespace and separators */
176 if ( *p == ' ' || *p == '\t' || *p == ',' || *p == ';' || *p == '=' )
177 continue;
178
179 /* read toggle name, followed by ':' */
180 q = p;
181 while ( *p && *p != ':' )
182 p++;
183
184 if ( !*p )
185 break;
186
187 if ( *p == ':' && p > q )
188 {
189 FT_Int n, i, len = (FT_Int)( p - q );
190 FT_Int level = -1, found = -1;
191
192
193 for ( n = 0; n < trace_count; n++ )
194 {
195 const char* toggle = ft_trace_toggles[n];
196
197
198 for ( i = 0; i < len; i++ )
199 {
200 if ( toggle[i] != q[i] )
201 break;
202 }
203
204 if ( i == len && toggle[i] == 0 )
205 {
206 found = n;
207 break;
208 }
209 }
210
211 /* read level */
212 p++;
213 if ( *p )
214 {
215 level = *p - '0';
216 if ( level < 0 || level > 7 )
217 level = -1;
218 }
219
220 if ( found >= 0 && level >= 0 )
221 {
222 if ( found == trace_any )
223 {
224 /* special case for `any' */
225 for ( n = 0; n < trace_count; n++ )
226 ft_trace_levels[n] = level;
227 }
228 else
229 ft_trace_levels[found] = level;
230 }
231 }
232 }
233 }
234 }
235
236
237#else /* !FT_DEBUG_LEVEL_TRACE */
238
239
240 FT_BASE_DEF( void )
242 {
243 /* nothing */
244 }
245
246
249 {
250 return 0;
251 }
252
253
254 FT_BASE_DEF( const char * )
256 {
257 FT_UNUSED( idx );
258
259 return NULL;
260 }
261
262
263#endif /* !FT_DEBUG_LEVEL_TRACE */
264
265
266/* END */
char * va_list
Definition: acmsvcex.h:78
#define va_end(ap)
Definition: acmsvcex.h:90
#define va_start(ap, A)
Definition: acmsvcex.h:91
#define NULL
Definition: types.h:112
unsigned int idx
Definition: utils.c:41
#define FT_UNUSED(arg)
Definition: ftconfig.h:101
#define FT_BASE_DEF(x)
Definition: ftconfig.h:419
FT_Trace_Get_Name(FT_Int idx)
Definition: ftdebug.c:255
FT_Trace_Get_Count(void)
Definition: ftdebug.c:248
ft_debug_init(void)
Definition: ftdebug.c:241
#define ft_getenv
Definition: ftstdlib.h:146
int FT_Error
Definition: fttypes.h:300
signed int FT_Int
Definition: fttypes.h:220
GLint level
Definition: gl.h:1546
GLdouble GLdouble GLdouble GLdouble q
Definition: gl.h:2063
GLdouble n
Definition: glext.h:7729
GLfloat GLfloat p
Definition: glext.h:8902
GLenum GLsizei len
Definition: glext.h:6722
GLsizei GLenum const GLvoid GLsizei GLenum GLbyte GLbyte GLbyte GLdouble GLdouble GLdouble GLfloat GLfloat GLfloat GLint GLint GLint GLshort GLshort GLshort GLubyte GLubyte GLubyte GLuint GLuint GLuint GLushort GLushort GLushort GLbyte GLbyte GLbyte GLbyte GLdouble GLdouble GLdouble GLdouble GLfloat GLfloat GLfloat GLfloat GLint GLint GLint GLint GLshort GLshort GLshort GLshort GLubyte GLubyte GLubyte GLubyte GLuint GLuint GLuint GLuint GLushort GLushort GLushort GLushort GLboolean const GLdouble const GLfloat const GLint const GLshort const GLbyte const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLdouble const GLfloat const GLfloat const GLint const GLint const GLshort const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort GLenum GLenum GLenum GLfloat GLenum GLint GLenum GLenum GLenum GLfloat GLenum GLenum GLint GLenum GLfloat GLenum GLint GLint GLushort GLenum GLenum GLfloat GLenum GLenum GLint GLfloat const GLubyte GLenum GLenum GLenum const GLfloat GLenum GLenum const GLint GLenum GLint GLint GLsizei GLsizei GLint GLenum GLenum const GLvoid GLenum GLenum const GLfloat GLenum GLenum const GLint GLenum GLenum const GLdouble GLenum GLenum const GLfloat GLenum GLenum const GLint GLsizei GLuint GLfloat GLuint GLbitfield GLfloat GLint GLuint GLboolean GLenum GLfloat GLenum GLbitfield GLenum GLfloat GLfloat GLint GLint const GLfloat GLenum GLfloat GLfloat GLint GLint GLfloat GLfloat GLint GLint const GLfloat GLint GLfloat GLfloat GLint GLfloat GLfloat GLint GLfloat GLfloat const GLdouble const GLfloat const GLdouble const GLfloat GLint i
Definition: glfuncs.h:248
#define stderr
Definition: stdio.h:100
_Check_return_opt_ _CRTIMP int __cdecl vfprintf(_Inout_ FILE *_File, _In_z_ _Printf_format_string_ const char *_Format, va_list _ArgList)
#define EXIT_FAILURE
Definition: jerror.c:33
#define error(str)
Definition: mkdosfs.c:1605
#define exit(n)
Definition: config.h:202
Definition: fci.c:127
Definition: dsound.c:943
Definition: parser.c:49
#define max(a, b)
Definition: svc.c:63
void int int ULONGLONG int va_list * ap
Definition: winesup.h:36