Home | History | Annotate | Download | only in jpeg 
      1 /*
      2  * jmemansi.c
      3  *
      4  * Copyright (C) 1992-1996, Thomas G. Lane.
      5  * This file is part of the Independent JPEG Group's software.
      6  * For conditions of distribution and use, see the accompanying README file.
      7  *
      8  * This file provides a simple generic implementation of the system-
      9  * dependent portion of the JPEG memory manager.  This implementation
     10  * assumes that you have the ANSI-standard library routine tmpfile().
     11  * Also, the problem of determining the amount of memory available
     12  * is shoved onto the user.
     13  */
     14 
     15 #define JPEG_INTERNALS
     16 #include "jinclude.h"
     17 #include "jpeglib.h"
     18 #include "jmemsys.h"		/* import the system-dependent declarations */
     19 
     20 #ifndef HAVE_STDLIB_H		/* <stdlib.h> should declare malloc(),free() */
     21 extern void * malloc JPP((size_t size));
     22 extern void free JPP((void *ptr));
     23 #endif
     24 
     25 #ifndef SEEK_SET		/* pre-ANSI systems may not define this; */
     26 #define SEEK_SET  0		/* if not, assume 0 is correct */
     27 #endif
     28 
     29 
     30 /*
     31  * Memory allocation and freeing are controlled by the regular library
     32  * routines malloc() and free().
     33  */
     34 
     35 GLOBAL(void *)
     36 jpeg_get_small (j_common_ptr cinfo, size_t sizeofobject)
     37 {
     38   return (void *) malloc(sizeofobject);
     39 }
     40 
     41 GLOBAL(void)
     42 jpeg_free_small (j_common_ptr cinfo, void * object, size_t sizeofobject)
     43 {
     44   free(object);
     45 }
     46 
     47 
     48 /*
     49  * "Large" objects are treated the same as "small" ones.
     50  * NB: although we include FAR keywords in the routine declarations,
     51  * this file won't actually work in 80x86 small/medium model; at least,
     52  * you probably won't be able to process useful-size images in only 64KB.
     53  */
     54 
     55 GLOBAL(void FAR *)
     56 jpeg_get_large (j_common_ptr cinfo, size_t sizeofobject)
     57 {
     58   return (void FAR *) malloc(sizeofobject);
     59 }
     60 
     61 GLOBAL(void)
     62 jpeg_free_large (j_common_ptr cinfo, void FAR * object, size_t sizeofobject)
     63 {
     64   free(object);
     65 }
     66 
     67 
     68 /*
     69  * This routine computes the total memory space available for allocation.
     70  * It's impossible to do this in a portable way; our current solution is
     71  * to make the user tell us (with a default value set at compile time).
     72  * If you can actually get the available space, it's a good idea to subtract
     73  * a slop factor of 5% or so.
     74  */
     75 
     76 #ifndef DEFAULT_MAX_MEM		/* so can override from makefile */
     77 #define DEFAULT_MAX_MEM		1000000L /* default: one megabyte */
     78 #endif
     79 
     80 GLOBAL(long)
     81 jpeg_mem_available (j_common_ptr cinfo, long min_bytes_needed,
     82 		    long max_bytes_needed, long already_allocated)
     83 {
     84   return cinfo->mem->max_memory_to_use - already_allocated;
     85 }
     86 
     87 
     88 /*
     89  * Backing store (temporary file) management.
     90  * Backing store objects are only used when the value returned by
     91  * jpeg_mem_available is less than the total space needed.  You can dispense
     92  * with these routines if you have plenty of virtual memory; see jmemnobs.c.
     93  */
     94 
     95 
     96 METHODDEF(void)
     97 read_backing_store (j_common_ptr cinfo, backing_store_ptr info,
     98 		    void FAR * buffer_address,
     99 		    long file_offset, long byte_count)
    100 {
    101   if (fseek(info->temp_file, file_offset, SEEK_SET))
    102     ERREXIT(cinfo, JERR_TFILE_SEEK);
    103   if (JFREAD(info->temp_file, buffer_address, byte_count)
    104       != (size_t) byte_count)
    105     ERREXIT(cinfo, JERR_TFILE_READ);
    106 }
    107 
    108 
    109 METHODDEF(void)
    110 write_backing_store (j_common_ptr cinfo, backing_store_ptr info,
    111 		     void FAR * buffer_address,
    112 		     long file_offset, long byte_count)
    113 {
    114   if (fseek(info->temp_file, file_offset, SEEK_SET))
    115     ERREXIT(cinfo, JERR_TFILE_SEEK);
    116   if (JFWRITE(info->temp_file, buffer_address, byte_count)
    117       != (size_t) byte_count)
    118     ERREXIT(cinfo, JERR_TFILE_WRITE);
    119 }
    120 
    121 
    122 METHODDEF(void)
    123 close_backing_store (j_common_ptr cinfo, backing_store_ptr info)
    124 {
    125   fclose(info->temp_file);
    126   /* Since this implementation uses tmpfile() to create the file,
    127    * no explicit file deletion is needed.
    128    */
    129 }
    130 
    131 
    132 /*
    133  * Initial opening of a backing-store object.
    134  *
    135  * This version uses tmpfile(), which constructs a suitable file name
    136  * behind the scenes.  We don't have to use info->temp_name[] at all;
    137  * indeed, we can't even find out the actual name of the temp file.
    138  */
    139 
    140 GLOBAL(void)
    141 jpeg_open_backing_store (j_common_ptr cinfo, backing_store_ptr info,
    142 			 long total_bytes_needed)
    143 {
    144   if ((info->temp_file = tmpfile()) == NULL)
    145     ERREXITS(cinfo, JERR_TFILE_CREATE, "");
    146   info->read_backing_store = read_backing_store;
    147   info->write_backing_store = write_backing_store;
    148   info->close_backing_store = close_backing_store;
    149 }
    150 
    151 
    152 /*
    153  * These routines take care of any system-dependent initialization and
    154  * cleanup required.
    155  */
    156 
    157 GLOBAL(long)
    158 jpeg_mem_init (j_common_ptr cinfo)
    159 {
    160   return DEFAULT_MAX_MEM;	/* default for max_memory_to_use */
    161 }
    162 
    163 GLOBAL(void)
    164 jpeg_mem_term (j_common_ptr cinfo)
    165 {
    166   /* no work */
    167 }
    168