1 /***************************************************************************/
5 /* ANSI-specific configuration file (specification only). */
7 /* Copyright 1996-2001 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 header file contains a number of macro definitions that are used */
22 /* by the rest of the engine. Most of the macros here are automatically */
23 /* determined at compile time, and you should not need to change it to */
24 /* port FreeType, except to compile the library with a non-ANSI */
27 /* Note however that if some specific modifications are needed, we */
28 /* advise you to place a modified copy in your build directory. */
30 /* The build directory is usually `freetype/builds/<system>', and */
31 /* contains system-specific files that are always included first when */
32 /* building the library. */
34 /* This ANSI version should stay in `include/freetype/config'. */
36 /*************************************************************************/
39 #ifndef __FTCONFIG_H__
40 #define __FTCONFIG_H__
43 #include FT_CONFIG_OPTIONS_H
49 /*************************************************************************/
51 /* PLATFORM-SPECIFIC CONFIGURATION MACROS */
53 /* These macros can be toggled to suit a specific system. The current */
54 /* ones are defaults used to compile FreeType in an ANSI C environment */
55 /* (16bit compilers are also supported). Copy this file to your own */
56 /* `freetype/builds/<system>' directory, and edit it to port the engine. */
58 /*************************************************************************/
61 /* We use <limits.h> values to know the sizes of the types. */
64 /* The number of bytes in an `int' type. */
65 #if UINT_MAX == 0xFFFFFFFFUL
66 #define FT_SIZEOF_INT 4
67 #elif UINT_MAX == 0xFFFFU
68 #define FT_SIZEOF_INT 2
69 #elif UINT_MAX > 0xFFFFFFFFU && UINT_MAX == 0xFFFFFFFFFFFFFFFFU
70 #define FT_SIZEOF_INT 8
72 #error "Unsupported number of bytes in `int' type!"
75 /* The number of bytes in a `long' type. */
76 #if ULONG_MAX == 0xFFFFFFFFUL
77 #define FT_SIZEOF_LONG 4
78 #elif ULONG_MAX > 0xFFFFFFFFU && ULONG_MAX == 0xFFFFFFFFFFFFFFFFU
79 #define FT_SIZEOF_LONG 8
81 #error "Unsupported number of bytes in `long' type!"
85 /* Preferred alignment of data */
86 #define FT_ALIGNMENT 8
89 /* UNUSED is a macro used to indicate that a given parameter is not used */
90 /* -- this is only used to get rid of unpleasant compiler warnings */
92 #define FT_UNUSED( arg ) ( (arg) = (arg) )
96 /*************************************************************************/
98 /* AUTOMATIC CONFIGURATION MACROS */
100 /* These macros are computed from the ones defined above. Don't touch */
101 /* their definition, unless you know precisely what you are doing. No */
102 /* porter should need to mess with them. */
104 /*************************************************************************/
107 /*************************************************************************/
111 /* Used to guarantee the size of some specific integers. */
113 typedef signed short FT_Int16;
114 typedef unsigned short FT_UInt16;
116 #if FT_SIZEOF_INT == 4
118 typedef signed int FT_Int32;
119 typedef unsigned int FT_UInt32;
121 #elif FT_SIZEOF_LONG == 4
123 typedef signed long FT_Int32;
124 typedef unsigned long FT_UInt32;
127 #error "no 32bit type found -- please check your configuration files"
130 /* now, lookup for an integer type that is at least 32 bits */
131 #if FT_SIZEOF_INT >= 4
134 typedef unsigned int FT_UFast;
136 #elif FT_SIZEOF_LONG >= 4
138 typedef long FT_Fast;
139 typedef unsigned long FT_UFast;
145 /* determine whether we have a 64-bit int type for platforms without */
147 #if FT_SIZEOF_LONG == 8
149 /* FT_LONG64 must be defined if a 64-bit type is available */
151 #define FT_INT64 long
153 #elif defined( _MSC_VER ) /* Visual C++ (and Intel C++) */
155 /* this compiler provides the __int64 type */
157 #define FT_INT64 __int64
159 #elif defined( __BORLANDC__ ) /* Borland C++ */
161 /* XXXX: We should probably check the value of __BORLANDC__ in order */
162 /* to test the compiler version. */
164 /* this compiler provides the __int64 type */
166 #define FT_INT64 __int64
168 #elif defined( __WATCOMC__ ) /* Watcom C++ */
170 /* Watcom doesn't provide 64-bit data types */
172 #elif defined( __MWKS__ ) /* Metrowerks CodeWarrior */
174 /* I don't know if it provides 64-bit data types, any suggestion */
177 #elif defined( __GNUC__ )
179 /* GCC provides the "long long" type */
181 #define FT_INT64 long long int
183 #endif /* !FT_LONG64 */
186 /*************************************************************************/
188 /* A 64-bit data type will create compilation problems if you compile */
189 /* in strict ANSI mode. To avoid them, we disable their use if */
190 /* __STDC__ is defined. You can however ignore this rule by */
191 /* defining the FT_CONFIG_OPTION_FORCE_INT64 configuration macro. */
193 #if defined( FT_LONG64 ) && !defined( FT_CONFIG_OPTION_FORCE_INT64 )
197 /* undefine the 64-bit macros in strict ANSI compilation mode */
201 #endif /* __STDC__ */
203 #endif /* FT_LONG64 && !FT_CONFIG_OPTION_FORCE_INT64 */
206 #ifdef FT_MAKE_OPTION_SINGLE_OBJECT
208 #define FT_LOCAL static
209 #define FT_LOCAL_DEF static
214 #define FT_LOCAL extern "C"
215 #define FT_LOCAL_DEF extern "C"
217 #define FT_LOCAL extern
218 #define FT_LOCAL_DEF extern
221 #endif /* FT_MAKE_OPTION_SINGLE_OBJECT */
227 #define FT_BASE( x ) extern "C" x
229 #define FT_BASE( x ) extern x
232 #endif /* !FT_BASE */
238 #define FT_BASE_DEF( x ) extern "C" x
240 #define FT_BASE_DEF( x ) extern x
243 #endif /* !FT_BASE_DEF */
249 #define FT_EXPORT( x ) extern "C" x
251 #define FT_EXPORT( x ) extern x
254 #endif /* !FT_EXPORT */
257 #ifndef FT_EXPORT_DEF
260 #define FT_EXPORT_DEF( x ) extern "C" x
262 #define FT_EXPORT_DEF( x ) extern x
265 #endif /* !FT_EXPORT_DEF */
268 #ifndef FT_EXPORT_VAR
271 #define FT_EXPORT_VAR( x ) extern "C" x
273 #define FT_EXPORT_VAR( x ) extern x
276 #endif /* !FT_EXPORT_VAR */
278 /* The following macros are needed to compile the library with a */
279 /* C++ compiler and with 16bit compilers. */
282 /* This is special. Within C++, you must specify `extern "C"' for */
283 /* functions which are used via function pointers, and you also */
284 /* must do that for structures which contain function pointers to */
285 /* assure C linkage -- it's not possible to have (local) anonymous */
286 /* functions which are accessed by (global) function pointers. */
289 /* FT_CALLBACK_DEF is used to _define_ a callback function. */
291 /* FT_CALLBACK_TABLE is used to _declare_ a constant variable that */
292 /* contains pointers to callback functions. */
294 /* FT_CALLBACK_TABLE_DEF is used to _define_ a constant variable */
295 /* that contains pointers to callback functions. */
298 /* Some 16bit compilers have to redefine these macros to insert */
299 /* the infamous `_cdecl' or `__fastcall' declarations. */
301 #ifndef FT_CALLBACK_DEF
303 #define FT_CALLBACK_DEF( x ) extern "C" x
305 #define FT_CALLBACK_DEF( x ) static x
307 #endif /* FT_CALLBACK_DEF */
309 #ifndef FT_CALLBACK_TABLE
311 #define FT_CALLBACK_TABLE extern "C"
312 #define FT_CALLBACK_TABLE_DEF extern "C"
314 #define FT_CALLBACK_TABLE extern
315 #define FT_CALLBACK_TABLE_DEF /* nothing */
317 #endif /* FT_CALLBACK_TABLE */
323 #endif /* __FTCONFIG_H__ */