source: svn/trunk/zasc/freetype-2.3.9/ftsystem.c

Last change on this file was 2, checked in by jglee, 11 years ago

first commit

File size: 13.1 KB
Line 
1/***************************************************************************/
2/*                                                                         */
3/*  ftsystem.c                                                             */
4/*                                                                         */
5/*    ANSI-specific FreeType low-level system interface (body).            */
6/*                                                                         */
7/*  Copyright 1996-2001, 2002, 2006, 2008 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  /* This file contains the default interface used by FreeType to access   */
21  /* low-level, i.e. memory management, i/o access as well as thread       */
22  /* synchronisation.  It can be replaced by user-specific routines if     */
23  /* necessary.                                                            */
24  /*                                                                       */
25  /*************************************************************************/
26
27
28#include <ft2build.h>
29#include FT_CONFIG_CONFIG_H
30#include FT_INTERNAL_DEBUG_H
31#include FT_INTERNAL_STREAM_H
32#include FT_SYSTEM_H
33#include FT_ERRORS_H
34#include FT_TYPES_H
35
36
37  /*************************************************************************/
38  /*                                                                       */
39  /*                       MEMORY MANAGEMENT INTERFACE                     */
40  /*                                                                       */
41  /*************************************************************************/
42
43  /*************************************************************************/
44  /*                                                                       */
45  /* It is not necessary to do any error checking for the                  */
46  /* allocation-related functions.  This will be done by the higher level  */
47  /* routines like ft_mem_alloc() or ft_mem_realloc().                     */
48  /*                                                                       */
49  /*************************************************************************/
50
51
52  /*************************************************************************/
53  /*                                                                       */
54  /* <Function>                                                            */
55  /*    ft_alloc                                                           */
56  /*                                                                       */
57  /* <Description>                                                         */
58  /*    The memory allocation function.                                    */
59  /*                                                                       */
60  /* <Input>                                                               */
61  /*    memory :: A pointer to the memory object.                          */
62  /*                                                                       */
63  /*    size   :: The requested size in bytes.                             */
64  /*                                                                       */
65  /* <Return>                                                              */
66  /*    The address of newly allocated block.                              */
67  /*                                                                       */
68  FT_CALLBACK_DEF( void* )
69  ft_alloc( FT_Memory  memory,
70            long       size )
71  {
72    FT_UNUSED( memory );
73
74    return ft_smalloc( size );
75  }
76
77
78  /*************************************************************************/
79  /*                                                                       */
80  /* <Function>                                                            */
81  /*    ft_realloc                                                         */
82  /*                                                                       */
83  /* <Description>                                                         */
84  /*    The memory reallocation function.                                  */
85  /*                                                                       */
86  /* <Input>                                                               */
87  /*    memory   :: A pointer to the memory object.                        */
88  /*                                                                       */
89  /*    cur_size :: The current size of the allocated memory block.        */
90  /*                                                                       */
91  /*    new_size :: The newly requested size in bytes.                     */
92  /*                                                                       */
93  /*    block    :: The current address of the block in memory.            */
94  /*                                                                       */
95  /* <Return>                                                              */
96  /*    The address of the reallocated memory block.                       */
97  /*                                                                       */
98  FT_CALLBACK_DEF( void* )
99  ft_realloc( FT_Memory  memory,
100              long       cur_size,
101              long       new_size,
102              void*      block )
103  {
104    FT_UNUSED( memory );
105    FT_UNUSED( cur_size );
106
107    return ft_srealloc( block, new_size );
108  }
109
110
111  /*************************************************************************/
112  /*                                                                       */
113  /* <Function>                                                            */
114  /*    ft_free                                                            */
115  /*                                                                       */
116  /* <Description>                                                         */
117  /*    The memory release function.                                       */
118  /*                                                                       */
119  /* <Input>                                                               */
120  /*    memory  :: A pointer to the memory object.                         */
121  /*                                                                       */
122  /*    block   :: The address of block in memory to be freed.             */
123  /*                                                                       */
124  FT_CALLBACK_DEF( void )
125  ft_free( FT_Memory  memory,
126           void*      block )
127  {
128    FT_UNUSED( memory );
129
130    ft_sfree( block );
131  }
132
133
134  /*************************************************************************/
135  /*                                                                       */
136  /*                     RESOURCE MANAGEMENT INTERFACE                     */
137  /*                                                                       */
138  /*************************************************************************/
139
140
141  /*************************************************************************/
142  /*                                                                       */
143  /* The macro FT_COMPONENT is used in trace mode.  It is an implicit      */
144  /* parameter of the FT_TRACE() and FT_ERROR() macros, used to print/log  */
145  /* messages during execution.                                            */
146  /*                                                                       */
147#undef  FT_COMPONENT
148#define FT_COMPONENT  trace_io
149
150  /* We use the macro STREAM_FILE for convenience to extract the       */
151  /* system-specific stream handle from a given FreeType stream object */
152#if DST_SUPPORT_FILE_SYSTEM
153#define STREAM_FILE( stream )  ( (FT_FILE*)stream->descriptor.pointer )
154
155
156  /*************************************************************************/
157  /*                                                                       */
158  /* <Function>                                                            */
159  /*    ft_ansi_stream_close                                               */
160  /*                                                                       */
161  /* <Description>                                                         */
162  /*    The function to close a stream.                                    */
163  /*                                                                       */
164  /* <Input>                                                               */
165  /*    stream :: A pointer to the stream object.                          */
166  /*                                                                       */
167  FT_CALLBACK_DEF( void )
168  ft_ansi_stream_close( FT_Stream  stream )
169  {
170    ft_fclose( STREAM_FILE( stream ) );
171
172    stream->descriptor.pointer = NULL;
173    stream->size               = 0;
174    stream->base               = 0;
175  }
176
177
178  /*************************************************************************/
179  /*                                                                       */
180  /* <Function>                                                            */
181  /*    ft_ansi_stream_io                                                  */
182  /*                                                                       */
183  /* <Description>                                                         */
184  /*    The function to open a stream.                                     */
185  /*                                                                       */
186  /* <Input>                                                               */
187  /*    stream :: A pointer to the stream object.                          */
188  /*                                                                       */
189  /*    offset :: The position in the data stream to start reading.        */
190  /*                                                                       */
191  /*    buffer :: The address of buffer to store the read data.            */
192  /*                                                                       */
193  /*    count  :: The number of bytes to read from the stream.             */
194  /*                                                                       */
195  /* <Return>                                                              */
196  /*    The number of bytes actually read.                                 */
197  /*                                                                       */
198  FT_CALLBACK_DEF( unsigned long )
199  ft_ansi_stream_io( FT_Stream       stream,
200                     unsigned long   offset,
201                     unsigned char*  buffer,
202                     unsigned long   count )
203  {
204    FT_FILE*  file;
205
206
207    file = STREAM_FILE( stream );
208
209    ft_fseek( file, offset, SEEK_SET );
210
211    return (unsigned long)ft_fread( buffer, 1, count, file );
212  }
213
214#endif // DST_SUPPORT_FILE_SYSTEM
215  /* documentation is in ftstream.h */
216
217  FT_BASE_DEF( FT_Error )
218  FT_Stream_Open( FT_Stream    stream,
219                  const char*  filepathname )
220  {
221#if DST_SUPPORT_FILE_SYSTEM
222    FT_FILE*  file;
223
224
225    if ( !stream )
226      return FT_Err_Invalid_Stream_Handle;
227
228    file = ft_fopen( filepathname, "rb" );
229    if ( !file )
230    {
231      FT_ERROR(( "FT_Stream_Open:" ));
232      FT_ERROR(( " could not open `%s'\n", filepathname ));
233
234      return FT_Err_Cannot_Open_Resource;
235    }
236
237    ft_fseek( file, 0, SEEK_END );
238    stream->size = ft_ftell( file );
239    ft_fseek( file, 0, SEEK_SET );
240
241    stream->descriptor.pointer = file;
242    stream->pathname.pointer   = (char*)filepathname;
243    stream->pos                = 0;
244
245    stream->read  = ft_ansi_stream_io;
246    stream->close = ft_ansi_stream_close;
247
248    FT_TRACE1(( "FT_Stream_Open:" ));
249    FT_TRACE1(( " opened `%s' (%d bytes) successfully\n",
250                filepathname, stream->size ));
251#endif // DST_SUPPORT_FILE_SYSTEM
252    return FT_Err_Ok;
253  }
254
255
256#ifdef FT_DEBUG_MEMORY
257
258  extern FT_Int
259  ft_mem_debug_init( FT_Memory  memory );
260
261  extern void
262  ft_mem_debug_done( FT_Memory  memory );
263
264#endif
265
266
267  /* documentation is in ftobjs.h */
268
269  FT_BASE_DEF( FT_Memory )
270  FT_New_Memory( void )
271  {
272    FT_Memory  memory;
273
274
275    memory = (FT_Memory)ft_smalloc( sizeof ( *memory ) );
276    if ( memory )
277    {
278      memory->user    = 0;
279      memory->alloc   = ft_alloc;
280      memory->realloc = ft_realloc;
281      memory->free    = ft_free;
282#ifdef FT_DEBUG_MEMORY
283      ft_mem_debug_init( memory );
284#endif
285    }
286
287    return memory;
288  }
289
290
291  /* documentation is in ftobjs.h */
292
293  FT_BASE_DEF( void )
294  FT_Done_Memory( FT_Memory  memory )
295  {
296#ifdef FT_DEBUG_MEMORY
297    ft_mem_debug_done( memory );
298#endif
299    ft_sfree( memory );
300  }
301
302
303/* END */
Note: See TracBrowser for help on using the repository browser.