2 /* pngrio.c - functions for data input
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 input. Users who need
11 * special handling are expected to write a function that has the same
12 * arguments as this and performs a similar function, but that possibly
13 * has a different input method. Note that you shouldn't change this
14 * function, but rather write a replacement function and then make
15 * libpng use it at run time with png_set_read_fn(...).
20 #if defined(PNG_READ_SUPPORTED)
22 /* Read the data from whatever input you are using. The default routine
23 reads from a file pointer. Note that this routine sometimes gets called
24 with very small lengths, so you should implement some kind of simple
25 buffering if you are using unbuffered reads. This should never be asked
26 to read more then 64K on a 16 bit machine. */
28 png_read_data(png_structp png_ptr, png_bytep data, png_size_t length)
30 png_debug1(4, "reading %d bytes\n", (int)length);
31 if (png_ptr->read_data_fn != NULL)
32 (*(png_ptr->read_data_fn))(png_ptr, data, length);
34 png_error(png_ptr, "Call to NULL read function");
37 #if !defined(PNG_NO_STDIO)
38 /* This is the function that does the actual reading of data. If you are
39 not reading from a standard C stream, you should create a replacement
40 read_data function and use it at run time with png_set_read_fn(), rather
41 than changing the library. */
42 #ifndef USE_FAR_KEYWORD
44 png_default_read_data(png_structp png_ptr, png_bytep data, png_size_t length)
48 if (png_ptr == NULL) return;
49 /* fread() returns 0 on error, so it is OK to store this in a png_size_t
50 * instead of an int, which is what fread() actually returns.
52 #if defined(_WIN32_WCE)
53 if ( !ReadFile((HANDLE)(png_ptr->io_ptr), data, length, &check, NULL) )
56 check = (png_size_t)fread(data, (png_size_t)1, length,
57 (png_FILE_p)png_ptr->io_ptr);
61 png_error(png_ptr, "Read Error");
64 /* this is the model-independent version. Since the standard I/O library
65 can't handle far buffers in the medium and small models, we have to copy
69 #define NEAR_BUF_SIZE 1024
70 #define MIN(a,b) (a <= b ? a : b)
73 png_default_read_data(png_structp png_ptr, png_bytep data, png_size_t length)
79 if (png_ptr == NULL) return;
80 /* Check if data really is near. If so, use usual code. */
81 n_data = (png_byte *)CVT_PTR_NOCHECK(data);
82 io_ptr = (png_FILE_p)CVT_PTR(png_ptr->io_ptr);
83 if ((png_bytep)n_data == data)
85 #if defined(_WIN32_WCE)
86 if ( !ReadFile((HANDLE)(png_ptr->io_ptr), data, length, &check, NULL) )
89 check = fread(n_data, 1, length, io_ptr);
94 png_byte buf[NEAR_BUF_SIZE];
95 png_size_t read, remaining, err;
100 read = MIN(NEAR_BUF_SIZE, remaining);
101 #if defined(_WIN32_WCE)
102 if ( !ReadFile((HANDLE)(io_ptr), buf, read, &err, NULL) )
105 err = fread(buf, (png_size_t)1, read, io_ptr);
107 png_memcpy(data, buf, read); /* copy far buffer to near buffer */
115 while (remaining != 0);
117 if ((png_uint_32)check != (png_uint_32)length)
118 png_error(png_ptr, "read Error");
123 /* This function allows the application to supply a new input function
124 for libpng if standard C streams aren't being used.
126 This function takes as its arguments:
127 png_ptr - pointer to a png input data structure
128 io_ptr - pointer to user supplied structure containing info about
129 the input functions. May be NULL.
130 read_data_fn - pointer to a new input function that takes as its
131 arguments a pointer to a png_struct, a pointer to
132 a location where input data can be stored, and a 32-bit
133 unsigned int that is the number of bytes to be read.
134 To exit and output any fatal error messages the new write
135 function should call png_error(png_ptr, "Error msg"). */
137 png_set_read_fn(png_structp png_ptr, png_voidp io_ptr,
138 png_rw_ptr read_data_fn)
140 if (png_ptr == NULL) return;
141 png_ptr->io_ptr = io_ptr;
143 #if !defined(PNG_NO_STDIO)
144 if (read_data_fn != NULL)
145 png_ptr->read_data_fn = read_data_fn;
147 png_ptr->read_data_fn = png_default_read_data;
149 png_ptr->read_data_fn = read_data_fn;
152 /* It is an error to write to a read device */
153 if (png_ptr->write_data_fn != NULL)
155 png_ptr->write_data_fn = NULL;
157 "It's an error to set both read_data_fn and write_data_fn in the ");
159 "same structure. Resetting write_data_fn to NULL.");
162 #if defined(PNG_WRITE_FLUSH_SUPPORTED)
163 png_ptr->output_flush_fn = NULL;
166 #endif /* PNG_READ_SUPPORTED */