thirdparty/freetype-2.3.12/src/base/ftsystem.c

   1 /***************************************************************************/
   2 /*                                                                         */
   3 /*  ftsystem.c                                                             */
   4 /*                                                                         */
   5 /*    ANSI-specific FreeType low-level system interface (body).            */
   6 /*                                                                         */
   7 /*  Copyright 1996-2001, 2002, 2006, 2008, 2009 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 #define STREAM_FILE( stream )  ( (FT_FILE*)stream->descriptor.pointer )
 153
 154
 155   /*************************************************************************/
 156   /*                                                                       */
 157   /* <Function>                                                            */
 158   /*    ft_ansi_stream_close                                               */
 159   /*                                                                       */
 160   /* <Description>                                                         */
 161   /*    The function to close a stream.                                    */
 162   /*                                                                       */
 163   /* <Input>                                                               */
 164   /*    stream :: A pointer to the stream object.                          */
 165   /*                                                                       */
 166   FT_CALLBACK_DEF( void )
 167   ft_ansi_stream_close( FT_Stream  stream )
 168   {
 169     ft_fclose( STREAM_FILE( stream ) );
 170
 171     stream->descriptor.pointer = NULL;
 172     stream->size               = 0;
 173     stream->base               = 0;
 174   }
 175
 176
 177   /*************************************************************************/
 178   /*                                                                       */
 179   /* <Function>                                                            */
 180   /*    ft_ansi_stream_io                                                  */
 181   /*                                                                       */
 182   /* <Description>                                                         */
 183   /*    The function to open a stream.                                     */
 184   /*                                                                       */
 185   /* <Input>                                                               */
 186   /*    stream :: A pointer to the stream object.                          */
 187   /*                                                                       */
 188   /*    offset :: The position in the data stream to start reading.        */
 189   /*                                                                       */
 190   /*    buffer :: The address of buffer to store the read data.            */
 191   /*                                                                       */
 192   /*    count  :: The number of bytes to read from the stream.             */
 193   /*                                                                       */
 194   /* <Return>                                                              */
 195   /*    The number of bytes actually read.                                 */
 196   /*                                                                       */
 197   FT_CALLBACK_DEF( unsigned long )
 198   ft_ansi_stream_io( FT_Stream       stream,
 199                      unsigned long   offset,
 200                      unsigned char*  buffer,
 201                      unsigned long   count )
 202   {
 203     FT_FILE*  file;
 204
 205
 206     file = STREAM_FILE( stream );
 207
 208     if ( stream->pos != offset )
 209       ft_fseek( file, offset, SEEK_SET );
 210
 211     return (unsigned long)ft_fread( buffer, 1, count, file );
 212   }
 213
 214
 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     FT_FILE*  file;
 222
 223
 224     if ( !stream )
 225       return FT_Err_Invalid_Stream_Handle;
 226
 227     file = ft_fopen( filepathname, "rb" );
 228     if ( !file )
 229     {
 230       FT_ERROR(( "FT_Stream_Open:"
 231                  " could not open `%s'\n", filepathname ));
 232
 233       return FT_Err_Cannot_Open_Resource;
 234     }
 235
 236     ft_fseek( file, 0, SEEK_END );
 237     stream->size = ft_ftell( file );
 238     ft_fseek( file, 0, SEEK_SET );
 239
 240     stream->descriptor.pointer = file;
 241     stream->pathname.pointer   = (char*)filepathname;
 242     stream->pos                = 0;
 243
 244     stream->read  = ft_ansi_stream_io;
 245     stream->close = ft_ansi_stream_close;
 246
 247     FT_TRACE1(( "FT_Stream_Open:" ));
 248     FT_TRACE1(( " opened `%s' (%d bytes) successfully\n",
 249                 filepathname, stream->size ));
 250
 251     return FT_Err_Ok;
 252   }
 253
 254
 255 #ifdef FT_DEBUG_MEMORY
 256
 257   extern FT_Int
 258   ft_mem_debug_init( FT_Memory  memory );
 259
 260   extern void
 261   ft_mem_debug_done( FT_Memory  memory );
 262
 263 #endif
 264
 265
 266   /* documentation is in ftobjs.h */
 267
 268   FT_BASE_DEF( FT_Memory )
 269   FT_New_Memory( void )
 270   {
 271     FT_Memory  memory;
 272
 273
 274     memory = (FT_Memory)ft_smalloc( sizeof ( *memory ) );
 275     if ( memory )
 276     {
 277       memory->user    = 0;
 278       memory->alloc   = ft_alloc;
 279       memory->realloc = ft_realloc;
 280       memory->free    = ft_free;
 281 #ifdef FT_DEBUG_MEMORY
 282       ft_mem_debug_init( memory );
 283 #endif
 284     }
 285
 286     return memory;
 287   }
 288
 289
 290   /* documentation is in ftobjs.h */
 291
 292   FT_BASE_DEF( void )
 293   FT_Done_Memory( FT_Memory  memory )
 294   {
 295 #ifdef FT_DEBUG_MEMORY
 296     ft_mem_debug_done( memory );
 297 #endif
 298     ft_sfree( memory );
 299   }
 300
 301
 302 /* END */