2 /* pngmem.c - stub functions for memory allocation
4 * Last changed in libpng 1.2.30 [August 15, 2008]
5 * For conditions of distribution and use, see copyright notice in png.h
6 * Copyright (c) 1998-2008 Glenn Randers-Pehrson
7 * (Version 0.96 Copyright (c) 1996, 1997 Andreas Dilger)
8 * (Version 0.88 Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.)
10 * This file provides a location for all memory allocation. Users who
11 * need special memory handling are expected to supply replacement
12 * functions for png_malloc() and png_free(), and to use
13 * png_create_read_struct_2() and png_create_write_struct_2() to
14 * identify the replacement functions.
19 #if defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED)
21 /* Borland DOS special memory handler */
22 #if defined(__TURBOC__) && !defined(_Windows) && !defined(__FLAT__)
23 /* if you change this, be sure to change the one in png.h also */
25 /* Allocate memory for a png_struct. The malloc and memset can be replaced
26 by a single call to calloc() if this is thought to improve performance. */
27 png_voidp /* PRIVATE */
28 png_create_struct(int type)
30 #ifdef PNG_USER_MEM_SUPPORTED
31 return (png_create_struct_2(type, png_malloc_ptr_NULL, png_voidp_NULL));
34 /* Alternate version of png_create_struct, for use with user-defined malloc. */
35 png_voidp /* PRIVATE */
36 png_create_struct_2(int type, png_malloc_ptr malloc_fn, png_voidp mem_ptr)
38 #endif /* PNG_USER_MEM_SUPPORTED */
42 if (type == PNG_STRUCT_INFO)
43 size = png_sizeof(png_info);
44 else if (type == PNG_STRUCT_PNG)
45 size = png_sizeof(png_struct);
47 return (png_get_copyright(NULL));
49 #ifdef PNG_USER_MEM_SUPPORTED
50 if (malloc_fn != NULL)
52 png_struct dummy_struct;
53 png_structp png_ptr = &dummy_struct;
54 png_ptr->mem_ptr=mem_ptr;
55 struct_ptr = (*(malloc_fn))(png_ptr, (png_uint_32)size);
58 #endif /* PNG_USER_MEM_SUPPORTED */
59 struct_ptr = (png_voidp)farmalloc(size);
60 if (struct_ptr != NULL)
61 png_memset(struct_ptr, 0, size);
65 /* Free memory allocated by a png_create_struct() call */
67 png_destroy_struct(png_voidp struct_ptr)
69 #ifdef PNG_USER_MEM_SUPPORTED
70 png_destroy_struct_2(struct_ptr, png_free_ptr_NULL, png_voidp_NULL);
73 /* Free memory allocated by a png_create_struct() call */
75 png_destroy_struct_2(png_voidp struct_ptr, png_free_ptr free_fn,
79 if (struct_ptr != NULL)
81 #ifdef PNG_USER_MEM_SUPPORTED
84 png_struct dummy_struct;
85 png_structp png_ptr = &dummy_struct;
86 png_ptr->mem_ptr=mem_ptr;
87 (*(free_fn))(png_ptr, struct_ptr);
90 #endif /* PNG_USER_MEM_SUPPORTED */
95 /* Allocate memory. For reasonable files, size should never exceed
96 * 64K. However, zlib may allocate more then 64K if you don't tell
97 * it not to. See zconf.h and png.h for more information. zlib does
98 * need to allocate exactly 64K, so whatever you call here must
99 * have the ability to do that.
101 * Borland seems to have a problem in DOS mode for exactly 64K.
102 * It gives you a segment with an offset of 8 (perhaps to store its
103 * memory stuff). zlib doesn't like this at all, so we have to
104 * detect and deal with it. This code should not be needed in
105 * Windows or OS/2 modes, and only in 16 bit mode. This code has
106 * been updated by Alexander Lehmann for version 0.89 to waste less
109 * Note that we can't use png_size_t for the "size" declaration,
110 * since on some systems a png_size_t is a 16-bit quantity, and as a
111 * result, we would be truncating potentially larger memory requests
112 * (which should cause a fatal error) and introducing major problems.
116 png_malloc(png_structp png_ptr, png_uint_32 size)
120 if (png_ptr == NULL || size == 0)
123 #ifdef PNG_USER_MEM_SUPPORTED
124 if (png_ptr->malloc_fn != NULL)
125 ret = ((png_voidp)(*(png_ptr->malloc_fn))(png_ptr, (png_size_t)size));
127 ret = (png_malloc_default(png_ptr, size));
128 if (ret == NULL && (png_ptr->flags&PNG_FLAG_MALLOC_NULL_MEM_OK) == 0)
129 png_error(png_ptr, "Out of memory!");
134 png_malloc_default(png_structp png_ptr, png_uint_32 size)
137 #endif /* PNG_USER_MEM_SUPPORTED */
139 if (png_ptr == NULL || size == 0)
142 #ifdef PNG_MAX_MALLOC_64K
143 if (size > (png_uint_32)65536L)
145 png_warning(png_ptr, "Cannot Allocate > 64K");
151 if (size != (size_t)size)
153 else if (size == (png_uint_32)65536L)
155 if (png_ptr->offset_table == NULL)
157 /* try to see if we need to do any of this fancy stuff */
158 ret = farmalloc(size);
159 if (ret == NULL || ((png_size_t)ret & 0xffff))
162 png_uint_32 total_size;
165 png_byte huge * hptr;
173 if (png_ptr->zlib_window_bits > 14)
174 num_blocks = (int)(1 << (png_ptr->zlib_window_bits - 14));
177 if (png_ptr->zlib_mem_level >= 7)
178 num_blocks += (int)(1 << (png_ptr->zlib_mem_level - 7));
182 total_size = ((png_uint_32)65536L) * (png_uint_32)num_blocks+16;
184 table = farmalloc(total_size);
188 #ifndef PNG_USER_MEM_SUPPORTED
189 if ((png_ptr->flags&PNG_FLAG_MALLOC_NULL_MEM_OK) == 0)
190 png_error(png_ptr, "Out Of Memory."); /* Note "O" and "M" */
192 png_warning(png_ptr, "Out Of Memory.");
197 if ((png_size_t)table & 0xfff0)
199 #ifndef PNG_USER_MEM_SUPPORTED
200 if ((png_ptr->flags&PNG_FLAG_MALLOC_NULL_MEM_OK) == 0)
202 "Farmalloc didn't return normalized pointer");
205 "Farmalloc didn't return normalized pointer");
210 png_ptr->offset_table = table;
211 png_ptr->offset_table_ptr = farmalloc(num_blocks *
212 png_sizeof(png_bytep));
214 if (png_ptr->offset_table_ptr == NULL)
216 #ifndef PNG_USER_MEM_SUPPORTED
217 if ((png_ptr->flags&PNG_FLAG_MALLOC_NULL_MEM_OK) == 0)
218 png_error(png_ptr, "Out Of memory."); /* Note "O" and "M" */
220 png_warning(png_ptr, "Out Of memory.");
225 hptr = (png_byte huge *)table;
226 if ((png_size_t)hptr & 0xf)
228 hptr = (png_byte huge *)((long)(hptr) & 0xfffffff0L);
229 hptr = hptr + 16L; /* "hptr += 16L" fails on Turbo C++ 3.0 */
231 for (i = 0; i < num_blocks; i++)
233 png_ptr->offset_table_ptr[i] = (png_bytep)hptr;
234 hptr = hptr + (png_uint_32)65536L; /* "+=" fails on TC++3.0 */
237 png_ptr->offset_table_number = num_blocks;
238 png_ptr->offset_table_count = 0;
239 png_ptr->offset_table_count_free = 0;
243 if (png_ptr->offset_table_count >= png_ptr->offset_table_number)
245 #ifndef PNG_USER_MEM_SUPPORTED
246 if ((png_ptr->flags&PNG_FLAG_MALLOC_NULL_MEM_OK) == 0)
247 png_error(png_ptr, "Out of Memory."); /* Note "o" and "M" */
249 png_warning(png_ptr, "Out of Memory.");
254 ret = png_ptr->offset_table_ptr[png_ptr->offset_table_count++];
257 ret = farmalloc(size);
259 #ifndef PNG_USER_MEM_SUPPORTED
262 if ((png_ptr->flags&PNG_FLAG_MALLOC_NULL_MEM_OK) == 0)
263 png_error(png_ptr, "Out of memory."); /* Note "o" and "m" */
265 png_warning(png_ptr, "Out of memory."); /* Note "o" and "m" */
272 /* free a pointer allocated by png_malloc(). In the default
273 configuration, png_ptr is not used, but is passed in case it
274 is needed. If ptr is NULL, return without taking any action. */
277 png_free(png_structp png_ptr, png_voidp ptr)
279 if (png_ptr == NULL || ptr == NULL)
282 #ifdef PNG_USER_MEM_SUPPORTED
283 if (png_ptr->free_fn != NULL)
285 (*(png_ptr->free_fn))(png_ptr, ptr);
288 else png_free_default(png_ptr, ptr);
292 png_free_default(png_structp png_ptr, png_voidp ptr)
294 #endif /* PNG_USER_MEM_SUPPORTED */
296 if (png_ptr == NULL || ptr == NULL) return;
298 if (png_ptr->offset_table != NULL)
302 for (i = 0; i < png_ptr->offset_table_count; i++)
304 if (ptr == png_ptr->offset_table_ptr[i])
307 png_ptr->offset_table_count_free++;
311 if (png_ptr->offset_table_count_free == png_ptr->offset_table_count)
313 farfree(png_ptr->offset_table);
314 farfree(png_ptr->offset_table_ptr);
315 png_ptr->offset_table = NULL;
316 png_ptr->offset_table_ptr = NULL;
326 #else /* Not the Borland DOS special memory handler */
328 /* Allocate memory for a png_struct or a png_info. The malloc and
329 memset can be replaced by a single call to calloc() if this is thought
330 to improve performance noticably. */
331 png_voidp /* PRIVATE */
332 png_create_struct(int type)
334 #ifdef PNG_USER_MEM_SUPPORTED
335 return (png_create_struct_2(type, png_malloc_ptr_NULL, png_voidp_NULL));
338 /* Allocate memory for a png_struct or a png_info. The malloc and
339 memset can be replaced by a single call to calloc() if this is thought
340 to improve performance noticably. */
341 png_voidp /* PRIVATE */
342 png_create_struct_2(int type, png_malloc_ptr malloc_fn, png_voidp mem_ptr)
344 #endif /* PNG_USER_MEM_SUPPORTED */
346 png_voidp struct_ptr;
348 if (type == PNG_STRUCT_INFO)
349 size = png_sizeof(png_info);
350 else if (type == PNG_STRUCT_PNG)
351 size = png_sizeof(png_struct);
355 #ifdef PNG_USER_MEM_SUPPORTED
356 if (malloc_fn != NULL)
358 png_struct dummy_struct;
359 png_structp png_ptr = &dummy_struct;
360 png_ptr->mem_ptr=mem_ptr;
361 struct_ptr = (*(malloc_fn))(png_ptr, size);
362 if (struct_ptr != NULL)
363 png_memset(struct_ptr, 0, size);
366 #endif /* PNG_USER_MEM_SUPPORTED */
368 #if defined(__TURBOC__) && !defined(__FLAT__)
369 struct_ptr = (png_voidp)farmalloc(size);
371 # if defined(_MSC_VER) && defined(MAXSEG_64K)
372 struct_ptr = (png_voidp)halloc(size, 1);
374 struct_ptr = (png_voidp)malloc(size);
377 if (struct_ptr != NULL)
378 png_memset(struct_ptr, 0, size);
384 /* Free memory allocated by a png_create_struct() call */
386 png_destroy_struct(png_voidp struct_ptr)
388 #ifdef PNG_USER_MEM_SUPPORTED
389 png_destroy_struct_2(struct_ptr, png_free_ptr_NULL, png_voidp_NULL);
392 /* Free memory allocated by a png_create_struct() call */
394 png_destroy_struct_2(png_voidp struct_ptr, png_free_ptr free_fn,
397 #endif /* PNG_USER_MEM_SUPPORTED */
398 if (struct_ptr != NULL)
400 #ifdef PNG_USER_MEM_SUPPORTED
403 png_struct dummy_struct;
404 png_structp png_ptr = &dummy_struct;
405 png_ptr->mem_ptr=mem_ptr;
406 (*(free_fn))(png_ptr, struct_ptr);
409 #endif /* PNG_USER_MEM_SUPPORTED */
410 #if defined(__TURBOC__) && !defined(__FLAT__)
413 # if defined(_MSC_VER) && defined(MAXSEG_64K)
422 /* Allocate memory. For reasonable files, size should never exceed
423 64K. However, zlib may allocate more then 64K if you don't tell
424 it not to. See zconf.h and png.h for more information. zlib does
425 need to allocate exactly 64K, so whatever you call here must
426 have the ability to do that. */
429 png_malloc(png_structp png_ptr, png_uint_32 size)
433 #ifdef PNG_USER_MEM_SUPPORTED
434 if (png_ptr == NULL || size == 0)
437 if (png_ptr->malloc_fn != NULL)
438 ret = ((png_voidp)(*(png_ptr->malloc_fn))(png_ptr, (png_size_t)size));
440 ret = (png_malloc_default(png_ptr, size));
441 if (ret == NULL && (png_ptr->flags&PNG_FLAG_MALLOC_NULL_MEM_OK) == 0)
442 png_error(png_ptr, "Out of Memory!");
447 png_malloc_default(png_structp png_ptr, png_uint_32 size)
450 #endif /* PNG_USER_MEM_SUPPORTED */
452 if (png_ptr == NULL || size == 0)
455 #ifdef PNG_MAX_MALLOC_64K
456 if (size > (png_uint_32)65536L)
458 #ifndef PNG_USER_MEM_SUPPORTED
459 if ((png_ptr->flags&PNG_FLAG_MALLOC_NULL_MEM_OK) == 0)
460 png_error(png_ptr, "Cannot Allocate > 64K");
467 /* Check for overflow */
468 #if defined(__TURBOC__) && !defined(__FLAT__)
469 if (size != (unsigned long)size)
472 ret = farmalloc(size);
474 # if defined(_MSC_VER) && defined(MAXSEG_64K)
475 if (size != (unsigned long)size)
478 ret = halloc(size, 1);
480 if (size != (size_t)size)
483 ret = malloc((size_t)size);
487 #ifndef PNG_USER_MEM_SUPPORTED
488 if (ret == NULL && (png_ptr->flags&PNG_FLAG_MALLOC_NULL_MEM_OK) == 0)
489 png_error(png_ptr, "Out of Memory");
495 /* Free a pointer allocated by png_malloc(). If ptr is NULL, return
496 without taking any action. */
498 png_free(png_structp png_ptr, png_voidp ptr)
500 if (png_ptr == NULL || ptr == NULL)
503 #ifdef PNG_USER_MEM_SUPPORTED
504 if (png_ptr->free_fn != NULL)
506 (*(png_ptr->free_fn))(png_ptr, ptr);
509 else png_free_default(png_ptr, ptr);
512 png_free_default(png_structp png_ptr, png_voidp ptr)
514 if (png_ptr == NULL || ptr == NULL)
517 #endif /* PNG_USER_MEM_SUPPORTED */
519 #if defined(__TURBOC__) && !defined(__FLAT__)
522 # if defined(_MSC_VER) && defined(MAXSEG_64K)
530 #endif /* Not Borland DOS special memory handler */
532 #if defined(PNG_1_0_X)
533 # define png_malloc_warn png_malloc
535 /* This function was added at libpng version 1.2.3. The png_malloc_warn()
536 * function will set up png_malloc() to issue a png_warning and return NULL
537 * instead of issuing a png_error, if it fails to allocate the requested
541 png_malloc_warn(png_structp png_ptr, png_uint_32 size)
544 png_uint_32 save_flags;
545 if (png_ptr == NULL) return (NULL);
547 save_flags = png_ptr->flags;
548 png_ptr->flags|=PNG_FLAG_MALLOC_NULL_MEM_OK;
549 ptr = (png_voidp)png_malloc((png_structp)png_ptr, size);
550 png_ptr->flags=save_flags;
556 png_memcpy_check (png_structp png_ptr, png_voidp s1, png_voidp s2,
561 size = (png_size_t)length;
562 if ((png_uint_32)size != length)
563 png_error(png_ptr, "Overflow in png_memcpy_check.");
565 return(png_memcpy (s1, s2, size));
569 png_memset_check (png_structp png_ptr, png_voidp s1, int value,
574 size = (png_size_t)length;
575 if ((png_uint_32)size != length)
576 png_error(png_ptr, "Overflow in png_memset_check.");
578 return (png_memset (s1, value, size));
582 #ifdef PNG_USER_MEM_SUPPORTED
583 /* This function is called when the application wants to use another method
584 * of allocating and freeing memory.
587 png_set_mem_fn(png_structp png_ptr, png_voidp mem_ptr, png_malloc_ptr
588 malloc_fn, png_free_ptr free_fn)
592 png_ptr->mem_ptr = mem_ptr;
593 png_ptr->malloc_fn = malloc_fn;
594 png_ptr->free_fn = free_fn;
598 /* This function returns a pointer to the mem_ptr associated with the user
599 * functions. The application should free any memory associated with this
600 * pointer before png_write_destroy and png_read_destroy are called.
603 png_get_mem_ptr(png_structp png_ptr)
605 if (png_ptr == NULL) return (NULL);
606 return ((png_voidp)png_ptr->mem_ptr);
608 #endif /* PNG_USER_MEM_SUPPORTED */
609 #endif /* PNG_READ_SUPPORTED || PNG_WRITE_SUPPORTED */