2
/* pngwio.c - functions for data output
4
* libpng 1.2.7 - September 12, 2004
5
* For conditions of distribution and use, see copyright notice in png.h
6
* Copyright (c) 1998-2004 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 output. Users who need
11
* special handling are expected to write functions that have the same
12
* arguments as these and perform similar functions, but that possibly
13
* use different output methods. Note that you shouldn't change these
14
* functions, but rather write replacement functions and then change
15
* them at run time with png_set_write_fn(...).
20
#ifdef PNG_WRITE_SUPPORTED
22
/* Write the data to whatever output you are using. The default routine
23
writes to 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 writes. This should never be asked
26
to write more than 64K on a 16 bit machine. */
29
png_write_data(png_structp png_ptr, png_bytep data, png_size_t length)
31
if (png_ptr->write_data_fn != NULL )
32
(*(png_ptr->write_data_fn))(png_ptr, data, length);
34
png_error(png_ptr, "Call to NULL write function");
37
#if !defined(PNG_NO_STDIO)
38
/* This is the function that does the actual writing of data. If you are
39
not writing to a standard C stream, you should create a replacement
40
write_data function and use it at run time with png_set_write_fn(), rather
41
than changing the library. */
42
#ifndef USE_FAR_KEYWORD
44
png_default_write_data(png_structp png_ptr, png_bytep data, png_size_t length)
48
#if defined(_WIN32_WCE)
49
if ( !WriteFile((HANDLE)(png_ptr->io_ptr), data, length, &check, NULL) )
52
check = fwrite(data, 1, length, (png_FILE_p)(png_ptr->io_ptr));
55
png_error(png_ptr, "Write Error");
58
/* this is the model-independent version. Since the standard I/O library
59
can't handle far buffers in the medium and small models, we have to copy
63
#define NEAR_BUF_SIZE 1024
64
#define MIN(a,b) (a <= b ? a : b)
67
png_default_write_data(png_structp png_ptr, png_bytep data, png_size_t length)
70
png_byte *near_data; /* Needs to be "png_byte *" instead of "png_bytep" */
73
/* Check if data really is near. If so, use usual code. */
74
near_data = (png_byte *)CVT_PTR_NOCHECK(data);
75
io_ptr = (png_FILE_p)CVT_PTR(png_ptr->io_ptr);
76
if ((png_bytep)near_data == data)
78
#if defined(_WIN32_WCE)
79
if ( !WriteFile(io_ptr, near_data, length, &check, NULL) )
82
check = fwrite(near_data, 1, length, io_ptr);
87
png_byte buf[NEAR_BUF_SIZE];
88
png_size_t written, remaining, err;
93
written = MIN(NEAR_BUF_SIZE, remaining);
94
png_memcpy(buf, data, written); /* copy far buffer to near buffer */
95
#if defined(_WIN32_WCE)
96
if ( !WriteFile(io_ptr, buf, written, &err, NULL) )
99
err = fwrite(buf, 1, written, io_ptr);
106
remaining -= written;
108
while (remaining != 0);
111
png_error(png_ptr, "Write Error");
117
/* This function is called to output any data pending writing (normally
118
to disk). After png_flush is called, there should be no data pending
119
writing in any buffers. */
120
#if defined(PNG_WRITE_FLUSH_SUPPORTED)
122
png_flush(png_structp png_ptr)
124
if (png_ptr->output_flush_fn != NULL)
125
(*(png_ptr->output_flush_fn))(png_ptr);
128
#if !defined(PNG_NO_STDIO)
130
png_default_flush(png_structp png_ptr)
132
#if !defined(_WIN32_WCE)
134
io_ptr = (png_FILE_p)CVT_PTR((png_ptr->io_ptr));
142
/* This function allows the application to supply new output functions for
143
libpng if standard C streams aren't being used.
145
This function takes as its arguments:
146
png_ptr - pointer to a png output data structure
147
io_ptr - pointer to user supplied structure containing info about
148
the output functions. May be NULL.
149
write_data_fn - pointer to a new output function that takes as its
150
arguments a pointer to a png_struct, a pointer to
151
data to be written, and a 32-bit unsigned int that is
152
the number of bytes to be written. The new write
153
function should call png_error(png_ptr, "Error msg")
154
to exit and output any fatal error messages.
155
flush_data_fn - pointer to a new flush function that takes as its
156
arguments a pointer to a png_struct. After a call to
157
the flush function, there should be no data in any buffers
158
or pending transmission. If the output method doesn't do
159
any buffering of ouput, a function prototype must still be
160
supplied although it doesn't have to do anything. If
161
PNG_WRITE_FLUSH_SUPPORTED is not defined at libpng compile
162
time, output_flush_fn will be ignored, although it must be
163
supplied for compatibility. */
165
png_set_write_fn(png_structp png_ptr, png_voidp io_ptr,
166
png_rw_ptr write_data_fn, png_flush_ptr output_flush_fn)
168
png_ptr->io_ptr = io_ptr;
170
#if !defined(PNG_NO_STDIO)
171
if (write_data_fn != NULL)
172
png_ptr->write_data_fn = write_data_fn;
174
png_ptr->write_data_fn = png_default_write_data;
176
png_ptr->write_data_fn = write_data_fn;
179
#if defined(PNG_WRITE_FLUSH_SUPPORTED)
180
#if !defined(PNG_NO_STDIO)
181
if (output_flush_fn != NULL)
182
png_ptr->output_flush_fn = output_flush_fn;
184
png_ptr->output_flush_fn = png_default_flush;
186
png_ptr->output_flush_fn = output_flush_fn;
188
#endif /* PNG_WRITE_FLUSH_SUPPORTED */
190
/* It is an error to read while writing a png file */
191
if (png_ptr->read_data_fn != NULL)
193
png_ptr->read_data_fn = NULL;
195
"Attempted to set both read_data_fn and write_data_fn in");
197
"the same structure. Resetting read_data_fn to NULL.");
201
#if defined(USE_FAR_KEYWORD)
202
#if defined(_MSC_VER)
203
void *png_far_to_near(png_structp png_ptr,png_voidp ptr, int check)
207
FP_OFF(near_ptr) = FP_OFF(ptr);
208
far_ptr = (void FAR *)near_ptr;
210
if(FP_SEG(ptr) != FP_SEG(far_ptr))
211
png_error(png_ptr,"segment lost in conversion");
215
void *png_far_to_near(png_structp png_ptr,png_voidp ptr, int check)
219
near_ptr = (void FAR *)ptr;
220
far_ptr = (void FAR *)near_ptr;
223
png_error(png_ptr,"segment lost in conversion");
228
#endif /* PNG_WRITE_SUPPORTED */