1 /***************************************************************************/
2 /* */
3 /* ftinit.c */
4 /* */
5 /* FreeType initialization layer (body). */
6 /* */
7 /* Copyright 1996-2001 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 /***************************************************************************/
18 /*************************************************************************/
19 /* */
20 /* The purpose of this file is to implement the following two */
21 /* functions: */
22 /* */
23 /* FT_Add_Default_Modules(): */
24 /* This function is used to add the set of default modules to a */
25 /* fresh new library object. The set is taken from the header file */
26 /* `freetype/config/ftmodule.h'. See the document `FreeType 2.0 */
27 /* Build System' for more information. */
28 /* */
29 /* FT_Init_FreeType(): */
30 /* This function creates a system object for the current platform, */
31 /* builds a library out of it, then calls FT_Default_Drivers(). */
32 /* */
33 /* Note that even if FT_Init_FreeType() uses the implementation of the */
34 /* system object defined at build time, client applications are still */
35 /* able to provide their own `ftsystem.c'. */
36 /* */
37 /*************************************************************************/
40 #include <ft2build.h>
41 #include FT_CONFIG_CONFIG_H
42 #include FT_INTERNAL_OBJECTS_H
43 #include FT_INTERNAL_DEBUG_H
44 #include FT_MODULE_H
47 /*************************************************************************/
48 /* */
49 /* The macro FT_COMPONENT is used in trace mode. It is an implicit */
50 /* parameter of the FT_TRACE() and FT_ERROR() macros, used to print/log */
51 /* messages during execution. */
52 /* */
53 #undef FT_COMPONENT
54 #define FT_COMPONENT trace_init
56 #undef FT_USE_MODULE
57 #ifdef __cplusplus
58 #define FT_USE_MODULE( x ) extern "C" const FT_Module_Class* x;
59 #else
60 #define FT_USE_MODULE( x ) extern const FT_Module_Class* x;
61 #endif
64 #include FT_CONFIG_MODULES_H
67 #undef FT_USE_MODULE
68 #define FT_USE_MODULE( x ) (const FT_Module_Class*)&x,
70 static
71 const FT_Module_Class* const ft_default_modules[] =
72 {
73 #include FT_CONFIG_MODULES_H
74 0
75 };
78 /* documentation is in ftmodule.h */
80 FT_EXPORT_DEF( void )
81 FT_Add_Default_Modules( FT_Library library )
82 {
83 FT_Error error;
84 const FT_Module_Class* const* cur;
87 /* test for valid `library' delayed to FT_Add_Module() */
89 cur = ft_default_modules;
90 while ( *cur )
91 {
92 error = FT_Add_Module( library, *cur );
93 /* notify errors, but don't stop */
94 if ( error )
95 {
96 FT_ERROR(( "FT_Add_Default_Module: Cannot install `%s', error = %x\n",
97 (*cur)->module_name, error ));
98 }
99 cur++;
100 }
101 }
104 /* documentation is in freetype.h */
106 FT_EXPORT_DEF( FT_Error )
107 FT_Init_FreeType( FT_Library *alibrary )
108 {
109 FT_Error error;
110 FT_Memory memory;
113 /* First of all, allocate a new system object -- this function is part */
114 /* of the system-specific component, i.e. `ftsystem.c'. */
116 memory = FT_New_Memory();
117 if ( !memory )
118 {
119 FT_ERROR(( "FT_Init_FreeType: cannot find memory manager\n" ));
120 return FT_Err_Unimplemented_Feature;
121 }
123 /* build a library out of it, then fill it with the set of */
124 /* default drivers. */
126 error = FT_New_Library( memory, alibrary );
127 if ( !error )
128 FT_Add_Default_Modules( *alibrary );
130 return error;
131 }
134 /* documentation is in freetype.h */
136 FT_EXPORT_DEF( FT_Error )
137 FT_Done_FreeType( FT_Library library )
138 {
139 if ( library )
140 {
141 FT_Memory memory = library->memory;
144 /* Discard the library object */
145 FT_Done_Library( library );
147 /* discard memory manager */
148 FT_Done_Memory( memory );
149 }
151 return FT_Err_Ok;
152 }
155 /* END */