blob: 4e1bd16401b4e7b7dab196ccec78b07b83a429e5 [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-Pehrson316f97a2000-07-08 13:19:41 -05004 * libpng 1.0.8beta1 - July 8, 2000
Glenn Randers-Pehrsonb6ce43d1998-01-01 07:13:13 -06005 * For conditions of distribution and use, see copyright notice in png.h
Glenn Randers-Pehrson61c32d92000-02-04 23:40:16 -06006 * Copyright (c) 1998, 1999, 2000 Glenn Randers-Pehrson
Glenn Randers-Pehrsond4366722000-06-04 14:29:29 -05007 * (Version 0.96 Copyright (c) 1996, 1997 Andreas Dilger)
8 * (Version 0.88 Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.)
Glenn Randers-Pehrsonb6ce43d1998-01-01 07:13:13 -06009 *
Glenn Randers-Pehrson8686fff1998-05-21 09:27:50 -050010 * 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
Glenn Randers-Pehrsonb6ce43d1998-01-01 07:13:13 -060014 * functions, but rather write replacement functions and then change
15 * them at run time with png_set_write_fn(...).
16 */
Guy Schalnate5a37791996-06-05 15:50:50 -050017
18#define PNG_INTERNAL
19#include "png.h"
20
21/* Write the data to whatever output you are using. The default routine
22 writes to a file pointer. Note that this routine sometimes gets called
23 with very small lengths, so you should implement some kind of simple
24 buffering if you are using unbuffered writes. This should never be asked
Glenn Randers-Pehrson345bc271998-06-14 14:43:31 -050025 to write more than 64K on a 16 bit machine. */
Guy Schalnate5a37791996-06-05 15:50:50 -050026
Glenn Randers-Pehrson75294572000-05-06 14:09:57 -050027void /* PRIVATE */
Andreas Dilger47a0c421997-05-16 02:46:07 -050028png_write_data(png_structp png_ptr, png_bytep data, png_size_t length)
Guy Schalnate5a37791996-06-05 15:50:50 -050029{
Andreas Dilger47a0c421997-05-16 02:46:07 -050030 if (png_ptr->write_data_fn != NULL )
Guy Schalnate5a37791996-06-05 15:50:50 -050031 (*(png_ptr->write_data_fn))(png_ptr, data, length);
32 else
33 png_error(png_ptr, "Call to NULL write function");
34}
35
Glenn Randers-Pehrson70e3f541998-01-03 22:40:55 -060036#if !defined(PNG_NO_STDIO)
Glenn Randers-Pehrson8686fff1998-05-21 09:27:50 -050037/* This is the function that does the actual writing of data. If you are
Guy Schalnate5a37791996-06-05 15:50:50 -050038 not writing to a standard C stream, you should create a replacement
39 write_data function and use it at run time with png_set_write_fn(), rather
40 than changing the library. */
41#ifndef USE_FAR_KEYWORD
Glenn Randers-Pehrson75294572000-05-06 14:09:57 -050042static void /* PRIVATE */
Andreas Dilger47a0c421997-05-16 02:46:07 -050043png_default_write_data(png_structp png_ptr, png_bytep data, png_size_t length)
Guy Schalnate5a37791996-06-05 15:50:50 -050044{
45 png_uint_32 check;
46
Glenn Randers-Pehrson316f97a2000-07-08 13:19:41 -050047#if defined(_WIN32_WCE)
48 if ( !WriteFile((HANDLE)(png_ptr->io_ptr), data, length, &check, NULL) )
49 check = -1;
50#else
51 check = fwrite(data, 1, length, (png_FILE_p)(png_ptr->io_ptr));
52#endif
Guy Schalnate5a37791996-06-05 15:50:50 -050053 if (check != length)
54 {
55 png_error(png_ptr, "Write Error");
56 }
57}
58#else
59/* this is the model-independent version. Since the standard I/O library
60 can't handle far buffers in the medium and small models, we have to copy
61 the data.
62*/
63
64#define NEAR_BUF_SIZE 1024
65#define MIN(a,b) (a <= b ? a : b)
66
Glenn Randers-Pehrson75294572000-05-06 14:09:57 -050067static void /* PRIVATE */
Andreas Dilger47a0c421997-05-16 02:46:07 -050068png_default_write_data(png_structp png_ptr, png_bytep data, png_size_t length)
Guy Schalnate5a37791996-06-05 15:50:50 -050069{
70 png_uint_32 check;
Andreas Dilger47a0c421997-05-16 02:46:07 -050071 png_byte *near_data; /* Needs to be "png_byte *" instead of "png_bytep" */
Glenn Randers-Pehrson316f97a2000-07-08 13:19:41 -050072 png_FILE_p io_ptr;
Guy Schalnate5a37791996-06-05 15:50:50 -050073
74 /* Check if data really is near. If so, use usual code. */
Andreas Dilger47a0c421997-05-16 02:46:07 -050075 near_data = (png_byte *)CVT_PTR_NOCHECK(data);
Glenn Randers-Pehrson316f97a2000-07-08 13:19:41 -050076 io_ptr = (png_FILE_p)CVT_PTR(png_ptr->io_ptr);
Andreas Dilger47a0c421997-05-16 02:46:07 -050077 if ((png_bytep)near_data == data)
Guy Schalnate5a37791996-06-05 15:50:50 -050078 {
Andreas Dilger47a0c421997-05-16 02:46:07 -050079 check = fwrite(near_data, 1, length, io_ptr);
Guy Schalnate5a37791996-06-05 15:50:50 -050080 }
81 else
82 {
83 png_byte buf[NEAR_BUF_SIZE];
84 png_size_t written, remaining, err;
85 check = 0;
Andreas Dilger47a0c421997-05-16 02:46:07 -050086 remaining = length;
Guy Schalnate5a37791996-06-05 15:50:50 -050087 do
88 {
89 written = MIN(NEAR_BUF_SIZE, remaining);
90 png_memcpy(buf, data, written); /* copy far buffer to near buffer */
Andreas Dilger02ad0ef1997-01-17 01:34:35 -060091 err = fwrite(buf, 1, written, io_ptr);
Guy Schalnate5a37791996-06-05 15:50:50 -050092 if (err != written)
93 break;
94 else
95 check += err;
96 data += written;
97 remaining -= written;
98 }
99 while (remaining != 0);
100 }
101 if (check != length)
102 {
103 png_error(png_ptr, "Write Error");
104 }
105}
106
107#endif
Glenn Randers-Pehrson70e3f541998-01-03 22:40:55 -0600108#endif
Guy Schalnate5a37791996-06-05 15:50:50 -0500109
110/* This function is called to output any data pending writing (normally
111 to disk). After png_flush is called, there should be no data pending
112 writing in any buffers. */
113#if defined(PNG_WRITE_FLUSH_SUPPORTED)
Glenn Randers-Pehrson75294572000-05-06 14:09:57 -0500114void /* PRIVATE */
Guy Schalnate5a37791996-06-05 15:50:50 -0500115png_flush(png_structp png_ptr)
116{
Andreas Dilger47a0c421997-05-16 02:46:07 -0500117 if (png_ptr->output_flush_fn != NULL)
Guy Schalnate5a37791996-06-05 15:50:50 -0500118 (*(png_ptr->output_flush_fn))(png_ptr);
119}
120
Glenn Randers-Pehrson70e3f541998-01-03 22:40:55 -0600121#if !defined(PNG_NO_STDIO)
Glenn Randers-Pehrson75294572000-05-06 14:09:57 -0500122static void /* PRIVATE */
Guy Schalnate5a37791996-06-05 15:50:50 -0500123png_default_flush(png_structp png_ptr)
124{
Glenn Randers-Pehrson316f97a2000-07-08 13:19:41 -0500125#if !defined(_WIN32_WCE)
126 png_FILE_p io_ptr;
127 io_ptr = (png_FILE_p)CVT_PTR((png_ptr->io_ptr));
Andreas Dilger47a0c421997-05-16 02:46:07 -0500128 if (io_ptr != NULL)
Andreas Dilger02ad0ef1997-01-17 01:34:35 -0600129 fflush(io_ptr);
Glenn Randers-Pehrson316f97a2000-07-08 13:19:41 -0500130#endif
Guy Schalnate5a37791996-06-05 15:50:50 -0500131}
132#endif
Glenn Randers-Pehrson70e3f541998-01-03 22:40:55 -0600133#endif
Guy Schalnate5a37791996-06-05 15:50:50 -0500134
135/* This function allows the application to supply new output functions for
136 libpng if standard C streams aren't being used.
137
138 This function takes as its arguments:
139 png_ptr - pointer to a png output data structure
140 io_ptr - pointer to user supplied structure containing info about
141 the output functions. May be NULL.
Glenn Randers-Pehrson8686fff1998-05-21 09:27:50 -0500142 write_data_fn - pointer to a new output function that takes as its
Guy Schalnate5a37791996-06-05 15:50:50 -0500143 arguments a pointer to a png_struct, a pointer to
Glenn Randers-Pehrson8686fff1998-05-21 09:27:50 -0500144 data to be written, and a 32-bit unsigned int that is
Guy Schalnate5a37791996-06-05 15:50:50 -0500145 the number of bytes to be written. The new write
146 function should call png_error(png_ptr, "Error msg")
147 to exit and output any fatal error messages.
Glenn Randers-Pehrson8686fff1998-05-21 09:27:50 -0500148 flush_data_fn - pointer to a new flush function that takes as its
Guy Schalnate5a37791996-06-05 15:50:50 -0500149 arguments a pointer to a png_struct. After a call to
150 the flush function, there should be no data in any buffers
151 or pending transmission. If the output method doesn't do
152 any buffering of ouput, a function prototype must still be
153 supplied although it doesn't have to do anything. If
154 PNG_WRITE_FLUSH_SUPPORTED is not defined at libpng compile
155 time, output_flush_fn will be ignored, although it must be
156 supplied for compatibility. */
Glenn Randers-Pehrson75294572000-05-06 14:09:57 -0500157void PNGAPI
Guy Schalnate5a37791996-06-05 15:50:50 -0500158png_set_write_fn(png_structp png_ptr, png_voidp io_ptr,
159 png_rw_ptr write_data_fn, png_flush_ptr output_flush_fn)
160{
161 png_ptr->io_ptr = io_ptr;
162
Glenn Randers-Pehrson70e3f541998-01-03 22:40:55 -0600163#if !defined(PNG_NO_STDIO)
Andreas Dilger47a0c421997-05-16 02:46:07 -0500164 if (write_data_fn != NULL)
Guy Schalnate5a37791996-06-05 15:50:50 -0500165 png_ptr->write_data_fn = write_data_fn;
166 else
167 png_ptr->write_data_fn = png_default_write_data;
Glenn Randers-Pehrson70e3f541998-01-03 22:40:55 -0600168#else
169 png_ptr->write_data_fn = write_data_fn;
170#endif
Guy Schalnate5a37791996-06-05 15:50:50 -0500171
172#if defined(PNG_WRITE_FLUSH_SUPPORTED)
Glenn Randers-Pehrson70e3f541998-01-03 22:40:55 -0600173#if !defined(PNG_NO_STDIO)
Andreas Dilger47a0c421997-05-16 02:46:07 -0500174 if (output_flush_fn != NULL)
Guy Schalnate5a37791996-06-05 15:50:50 -0500175 png_ptr->output_flush_fn = output_flush_fn;
176 else
177 png_ptr->output_flush_fn = png_default_flush;
Glenn Randers-Pehrson70e3f541998-01-03 22:40:55 -0600178#else
179 png_ptr->output_flush_fn = output_flush_fn;
180#endif
Guy Schalnate5a37791996-06-05 15:50:50 -0500181#endif /* PNG_WRITE_FLUSH_SUPPORTED */
182
183 /* It is an error to read while writing a png file */
Glenn Randers-Pehrsonf7d1a171998-06-06 15:31:35 -0500184 if (png_ptr->read_data_fn != NULL)
185 {
186 png_ptr->read_data_fn = NULL;
187 png_warning(png_ptr,
188 "Attempted to set both read_data_fn and write_data_fn in");
189 png_warning(png_ptr,
190 "the same structure. Resetting read_data_fn to NULL.");
191 }
Guy Schalnate5a37791996-06-05 15:50:50 -0500192}
193
Glenn Randers-Pehrson5c6aeb21998-12-29 11:47:59 -0600194#if defined(USE_FAR_KEYWORD)
195#if defined(_MSC_VER)
Glenn Randers-Pehrsona357b991998-02-08 20:56:40 -0600196void *png_far_to_near(png_structp png_ptr,png_voidp ptr, int check)
Andreas Dilger02ad0ef1997-01-17 01:34:35 -0600197{
Glenn Randers-Pehrson5c6aeb21998-12-29 11:47:59 -0600198 void *near_ptr;
Andreas Dilger02ad0ef1997-01-17 01:34:35 -0600199 void FAR *far_ptr;
200 FP_OFF(near_ptr) = FP_OFF(ptr);
201 far_ptr = (void FAR *)near_ptr;
202 if(check != 0)
203 if(FP_SEG(ptr) != FP_SEG(far_ptr))
204 png_error(png_ptr,"segment lost in conversion");
205 return(near_ptr);
206}
207# else
Glenn Randers-Pehrsona357b991998-02-08 20:56:40 -0600208void *png_far_to_near(png_structp png_ptr,png_voidp ptr, int check)
Andreas Dilger02ad0ef1997-01-17 01:34:35 -0600209{
Glenn Randers-Pehrson5c6aeb21998-12-29 11:47:59 -0600210 void *near_ptr;
Andreas Dilger02ad0ef1997-01-17 01:34:35 -0600211 void FAR *far_ptr;
212 near_ptr = (void FAR *)ptr;
213 far_ptr = (void FAR *)near_ptr;
214 if(check != 0)
215 if(far_ptr != ptr)
216 png_error(png_ptr,"segment lost in conversion");
217 return(near_ptr);
218}
219# endif
220# endif