1
/***************************************************************************/
5
/* Debugging and logging component (body). */
7
/* Copyright 1996-2001, 2002, 2004 by */
8
/* David Turner, Robert Wilhelm, and Werner Lemberg. */
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. */
16
/***************************************************************************/
19
/*************************************************************************/
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. */
25
/* There are now three debugging modes: */
29
/* Error and trace messages are sent to the log file (which can be the */
30
/* standard error output). */
34
/* Only error messages are generated. */
38
/* No error message is sent or generated. The code is free from any */
39
/* debugging parts. */
41
/*************************************************************************/
45
#include FT_FREETYPE_H
46
#include FT_INTERNAL_DEBUG_H
49
#if defined( FT_DEBUG_LEVEL_ERROR )
52
FT_Message( const char* fmt, ... )
64
FT_Panic( const char* fmt, ... )
76
#endif /* FT_DEBUG_LEVEL_ERROR */
80
#ifdef FT_DEBUG_LEVEL_TRACE
82
/* array of trace levels, initialized to 0 */
83
int ft_trace_levels[trace_count];
86
/* define array of trace toggle names */
87
#define FT_TRACE_DEF( x ) #x ,
89
static const char* ft_trace_toggles[trace_count + 1] =
91
#include FT_INTERNAL_TRACE_H
98
/* documentation is in ftdebug.h */
100
FT_EXPORT_DEF( FT_Int )
101
FT_Trace_Get_Count( void )
107
/* documentation is in ftdebug.h */
109
FT_EXPORT_DEF( const char * )
110
FT_Trace_Get_Name( FT_Int idx )
112
int max = FT_Trace_Get_Count();
116
return ft_trace_toggles[idx];
122
/*************************************************************************/
124
/* Initialize the tracing sub-system. This is done by retrieving the */
125
/* value of the `FT2_DEBUG' environment variable. It must be a list of */
126
/* toggles, separated by spaces, `;', or `,'. Example: */
128
/* export FT2_DEBUG="any:3 memory:6 stream:5" */
130
/* This requests that all levels be set to 3, except the trace level for */
131
/* the memory and stream components which are set to 6 and 5, */
134
/* See the file <include/freetype/internal/fttrace.h> for details of the */
135
/* available toggle names. */
137
/* The level must be between 0 and 6; 0 means quiet (except for serious */
138
/* runtime errors), and 6 means _very_ verbose. */
141
ft_debug_init( void )
143
const char* ft2_debug = getenv( "FT2_DEBUG" );
148
const char* p = ft2_debug;
154
/* skip leading whitespace and separators */
155
if ( *p == ' ' || *p == '\t' || *p == ',' || *p == ';' || *p == '=' )
158
/* read toggle name, followed by ':' */
160
while ( *p && *p != ':' )
163
if ( *p == ':' && p > q )
165
FT_Int n, i, len = (FT_Int)( p - q );
166
FT_Int level = -1, found = -1;
169
for ( n = 0; n < trace_count; n++ )
171
const char* toggle = ft_trace_toggles[n];
174
for ( i = 0; i < len; i++ )
176
if ( toggle[i] != q[i] )
180
if ( i == len && toggle[i] == 0 )
192
if ( level < 0 || level > 6 )
196
if ( found >= 0 && level >= 0 )
198
if ( found == trace_any )
200
/* special case for `any' */
201
for ( n = 0; n < trace_count; n++ )
202
ft_trace_levels[n] = level;
205
ft_trace_levels[found] = level;
213
#else /* !FT_DEBUG_LEVEL_TRACE */
217
ft_debug_init( void )
223
FT_EXPORT_DEF( FT_Int )
224
FT_Trace_Get_Count( void )
230
FT_EXPORT_DEF( const char * )
231
FT_Trace_Get_Name( FT_Int idx )
239
#endif /* !FT_DEBUG_LEVEL_TRACE */