| /***************************************************************************/ |
| /* */ |
| /* ftoption.h */ |
| /* */ |
| /* User-selectable configuration macros. */ |
| /* */ |
| /* Copyright 1996-2000 by */ |
| /* David Turner, Robert Wilhelm, and Werner Lemberg. */ |
| /* */ |
| /* This file is part of the FreeType project, and may only be used */ |
| /* modified and distributed under the terms of the FreeType project */ |
| /* license, LICENSE.TXT. By continuing to use, modify, or distribute */ |
| /* this file you indicate that you have read the license and */ |
| /* understand and accept it fully. */ |
| /* */ |
| /***************************************************************************/ |
| |
| #ifndef FTOPTION_H |
| #define FTOPTION_H |
| |
| /*************************************************************************/ |
| /* */ |
| /* USER-SELECTABLE CONFIGURATION MACROS */ |
| /* */ |
| /* These macros can be toggled by developers to enable or disable */ |
| /* certain aspects of FreeType. This is a default file, where all major */ |
| /* options are enabled. */ |
| /* */ |
| /* Note that if some modifications are required for your build, we */ |
| /* advise you to put a modified copy of this file in your build */ |
| /* directory, rather than modifying it in-place. */ |
| /* */ |
| /* The build directory is normally "freetype/config/<system>" and */ |
| /* contains build or system-specific files that are included in */ |
| /* priority when building the library. */ |
| /* */ |
| /*************************************************************************/ |
| |
| /*************************************************************************/ |
| /*************************************************************************/ |
| /**** ****/ |
| /**** G E N E R A L F R E E T Y P E 2 C O N F I G U R A T I O N ****/ |
| /**** ****/ |
| /*************************************************************************/ |
| /*************************************************************************/ |
| |
| /*************************************************************************/ |
| /* */ |
| /* Convenience functions support */ |
| /* */ |
| /* Some functions of the FreeType 2 API are provided as a convenience */ |
| /* for client applications and developers. However, they are not */ |
| /* required to build and run the library itself. */ |
| /* */ |
| /* By defining this configuration macro, you'll disable the */ |
| /* compilation of these functions at build time. This can be useful */ |
| /* to reduce the library's code size when you don't need any of */ |
| /* these functions.. */ |
| /* */ |
| /* All convenience functions are declared as such in their */ |
| /* documentation. */ |
| /* */ |
| #undef FT_CONFIG_OPTION_NO_CONVENIENCE_FUNCS |
| |
| /*************************************************************************/ |
| /* */ |
| /* Alternate Glyph Image Format support */ |
| /* */ |
| /* By default, the glyph images returned by the FreeType glyph loader */ |
| /* can either be a pixmap or a vectorial outline defined through */ |
| /* bezier control points. When defining the following configuration */ |
| /* macro, some font drivers will be able to register alternate */ |
| /* glyph image formats. */ |
| /* */ |
| /* Unset this macro if you're sure that you'll never use a font driver */ |
| /* with an alternate glyph format, this will reduce the size of the */ |
| /* base layer code. */ |
| /* */ |
| /* Note that a few Type 1 fonts, as well as Windows "Vector" fonts */ |
| /* use a vector "plotter" format that isn't supported when this */ |
| /* macro is undefined.. */ |
| /* */ |
| #define FT_CONFIG_OPTION_ALTERNATE_GLYPH_FORMATS |
| |
| |
| /*************************************************************************/ |
| /* */ |
| /* Glyph Postscript Names handling */ |
| /* */ |
| /* By default, FreeType 2 is built with the "psnames" module compiled */ |
| /* in. This module is in charge of converting a glyph name string into */ |
| /* a Unicode value, or return a Macintosh standard glyph name for the */ |
| /* use with the TrueType "post" table. */ |
| /* */ |
| /* Undefine this macro if you do not want the "psnames" compiled in */ |
| /* your build of FreeType. This has the following effects : */ |
| /* */ |
| /* - the TrueType driver will provide its own set of glyph names, */ |
| /* if you build it to support postscript names in the TrueType */ |
| /* "post" table. */ |
| /* */ |
| /* - the Type 1 driver will not be able to synthetize a */ |
| /* Unicode charmap out of the glyphs found in the fonts. */ |
| /* */ |
| /* You would normally undefine this configuration macro when */ |
| /* building a version of FreeType that doesn't contain a Type 1 */ |
| /* or CFF driver. */ |
| /* */ |
| #define FT_CONFIG_OPTION_POSTSCRIPT_NAMES |
| |
| |
| /*************************************************************************/ |
| /* */ |
| /* Postscript Names to Unicode Values support */ |
| /* */ |
| /* By default, FreeType 2 is built with the "psnames" module compiled */ |
| /* in. Among other things, the module is used to convert a glyph */ |
| /* name into a unicode value. This is especially useful in order to */ |
| /* synthetize on the fly a Unicode charmap from the CFF/Type 1 driver */ |
| /* through a big table named the "Adobe Glyph List". */ |
| /* */ |
| /* Undefine this macro if you do not want the Adobe Glyph List */ |
| /* compiled in your "psnames" module. The Type 1 driver will not */ |
| /* be able to synthetize a Unicode charmap out of the glyphs found */ |
| /* in the fonts.. */ |
| /* */ |
| #define FT_CONFIG_OPTION_ADOBE_GLYPH_LIST |
| |
| |
| /*************************************************************************/ |
| /* */ |
| /* many compilers provide the non-ANSI 'long long' 64-bit type. You can */ |
| /* activate it by defining the FTCALC_USE_LONG_LONG macro in `ftoption.h'*/ |
| /* Note that this will produce many -ansi warnings during library */ |
| /* compilation, and that in many cases, the generated code will not be */ |
| /* smaller or faster !! */ |
| /* */ |
| #undef FTCALC_USE_LONG_LONG |
| |
| |
| /*************************************************************************/ |
| /* */ |
| /* DLL Export Compilation */ |
| /* */ |
| /* When compiling FreeType as a DLL, some systems/compilers need a */ |
| /* special keyword in front OR after the return type of function */ |
| /* declarations. */ |
| /* */ |
| /* Two macros are used within the FreeType source code to define */ |
| /* exported library functions: FT_EXPORT_DEF and FT_EXPORT_FUNC */ |
| /* */ |
| /* FT_EXPORT_DEF(return_type) is used in a function declaration, as in: */ |
| /* */ |
| /* FT_EXPORT_DEF(FT_Error) FT_Init_FreeType( FT_Library *alibrary ); */ |
| /* */ |
| /* */ |
| /* */ |
| /* FT_EXPORT_FUNC(return_type) is used in a function definition, as in: */ |
| /* */ |
| /* FT_EXPORT_FUNC(FT_Error) FT_Init_FreeType( FT_Library *alibrary ) */ |
| /* { */ |
| /* ... some code ... */ |
| /* return FT_Err_Ok; */ |
| /* } */ |
| /* */ |
| /* */ |
| /* You can provide your own implementation of FT_EXPORT_DEF and */ |
| /* FT_EXPORT_FUNC here if you want. If you leave them undefined, they'll */ |
| /* later be automatically defined as "extern return_type" to allow normal*/ |
| /* compilation.. */ |
| /* */ |
| #undef FT_EXPORT_DEF |
| #undef FT_EXPORT_FUNC |
| |
| |
| /*************************************************************************/ |
| /* */ |
| /* 5-levels Anti Aliasing support: */ |
| /* */ |
| /* FreeType 2 provides a new "smooth" renderer that is capable of */ |
| /* producing anti-aliased glyph bitmaps with up to 256 gray-levels. */ |
| /* */ |
| /* However, for compatibility purposes with FreeType 1.x, the standard */ |
| /* raster is still capable of generating anti-aliased bitmaps with 5 */ |
| /* gray levels. */ |
| /* */ |
| /* If you do not need this capability (i.e. if you always use the */ |
| /* "smooth" renderer for anti-aliased glyphs), we suggest you to */ |
| /* undefine this configuration macro, as it will save both code and */ |
| /* memory.. */ |
| /* */ |
| #define FT_CONFIG_OPTION_5_GRAY_LEVELS |
| |
| |
| /*************************************************************************/ |
| /* */ |
| /* Debug level */ |
| /* */ |
| /* FreeType can be compiled in debug or trace mode. In debug mode, */ |
| /* errors are reported through the `ftdebug' component. In trace */ |
| /* mode, additional messages are sent to the standard output during */ |
| /* execution. */ |
| /* */ |
| /* Define FT_DEBUG_LEVEL_ERROR to build the library in debug mode. */ |
| /* Define FT_DEBUG_LEVEL_TRACE to build it in trace mode. */ |
| /* */ |
| /* Don't define any of these macros to compile in `release' mode. */ |
| /* */ |
| #undef FT_DEBUG_LEVEL_ERROR |
| #undef FT_DEBUG_LEVEL_TRACE |
| |
| |
| /*************************************************************************/ |
| /* */ |
| /* Endianess performance improvement */ |
| /* */ |
| /* FreeType is completely endian-independent, and can thus be compiled */ |
| /* directly on _any_ machine. However, some components of the library */ |
| /* provide improved routines for the cases where endianess is known. */ |
| /* */ |
| /* It usually results in speed-ups and reduced code size. Note that */ |
| /* you should not define both of these macros. */ |
| /* */ |
| /* */ |
| /* NOTE: For now, only the scan-line converter (base/ftraster.c) uses */ |
| /* these macros to speed-up some anti-alias rendering routines. */ |
| /* */ |
| #undef FT_CONFIG_OPTION_LITTLE_ENDIAN |
| #undef FT_CONFIG_OPTION_BIG_ENDIAN |
| |
| |
| /*************************************************************************/ |
| /* */ |
| /* Computation Algorithms */ |
| /* */ |
| /* Used for debugging, this configuration macro should disappear */ |
| /* soon.. */ |
| /* */ |
| #define FT_CONFIG_OPTION_OLD_CALCS |
| |
| |
| /*************************************************************************/ |
| /* */ |
| /* The size in bytes of the render pool used by the scan-line */ |
| /* converter to do all of its work. */ |
| /* */ |
| /* This must be greater than 4 Kb */ |
| /* */ |
| #define FT_RENDER_POOL_SIZE 8192 |
| |
| |
| /*************************************************************************/ |
| /* */ |
| /* FT_MAX_DRIVERS */ |
| /* */ |
| /* The maximum number of font drivers that can be registered in a */ |
| /* single FreeType library object. 8 seems to be a good choice due */ |
| /* to the relative low actual number of drivers ;-) */ |
| /* */ |
| /* If you don't intend to register new drivers at runtime, you */ |
| /* certainly do not need to change this value.. */ |
| /* */ |
| #define FT_MAX_DRIVERS 8 |
| |
| |
| /*************************************************************************/ |
| /* */ |
| /* FT_MAX_EXTENSIONS */ |
| /* */ |
| /* The maximum number of extensions that can be registered in a */ |
| /* single font driver. 8 seems to be a good choice for now.. */ |
| /* */ |
| /* If you don't know what this means, you certainly do not need to */ |
| /* change this value.. */ |
| /* */ |
| #define FT_MAX_EXTENSIONS 8 |
| |
| |
| /*************************************************************************/ |
| /* */ |
| /* FT_MAX_GLYPH_FORMATS */ |
| /* */ |
| /* The maximum number of glyph image formats that might be registered */ |
| /* in a given library instance. 8 seems to be a good choice due to */ |
| /* the relatively low number of current formats ;-) */ |
| /* */ |
| #define FT_MAX_GLYPH_FORMATS 8 |
| |
| /*************************************************************************/ |
| /*************************************************************************/ |
| /**** ****/ |
| /**** S F N T D R I V E R C O N F I G U R A T I O N ****/ |
| /**** ****/ |
| /*************************************************************************/ |
| /*************************************************************************/ |
| |
| /*************************************************************************/ |
| /* */ |
| /* Define TT_CONFIG_OPTION_EMBEDDED_BITMAPS if you want to support */ |
| /* embedded bitmaps in all formats using the SFNT module (namely */ |
| /* TrueType & OpenType). */ |
| /* */ |
| #define TT_CONFIG_OPTION_EMBEDDED_BITMAPS |
| |
| |
| /*************************************************************************/ |
| /* */ |
| /* Define TT_CONFIG_OPTION_POSTSCRIPT_NAMES if you want to be able to */ |
| /* load and enumerate the glyph Postscript names in a TrueType or */ |
| /* OpenType file. */ |
| /* */ |
| /* Note that when you do not compile the "psnames" module by undefining */ |
| /* the above FT_CONFIG_OPTION_POSTSCRIPT_NAMES, the "sfnt" module will */ |
| /* contain additional code used to read the PS Names table from a font. */ |
| /* */ |
| /* (by default, the module uses "psnames" to extract glyph names).. */ |
| /* */ |
| #define TT_CONFIG_OPTION_POSTSCRIPT_NAMES |
| |
| |
| /*************************************************************************/ |
| /*************************************************************************/ |
| /**** ****/ |
| /**** T R U E T Y P E D R I V E R C O N F I G U R A T I O N ****/ |
| /**** ****/ |
| /*************************************************************************/ |
| /*************************************************************************/ |
| |
| /*************************************************************************/ |
| /* */ |
| /* Define TT_CONFIG_OPTION_BYTECODE_INTERPRETER if you want to compile */ |
| /* a bytecode interpreter in the TrueType driver. Note that there are */ |
| /* important patent issues related to the use of the interpreter. */ |
| /* */ |
| /* By undefining this, you'll only compile the code necessary to load */ |
| /* TrueType glyphs without hinting.. */ |
| /* */ |
| #define TT_CONFIG_OPTION_BYTECODE_INTERPRETER |
| |
| /*************************************************************************/ |
| /* */ |
| /* Define TT_CONFIG_OPTION_INTERPRETER_SWITCH to compile the TrueType */ |
| /* bytecode interpreter with a huge switch statement, rather than a */ |
| /* call table. This results in smaller and faster code for a number of */ |
| /* architectures. */ |
| /* */ |
| /* Note however that on some compiler/processor combinations, undefining */ |
| /* this macro will generate a faster, though larger, code. */ |
| /* */ |
| #define TT_CONFIG_OPTION_INTERPRETER_SWITCH |
| |
| |
| /*************************************************************************/ |
| /*************************************************************************/ |
| /**** ****/ |
| /**** T Y P E 1 D R I V E R C O N F I G U R A T I O N ****/ |
| /**** ****/ |
| /*************************************************************************/ |
| /*************************************************************************/ |
| |
| /********************************************************************/ |
| /* T1_MAX_STACK_DEPTH is the maximal depth of the token stack used */ |
| /* by the Type 1 parser (see t1load.c). A minimum of 16 is required */ |
| /* */ |
| #define T1_MAX_STACK_DEPTH 16 |
| |
| /*******************************************************************/ |
| /* T1_MAX_DICT_DEPTH is the maximal depth of nest dictionaries and */ |
| /* arrays in the Type 1 stream (see t1load.c). A minimum of 4 is */ |
| /* required */ |
| #define T1_MAX_DICT_DEPTH 5 |
| |
| /***********************************************************************/ |
| /* T1_MAX_SUBRS_CALLS details the maximum number of nested sub-routine */ |
| /* calls during glyph loading */ |
| #define T1_MAX_SUBRS_CALLS 8 |
| |
| /*****************************************************************/ |
| /* T1_MAX_CHARSTRING_OPERANDS is the charstring stack's capacity */ |
| #define T1_MAX_CHARSTRINGS_OPERANDS 32 |
| |
| |
| /*******************************************************************/ |
| /* Define T1_CONFIG_OPTION_DISABLE_HINTER if you want to generate */ |
| /* a driver with no hinter. This can be useful to debug the parser */ |
| /* */ |
| #undef T1_CONFIG_OPTION_DISABLE_HINTER |
| |
| /*******************************************************************/ |
| /* Define this configuration macro if you want to prevent the */ |
| /* compilation of "t1afm", which is in charge of reading Type1 */ |
| /* AFM files into an existing face. Note that when set, the T1 */ |
| /* driver will be unable to produce kerning distances.. */ |
| /* */ |
| #undef T1_CONFIG_OPTION_NO_AFM |
| |
| /*******************************************************************/ |
| /* Define this configuration macro if you want to prevent the */ |
| /* compilation of the multiple-masters support in the Type 1 driver*/ |
| /* AFM files into an existing face. Note that when set, the T1 */ |
| /* driver will be unable to produce kerning distances.. */ |
| /* */ |
| #undef T1_CONFIG_OPTION_NO_MM_SUPPORT |
| |
| #endif /* FTOPTION_H */ |
