blob: 917c38f217f70374f6c23149461b5a78d8800661 [file] [log] [blame]
Guy Schalnate5a37791996-06-05 15:50:50 -05001
2/* pngwio.c - functions for data output
Glenn Randers-Pehrsonb6ce43d1998-01-01 07:13:13 -06003 *
Glenn Randers-Pehrson8686fff1998-05-21 09:27:50 -05004 * libpng 1.0.1d
Glenn Randers-Pehrsonb6ce43d1998-01-01 07:13:13 -06005 * For conditions of distribution and use, see copyright notice in png.h
6 * Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.
7 * Copyright (c) 1996, 1997 Andreas Dilger
Glenn Randers-Pehrson2687fcc1998-01-07 20:54:20 -06008 * Copyright (c) 1998, Glenn Randers-Pehrson
Glenn Randers-Pehrson8686fff1998-05-21 09:27:50 -05009 * May 21, 1998
Glenn Randers-Pehrsonb6ce43d1998-01-01 07:13:13 -060010 *
Glenn Randers-Pehrson8686fff1998-05-21 09:27:50 -050011 * This file provides a location for all output. Users who need
12 * special handling are expected to write functions that have the same
13 * arguments as these and perform similar functions, but that possibly
14 * use different output methods. Note that you shouldn't change these
Glenn Randers-Pehrsonb6ce43d1998-01-01 07:13:13 -060015 * functions, but rather write replacement functions and then change
16 * them at run time with png_set_write_fn(...).
17 */
Guy Schalnate5a37791996-06-05 15:50:50 -050018
19#define PNG_INTERNAL
20#include "png.h"
21
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
Andreas Dilger47a0c421997-05-16 02:46:07 -050026 to write more then 64K on a 16 bit machine. */
Guy Schalnate5a37791996-06-05 15:50:50 -050027
28void
Andreas Dilger47a0c421997-05-16 02:46:07 -050029png_write_data(png_structp png_ptr, png_bytep data, png_size_t length)
Guy Schalnate5a37791996-06-05 15:50:50 -050030{
Andreas Dilger47a0c421997-05-16 02:46:07 -050031 if (png_ptr->write_data_fn != NULL )
Guy Schalnate5a37791996-06-05 15:50:50 -050032 (*(png_ptr->write_data_fn))(png_ptr, data, length);
33 else
34 png_error(png_ptr, "Call to NULL write function");
35}
36
Glenn Randers-Pehrson70e3f541998-01-03 22:40:55 -060037#if !defined(PNG_NO_STDIO)
Glenn Randers-Pehrson8686fff1998-05-21 09:27:50 -050038/* This is the function that does the actual writing of data. If you are
Guy Schalnate5a37791996-06-05 15:50:50 -050039 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
43static void
Andreas Dilger47a0c421997-05-16 02:46:07 -050044png_default_write_data(png_structp png_ptr, png_bytep data, png_size_t length)
Guy Schalnate5a37791996-06-05 15:50:50 -050045{
46 png_uint_32 check;
47
Andreas Dilger47a0c421997-05-16 02:46:07 -050048 check = fwrite(data, 1, length, (FILE *)(png_ptr->io_ptr));
Guy Schalnate5a37791996-06-05 15:50:50 -050049 if (check != length)
50 {
51 png_error(png_ptr, "Write Error");
52 }
53}
54#else
55/* this is the model-independent version. Since the standard I/O library
56 can't handle far buffers in the medium and small models, we have to copy
57 the data.
58*/
59
60#define NEAR_BUF_SIZE 1024
61#define MIN(a,b) (a <= b ? a : b)
62
Guy Schalnate5a37791996-06-05 15:50:50 -050063static void
Andreas Dilger47a0c421997-05-16 02:46:07 -050064png_default_write_data(png_structp png_ptr, png_bytep data, png_size_t length)
Guy Schalnate5a37791996-06-05 15:50:50 -050065{
66 png_uint_32 check;
Andreas Dilger47a0c421997-05-16 02:46:07 -050067 png_byte *near_data; /* Needs to be "png_byte *" instead of "png_bytep" */
Andreas Dilger02ad0ef1997-01-17 01:34:35 -060068 FILE *io_ptr;
Guy Schalnate5a37791996-06-05 15:50:50 -050069
70 /* Check if data really is near. If so, use usual code. */
Andreas Dilger47a0c421997-05-16 02:46:07 -050071 near_data = (png_byte *)CVT_PTR_NOCHECK(data);
Andreas Dilger02ad0ef1997-01-17 01:34:35 -060072 io_ptr = (FILE *)CVT_PTR(png_ptr->io_ptr);
Andreas Dilger47a0c421997-05-16 02:46:07 -050073 if ((png_bytep)near_data == data)
Guy Schalnate5a37791996-06-05 15:50:50 -050074 {
Andreas Dilger47a0c421997-05-16 02:46:07 -050075 check = fwrite(near_data, 1, length, io_ptr);
Guy Schalnate5a37791996-06-05 15:50:50 -050076 }
77 else
78 {
79 png_byte buf[NEAR_BUF_SIZE];
80 png_size_t written, remaining, err;
81 check = 0;
Andreas Dilger47a0c421997-05-16 02:46:07 -050082 remaining = length;
Guy Schalnate5a37791996-06-05 15:50:50 -050083 do
84 {
85 written = MIN(NEAR_BUF_SIZE, remaining);
86 png_memcpy(buf, data, written); /* copy far buffer to near buffer */
Andreas Dilger02ad0ef1997-01-17 01:34:35 -060087 err = fwrite(buf, 1, written, io_ptr);
Guy Schalnate5a37791996-06-05 15:50:50 -050088 if (err != written)
89 break;
90 else
91 check += err;
92 data += written;
93 remaining -= written;
94 }
95 while (remaining != 0);
96 }
97 if (check != length)
98 {
99 png_error(png_ptr, "Write Error");
100 }
101}
102
103#endif
Glenn Randers-Pehrson70e3f541998-01-03 22:40:55 -0600104#endif
Guy Schalnate5a37791996-06-05 15:50:50 -0500105
106/* This function is called to output any data pending writing (normally
107 to disk). After png_flush is called, there should be no data pending
108 writing in any buffers. */
109#if defined(PNG_WRITE_FLUSH_SUPPORTED)
110void
111png_flush(png_structp png_ptr)
112{
Andreas Dilger47a0c421997-05-16 02:46:07 -0500113 if (png_ptr->output_flush_fn != NULL)
Guy Schalnate5a37791996-06-05 15:50:50 -0500114 (*(png_ptr->output_flush_fn))(png_ptr);
115}
116
Glenn Randers-Pehrson70e3f541998-01-03 22:40:55 -0600117#if !defined(PNG_NO_STDIO)
Guy Schalnate5a37791996-06-05 15:50:50 -0500118static void
119png_default_flush(png_structp png_ptr)
120{
Andreas Dilger02ad0ef1997-01-17 01:34:35 -0600121 FILE *io_ptr;
122 io_ptr = (FILE *)CVT_PTR((png_ptr->io_ptr));
Andreas Dilger47a0c421997-05-16 02:46:07 -0500123 if (io_ptr != NULL)
Andreas Dilger02ad0ef1997-01-17 01:34:35 -0600124 fflush(io_ptr);
Guy Schalnate5a37791996-06-05 15:50:50 -0500125}
126#endif
Glenn Randers-Pehrson70e3f541998-01-03 22:40:55 -0600127#endif
Guy Schalnate5a37791996-06-05 15:50:50 -0500128
129/* This function allows the application to supply new output functions for
130 libpng if standard C streams aren't being used.
131
132 This function takes as its arguments:
133 png_ptr - pointer to a png output data structure
134 io_ptr - pointer to user supplied structure containing info about
135 the output functions. May be NULL.
Glenn Randers-Pehrson8686fff1998-05-21 09:27:50 -0500136 write_data_fn - pointer to a new output function that takes as its
Guy Schalnate5a37791996-06-05 15:50:50 -0500137 arguments a pointer to a png_struct, a pointer to
Glenn Randers-Pehrson8686fff1998-05-21 09:27:50 -0500138 data to be written, and a 32-bit unsigned int that is
Guy Schalnate5a37791996-06-05 15:50:50 -0500139 the number of bytes to be written. The new write
140 function should call png_error(png_ptr, "Error msg")
141 to exit and output any fatal error messages.
Glenn Randers-Pehrson8686fff1998-05-21 09:27:50 -0500142 flush_data_fn - pointer to a new flush function that takes as its
Guy Schalnate5a37791996-06-05 15:50:50 -0500143 arguments a pointer to a png_struct. After a call to
144 the flush function, there should be no data in any buffers
145 or pending transmission. If the output method doesn't do
146 any buffering of ouput, a function prototype must still be
147 supplied although it doesn't have to do anything. If
148 PNG_WRITE_FLUSH_SUPPORTED is not defined at libpng compile
149 time, output_flush_fn will be ignored, although it must be
150 supplied for compatibility. */
151void
152png_set_write_fn(png_structp png_ptr, png_voidp io_ptr,
153 png_rw_ptr write_data_fn, png_flush_ptr output_flush_fn)
154{
155 png_ptr->io_ptr = io_ptr;
156
Glenn Randers-Pehrson70e3f541998-01-03 22:40:55 -0600157#if !defined(PNG_NO_STDIO)
Andreas Dilger47a0c421997-05-16 02:46:07 -0500158 if (write_data_fn != NULL)
Guy Schalnate5a37791996-06-05 15:50:50 -0500159 png_ptr->write_data_fn = write_data_fn;
160 else
161 png_ptr->write_data_fn = png_default_write_data;
Glenn Randers-Pehrson70e3f541998-01-03 22:40:55 -0600162#else
163 png_ptr->write_data_fn = write_data_fn;
164#endif
Guy Schalnate5a37791996-06-05 15:50:50 -0500165
166#if defined(PNG_WRITE_FLUSH_SUPPORTED)
Glenn Randers-Pehrson70e3f541998-01-03 22:40:55 -0600167#if !defined(PNG_NO_STDIO)
Andreas Dilger47a0c421997-05-16 02:46:07 -0500168 if (output_flush_fn != NULL)
Guy Schalnate5a37791996-06-05 15:50:50 -0500169 png_ptr->output_flush_fn = output_flush_fn;
170 else
171 png_ptr->output_flush_fn = png_default_flush;
Glenn Randers-Pehrson70e3f541998-01-03 22:40:55 -0600172#else
173 png_ptr->output_flush_fn = output_flush_fn;
174#endif
Guy Schalnate5a37791996-06-05 15:50:50 -0500175#endif /* PNG_WRITE_FLUSH_SUPPORTED */
176
177 /* It is an error to read while writing a png file */
178 png_ptr->read_data_fn = NULL;
179}
180
Andreas Dilger02ad0ef1997-01-17 01:34:35 -0600181#if defined(USE_FAR_KEYWORD)
182#if defined(_MSC_VER)
Glenn Randers-Pehrsona357b991998-02-08 20:56:40 -0600183void *png_far_to_near(png_structp png_ptr,png_voidp ptr, int check)
Andreas Dilger02ad0ef1997-01-17 01:34:35 -0600184{
185 void *near_ptr;
186 void FAR *far_ptr;
187 FP_OFF(near_ptr) = FP_OFF(ptr);
188 far_ptr = (void FAR *)near_ptr;
189 if(check != 0)
190 if(FP_SEG(ptr) != FP_SEG(far_ptr))
191 png_error(png_ptr,"segment lost in conversion");
192 return(near_ptr);
193}
194# else
Glenn Randers-Pehrsona357b991998-02-08 20:56:40 -0600195void *png_far_to_near(png_structp png_ptr,png_voidp ptr, int check)
Andreas Dilger02ad0ef1997-01-17 01:34:35 -0600196{
197 void *near_ptr;
198 void FAR *far_ptr;
199 near_ptr = (void FAR *)ptr;
200 far_ptr = (void FAR *)near_ptr;
201 if(check != 0)
202 if(far_ptr != ptr)
203 png_error(png_ptr,"segment lost in conversion");
204 return(near_ptr);
205}
206# endif
207# endif