2
/* pngwutil.c - utilities to write a PNG file
4
* Copyright (c) 2018-2024 Cosmin Truta
5
* Copyright (c) 1998-2002,2004,2006-2018 Glenn Randers-Pehrson
6
* Copyright (c) 1996-1997 Andreas Dilger
7
* Copyright (c) 1995-1996 Guy Eric Schalnat, Group 42, Inc.
9
* This code is released under the libpng license.
10
* For conditions of distribution and use, see the disclaimer
11
* and license in png.h
16
#ifdef PNG_WRITE_SUPPORTED
18
#ifdef PNG_WRITE_INT_FUNCTIONS_SUPPORTED
19
/* Place a 32-bit number into a buffer in PNG byte order. We work
20
* with unsigned numbers for convenience, although one supported
21
* ancillary chunk uses signed (two's complement) numbers.
24
png_save_uint_32(png_bytep buf, png_uint_32 i)
26
buf[0] = (png_byte)((i >> 24) & 0xffU);
27
buf[1] = (png_byte)((i >> 16) & 0xffU);
28
buf[2] = (png_byte)((i >> 8) & 0xffU);
29
buf[3] = (png_byte)( i & 0xffU);
32
/* Place a 16-bit number into a buffer in PNG byte order.
33
* The parameter is declared unsigned int, not png_uint_16,
34
* just to avoid potential problems on pre-ANSI C compilers.
37
png_save_uint_16(png_bytep buf, unsigned int i)
39
buf[0] = (png_byte)((i >> 8) & 0xffU);
40
buf[1] = (png_byte)( i & 0xffU);
44
/* Simple function to write the signature. If we have already written
45
* the magic bytes of the signature, or more likely, the PNG stream is
46
* being embedded into another stream and doesn't need its own signature,
47
* we should call png_set_sig_bytes() to tell libpng how many of the
48
* bytes have already been written.
51
png_write_sig(png_structrp png_ptr)
53
png_byte png_signature[8] = {137, 80, 78, 71, 13, 10, 26, 10};
55
#ifdef PNG_IO_STATE_SUPPORTED
56
/* Inform the I/O callback that the signature is being written */
57
png_ptr->io_state = PNG_IO_WRITING | PNG_IO_SIGNATURE;
60
/* Write the rest of the 8 byte signature */
61
png_write_data(png_ptr, &png_signature[png_ptr->sig_bytes],
62
(size_t)(8 - png_ptr->sig_bytes));
64
if (png_ptr->sig_bytes < 3)
65
png_ptr->mode |= PNG_HAVE_PNG_SIGNATURE;
68
/* Write the start of a PNG chunk. The type is the chunk type.
69
* The total_length is the sum of the lengths of all the data you will be
70
* passing in png_write_chunk_data().
73
png_write_chunk_header(png_structrp png_ptr, png_uint_32 chunk_name,
78
#if defined(PNG_DEBUG) && (PNG_DEBUG > 0)
79
PNG_CSTRING_FROM_CHUNK(buf, chunk_name);
80
png_debug2(0, "Writing %s chunk, length = %lu", buf, (unsigned long)length);
86
#ifdef PNG_IO_STATE_SUPPORTED
87
/* Inform the I/O callback that the chunk header is being written.
88
* PNG_IO_CHUNK_HDR requires a single I/O call.
90
png_ptr->io_state = PNG_IO_WRITING | PNG_IO_CHUNK_HDR;
93
/* Write the length and the chunk name */
94
png_save_uint_32(buf, length);
95
png_save_uint_32(buf + 4, chunk_name);
96
png_write_data(png_ptr, buf, 8);
98
/* Put the chunk name into png_ptr->chunk_name */
99
png_ptr->chunk_name = chunk_name;
101
/* Reset the crc and run it over the chunk name */
102
png_reset_crc(png_ptr);
104
png_calculate_crc(png_ptr, buf + 4, 4);
106
#ifdef PNG_IO_STATE_SUPPORTED
107
/* Inform the I/O callback that chunk data will (possibly) be written.
108
* PNG_IO_CHUNK_DATA does NOT require a specific number of I/O calls.
110
png_ptr->io_state = PNG_IO_WRITING | PNG_IO_CHUNK_DATA;
115
png_write_chunk_start(png_structrp png_ptr, png_const_bytep chunk_string,
118
png_write_chunk_header(png_ptr, PNG_CHUNK_FROM_STRING(chunk_string), length);
121
/* Write the data of a PNG chunk started with png_write_chunk_header().
122
* Note that multiple calls to this function are allowed, and that the
123
* sum of the lengths from these calls *must* add up to the total_length
124
* given to png_write_chunk_header().
127
png_write_chunk_data(png_structrp png_ptr, png_const_bytep data, size_t length)
129
/* Write the data, and run the CRC over it */
133
if (data != NULL && length > 0)
135
png_write_data(png_ptr, data, length);
137
/* Update the CRC after writing the data,
138
* in case the user I/O routine alters it.
140
png_calculate_crc(png_ptr, data, length);
144
/* Finish a chunk started with png_write_chunk_header(). */
146
png_write_chunk_end(png_structrp png_ptr)
150
if (png_ptr == NULL) return;
152
#ifdef PNG_IO_STATE_SUPPORTED
153
/* Inform the I/O callback that the chunk CRC is being written.
154
* PNG_IO_CHUNK_CRC requires a single I/O function call.
156
png_ptr->io_state = PNG_IO_WRITING | PNG_IO_CHUNK_CRC;
159
/* Write the crc in a single operation */
160
png_save_uint_32(buf, png_ptr->crc);
162
png_write_data(png_ptr, buf, 4);
165
/* Write a PNG chunk all at once. The type is an array of ASCII characters
166
* representing the chunk name. The array must be at least 4 bytes in
167
* length, and does not need to be null terminated. To be safe, pass the
168
* pre-defined chunk names here, and if you need a new one, define it
169
* where the others are defined. The length is the length of the data.
170
* All the data must be present. If that is not possible, use the
171
* png_write_chunk_start(), png_write_chunk_data(), and png_write_chunk_end()
175
png_write_complete_chunk(png_structrp png_ptr, png_uint_32 chunk_name,
176
png_const_bytep data, size_t length)
181
/* On 64-bit architectures 'length' may not fit in a png_uint_32. */
182
if (length > PNG_UINT_31_MAX)
183
png_error(png_ptr, "length exceeds PNG maximum");
185
png_write_chunk_header(png_ptr, chunk_name, (png_uint_32)length);
186
png_write_chunk_data(png_ptr, data, length);
187
png_write_chunk_end(png_ptr);
190
/* This is the API that calls the internal function above. */
192
png_write_chunk(png_structrp png_ptr, png_const_bytep chunk_string,
193
png_const_bytep data, size_t length)
195
png_write_complete_chunk(png_ptr, PNG_CHUNK_FROM_STRING(chunk_string), data,
199
/* This is used below to find the size of an image to pass to png_deflate_claim,
200
* so it only needs to be accurate if the size is less than 16384 bytes (the
201
* point at which a lower LZ window size can be used.)
203
static png_alloc_size_t
204
png_image_size(png_structrp png_ptr)
206
/* Only return sizes up to the maximum of a png_uint_32; do this by limiting
207
* the width and height used to 15 bits.
209
png_uint_32 h = png_ptr->height;
211
if (png_ptr->rowbytes < 32768 && h < 32768)
213
if (png_ptr->interlaced != 0)
215
/* Interlacing makes the image larger because of the replication of
216
* both the filter byte and the padding to a byte boundary.
218
png_uint_32 w = png_ptr->width;
219
unsigned int pd = png_ptr->pixel_depth;
220
png_alloc_size_t cb_base;
223
for (cb_base=0, pass=0; pass<=6; ++pass)
225
png_uint_32 pw = PNG_PASS_COLS(w, pass);
228
cb_base += (PNG_ROWBYTES(pd, pw)+1) * PNG_PASS_ROWS(h, pass);
235
return (png_ptr->rowbytes+1) * h;
242
#ifdef PNG_WRITE_OPTIMIZE_CMF_SUPPORTED
243
/* This is the code to hack the first two bytes of the deflate stream (the
244
* deflate header) to correct the windowBits value to match the actual data
245
* size. Note that the second argument is the *uncompressed* size but the
246
* first argument is the *compressed* data (and it must be deflate
250
optimize_cmf(png_bytep data, png_alloc_size_t data_size)
252
/* Optimize the CMF field in the zlib stream. The resultant zlib stream is
253
* still compliant to the stream specification.
255
if (data_size <= 16384) /* else windowBits must be 15 */
257
unsigned int z_cmf = data[0]; /* zlib compression method and flags */
259
if ((z_cmf & 0x0f) == 8 && (z_cmf & 0xf0) <= 0x70)
261
unsigned int z_cinfo;
262
unsigned int half_z_window_size;
264
z_cinfo = z_cmf >> 4;
265
half_z_window_size = 1U << (z_cinfo + 7);
267
if (data_size <= half_z_window_size) /* else no change */
273
half_z_window_size >>= 1;
276
while (z_cinfo > 0 && data_size <= half_z_window_size);
278
z_cmf = (z_cmf & 0x0f) | (z_cinfo << 4);
280
data[0] = (png_byte)z_cmf;
281
tmp = data[1] & 0xe0;
282
tmp += 0x1f - ((z_cmf << 8) + tmp) % 0x1f;
283
data[1] = (png_byte)tmp;
288
#endif /* WRITE_OPTIMIZE_CMF */
290
/* Initialize the compressor for the appropriate type of compression. */
292
png_deflate_claim(png_structrp png_ptr, png_uint_32 owner,
293
png_alloc_size_t data_size)
295
if (png_ptr->zowner != 0)
297
#if defined(PNG_WARNINGS_SUPPORTED) || defined(PNG_ERROR_TEXT_SUPPORTED)
300
PNG_STRING_FROM_CHUNK(msg, owner);
303
PNG_STRING_FROM_CHUNK(msg+6, png_ptr->zowner);
304
/* So the message that results is "<chunk> using zstream"; this is an
305
* internal error, but is very useful for debugging. i18n requirements
308
(void)png_safecat(msg, (sizeof msg), 10, " using zstream");
311
png_warning(png_ptr, msg);
313
/* Attempt sane error recovery */
314
if (png_ptr->zowner == png_IDAT) /* don't steal from IDAT */
316
png_ptr->zstream.msg = PNGZ_MSG_CAST("in use by IDAT");
317
return Z_STREAM_ERROR;
322
png_error(png_ptr, msg);
327
int level = png_ptr->zlib_level;
328
int method = png_ptr->zlib_method;
329
int windowBits = png_ptr->zlib_window_bits;
330
int memLevel = png_ptr->zlib_mem_level;
331
int strategy; /* set below */
332
int ret; /* zlib return code */
334
if (owner == png_IDAT)
336
if ((png_ptr->flags & PNG_FLAG_ZLIB_CUSTOM_STRATEGY) != 0)
337
strategy = png_ptr->zlib_strategy;
339
else if (png_ptr->do_filter != PNG_FILTER_NONE)
340
strategy = PNG_Z_DEFAULT_STRATEGY;
343
strategy = PNG_Z_DEFAULT_NOFILTER_STRATEGY;
348
#ifdef PNG_WRITE_CUSTOMIZE_ZTXT_COMPRESSION_SUPPORTED
349
level = png_ptr->zlib_text_level;
350
method = png_ptr->zlib_text_method;
351
windowBits = png_ptr->zlib_text_window_bits;
352
memLevel = png_ptr->zlib_text_mem_level;
353
strategy = png_ptr->zlib_text_strategy;
355
/* If customization is not supported the values all come from the
356
* IDAT values except for the strategy, which is fixed to the
357
* default. (This is the pre-1.6.0 behavior too, although it was
358
* implemented in a very different way.)
360
strategy = Z_DEFAULT_STRATEGY;
364
/* Adjust 'windowBits' down if larger than 'data_size'; to stop this
365
* happening just pass 32768 as the data_size parameter. Notice that zlib
366
* requires an extra 262 bytes in the window in addition to the data to be
367
* able to see the whole of the data, so if data_size+262 takes us to the
368
* next windowBits size we need to fix up the value later. (Because even
369
* though deflate needs the extra window, inflate does not!)
371
if (data_size <= 16384)
373
/* IMPLEMENTATION NOTE: this 'half_window_size' stuff is only here to
374
* work round a Microsoft Visual C misbehavior which, contrary to C-90,
375
* widens the result of the following shift to 64-bits if (and,
376
* apparently, only if) it is used in a test.
378
unsigned int half_window_size = 1U << (windowBits-1);
380
while (data_size + 262 <= half_window_size)
382
half_window_size >>= 1;
387
/* Check against the previous initialized values, if any. */
388
if ((png_ptr->flags & PNG_FLAG_ZSTREAM_INITIALIZED) != 0 &&
389
(png_ptr->zlib_set_level != level ||
390
png_ptr->zlib_set_method != method ||
391
png_ptr->zlib_set_window_bits != windowBits ||
392
png_ptr->zlib_set_mem_level != memLevel ||
393
png_ptr->zlib_set_strategy != strategy))
395
if (deflateEnd(&png_ptr->zstream) != Z_OK)
396
png_warning(png_ptr, "deflateEnd failed (ignored)");
398
png_ptr->flags &= ~PNG_FLAG_ZSTREAM_INITIALIZED;
401
/* For safety clear out the input and output pointers (currently zlib
402
* doesn't use them on Init, but it might in the future).
404
png_ptr->zstream.next_in = NULL;
405
png_ptr->zstream.avail_in = 0;
406
png_ptr->zstream.next_out = NULL;
407
png_ptr->zstream.avail_out = 0;
409
/* Now initialize if required, setting the new parameters, otherwise just
410
* do a simple reset to the previous parameters.
412
if ((png_ptr->flags & PNG_FLAG_ZSTREAM_INITIALIZED) != 0)
413
ret = deflateReset(&png_ptr->zstream);
417
ret = deflateInit2(&png_ptr->zstream, level, method, windowBits,
421
png_ptr->flags |= PNG_FLAG_ZSTREAM_INITIALIZED;
424
/* The return code is from either deflateReset or deflateInit2; they have
425
* pretty much the same set of error codes.
428
png_ptr->zowner = owner;
431
png_zstream_error(png_ptr, ret);
437
/* Clean up (or trim) a linked list of compression buffers. */
439
png_free_buffer_list(png_structrp png_ptr, png_compression_bufferp *listp)
441
png_compression_bufferp list = *listp;
449
png_compression_bufferp next = list->next;
451
png_free(png_ptr, list);
454
while (list != NULL);
458
#ifdef PNG_WRITE_COMPRESSED_TEXT_SUPPORTED
459
/* This pair of functions encapsulates the operation of (a) compressing a
460
* text string, and (b) issuing it later as a series of chunk data writes.
461
* The compression_state structure is shared context for these functions
462
* set up by the caller to allow access to the relevant local variables.
464
* compression_buffer (new in 1.6.0) is just a linked list of zbuffer_size
465
* temporary buffers. From 1.6.0 it is retained in png_struct so that it will
466
* be correctly freed in the event of a write error (previous implementations
467
* just leaked memory.)
471
png_const_bytep input; /* The uncompressed input data */
472
png_alloc_size_t input_len; /* Its length */
473
png_uint_32 output_len; /* Final compressed length */
474
png_byte output[1024]; /* First block of output */
478
png_text_compress_init(compression_state *comp, png_const_bytep input,
479
png_alloc_size_t input_len)
482
comp->input_len = input_len;
483
comp->output_len = 0;
486
/* Compress the data in the compression state input */
488
png_text_compress(png_structrp png_ptr, png_uint_32 chunk_name,
489
compression_state *comp, png_uint_32 prefix_len)
493
/* To find the length of the output it is necessary to first compress the
494
* input. The result is buffered rather than using the two-pass algorithm
495
* that is used on the inflate side; deflate is assumed to be slower and a
496
* PNG writer is assumed to have more memory available than a PNG reader.
498
* IMPLEMENTATION NOTE: the zlib API deflateBound() can be used to find an
499
* upper limit on the output size, but it is always bigger than the input
500
* size so it is likely to be more efficient to use this linked-list
503
ret = png_deflate_claim(png_ptr, chunk_name, comp->input_len);
508
/* Set up the compression buffers, we need a loop here to avoid overflowing a
509
* uInt. Use ZLIB_IO_MAX to limit the input. The output is always limited
510
* by the output buffer size, so there is no need to check that. Since this
511
* is ANSI-C we know that an 'int', hence a uInt, is always at least 16 bits
515
png_compression_bufferp *end = &png_ptr->zbuffer_list;
516
png_alloc_size_t input_len = comp->input_len; /* may be zero! */
517
png_uint_32 output_len;
519
/* zlib updates these for us: */
520
png_ptr->zstream.next_in = PNGZ_INPUT_CAST(comp->input);
521
png_ptr->zstream.avail_in = 0; /* Set below */
522
png_ptr->zstream.next_out = comp->output;
523
png_ptr->zstream.avail_out = (sizeof comp->output);
525
output_len = png_ptr->zstream.avail_out;
529
uInt avail_in = ZLIB_IO_MAX;
531
if (avail_in > input_len)
532
avail_in = (uInt)input_len;
534
input_len -= avail_in;
536
png_ptr->zstream.avail_in = avail_in;
538
if (png_ptr->zstream.avail_out == 0)
540
png_compression_buffer *next;
542
/* Chunk data is limited to 2^31 bytes in length, so the prefix
543
* length must be counted here.
545
if (output_len + prefix_len > PNG_UINT_31_MAX)
551
/* Need a new (malloc'ed) buffer, but there may be one present
557
next = png_voidcast(png_compression_bufferp, png_malloc_base
558
(png_ptr, PNG_COMPRESSION_BUFFER_SIZE(png_ptr)));
566
/* Link in this buffer (so that it will be freed later) */
571
png_ptr->zstream.next_out = next->output;
572
png_ptr->zstream.avail_out = png_ptr->zbuffer_size;
573
output_len += png_ptr->zstream.avail_out;
575
/* Move 'end' to the next buffer pointer. */
579
/* Compress the data */
580
ret = deflate(&png_ptr->zstream,
581
input_len > 0 ? Z_NO_FLUSH : Z_FINISH);
583
/* Claw back input data that was not consumed (because avail_in is
584
* reset above every time round the loop).
586
input_len += png_ptr->zstream.avail_in;
587
png_ptr->zstream.avail_in = 0; /* safety */
591
/* There may be some space left in the last output buffer. This needs to
592
* be subtracted from output_len.
594
output_len -= png_ptr->zstream.avail_out;
595
png_ptr->zstream.avail_out = 0; /* safety */
596
comp->output_len = output_len;
598
/* Now double check the output length, put in a custom message if it is
599
* too long. Otherwise ensure the z_stream::msg pointer is set to
602
if (output_len + prefix_len >= PNG_UINT_31_MAX)
604
png_ptr->zstream.msg = PNGZ_MSG_CAST("compressed data too long");
609
png_zstream_error(png_ptr, ret);
611
/* Reset zlib for another zTXt/iTXt or image data */
614
/* The only success case is Z_STREAM_END, input_len must be 0; if not this
615
* is an internal error.
617
if (ret == Z_STREAM_END && input_len == 0)
619
#ifdef PNG_WRITE_OPTIMIZE_CMF_SUPPORTED
620
/* Fix up the deflate header, if required */
621
optimize_cmf(comp->output, comp->input_len);
623
/* But Z_OK is returned, not Z_STREAM_END; this allows the claim
624
* function above to return Z_STREAM_END on an error (though it never
625
* does in the current versions of zlib.)
635
/* Ship the compressed text out via chunk writes */
637
png_write_compressed_data_out(png_structrp png_ptr, compression_state *comp)
639
png_uint_32 output_len = comp->output_len;
640
png_const_bytep output = comp->output;
641
png_uint_32 avail = (sizeof comp->output);
642
png_compression_buffer *next = png_ptr->zbuffer_list;
646
if (avail > output_len)
649
png_write_chunk_data(png_ptr, output, avail);
653
if (output_len == 0 || next == NULL)
656
avail = png_ptr->zbuffer_size;
657
output = next->output;
661
/* This is an internal error; 'next' must have been NULL! */
663
png_error(png_ptr, "error writing ancillary chunked compressed data");
665
#endif /* WRITE_COMPRESSED_TEXT */
667
/* Write the IHDR chunk, and update the png_struct with the necessary
668
* information. Note that the rest of this code depends upon this
669
* information being correct.
672
png_write_IHDR(png_structrp png_ptr, png_uint_32 width, png_uint_32 height,
673
int bit_depth, int color_type, int compression_type, int filter_type,
676
png_byte buf[13]; /* Buffer to store the IHDR info */
677
int is_invalid_depth;
679
png_debug(1, "in png_write_IHDR");
681
/* Check that we have valid input data from the application info */
684
case PNG_COLOR_TYPE_GRAY:
691
#ifdef PNG_WRITE_16BIT_SUPPORTED
694
png_ptr->channels = 1; break;
698
"Invalid bit depth for grayscale image");
702
case PNG_COLOR_TYPE_RGB:
703
is_invalid_depth = (bit_depth != 8);
704
#ifdef PNG_WRITE_16BIT_SUPPORTED
705
is_invalid_depth = (is_invalid_depth && bit_depth != 16);
707
if (is_invalid_depth)
708
png_error(png_ptr, "Invalid bit depth for RGB image");
710
png_ptr->channels = 3;
713
case PNG_COLOR_TYPE_PALETTE:
720
png_ptr->channels = 1;
724
png_error(png_ptr, "Invalid bit depth for paletted image");
728
case PNG_COLOR_TYPE_GRAY_ALPHA:
729
is_invalid_depth = (bit_depth != 8);
730
#ifdef PNG_WRITE_16BIT_SUPPORTED
731
is_invalid_depth = (is_invalid_depth && bit_depth != 16);
733
if (is_invalid_depth)
734
png_error(png_ptr, "Invalid bit depth for grayscale+alpha image");
736
png_ptr->channels = 2;
739
case PNG_COLOR_TYPE_RGB_ALPHA:
740
is_invalid_depth = (bit_depth != 8);
741
#ifdef PNG_WRITE_16BIT_SUPPORTED
742
is_invalid_depth = (is_invalid_depth && bit_depth != 16);
744
if (is_invalid_depth)
745
png_error(png_ptr, "Invalid bit depth for RGBA image");
747
png_ptr->channels = 4;
751
png_error(png_ptr, "Invalid image color type specified");
754
if (compression_type != PNG_COMPRESSION_TYPE_BASE)
756
png_warning(png_ptr, "Invalid compression type specified");
757
compression_type = PNG_COMPRESSION_TYPE_BASE;
760
/* Write filter_method 64 (intrapixel differencing) only if
761
* 1. Libpng was compiled with PNG_MNG_FEATURES_SUPPORTED and
762
* 2. Libpng did not write a PNG signature (this filter_method is only
763
* used in PNG datastreams that are embedded in MNG datastreams) and
764
* 3. The application called png_permit_mng_features with a mask that
765
* included PNG_FLAG_MNG_FILTER_64 and
766
* 4. The filter_method is 64 and
767
* 5. The color_type is RGB or RGBA
770
#ifdef PNG_MNG_FEATURES_SUPPORTED
771
!((png_ptr->mng_features_permitted & PNG_FLAG_MNG_FILTER_64) != 0 &&
772
((png_ptr->mode & PNG_HAVE_PNG_SIGNATURE) == 0) &&
773
(color_type == PNG_COLOR_TYPE_RGB ||
774
color_type == PNG_COLOR_TYPE_RGB_ALPHA) &&
775
(filter_type == PNG_INTRAPIXEL_DIFFERENCING)) &&
777
filter_type != PNG_FILTER_TYPE_BASE)
779
png_warning(png_ptr, "Invalid filter type specified");
780
filter_type = PNG_FILTER_TYPE_BASE;
783
#ifdef PNG_WRITE_INTERLACING_SUPPORTED
784
if (interlace_type != PNG_INTERLACE_NONE &&
785
interlace_type != PNG_INTERLACE_ADAM7)
787
png_warning(png_ptr, "Invalid interlace type specified");
788
interlace_type = PNG_INTERLACE_ADAM7;
791
interlace_type=PNG_INTERLACE_NONE;
794
/* Save the relevant information */
795
png_ptr->bit_depth = (png_byte)bit_depth;
796
png_ptr->color_type = (png_byte)color_type;
797
png_ptr->interlaced = (png_byte)interlace_type;
798
#ifdef PNG_MNG_FEATURES_SUPPORTED
799
png_ptr->filter_type = (png_byte)filter_type;
801
png_ptr->compression_type = (png_byte)compression_type;
802
png_ptr->width = width;
803
png_ptr->height = height;
805
png_ptr->pixel_depth = (png_byte)(bit_depth * png_ptr->channels);
806
png_ptr->rowbytes = PNG_ROWBYTES(png_ptr->pixel_depth, width);
807
/* Set the usr info, so any transformations can modify it */
808
png_ptr->usr_width = png_ptr->width;
809
png_ptr->usr_bit_depth = png_ptr->bit_depth;
810
png_ptr->usr_channels = png_ptr->channels;
812
/* Pack the header information into the buffer */
813
png_save_uint_32(buf, width);
814
png_save_uint_32(buf + 4, height);
815
buf[8] = (png_byte)bit_depth;
816
buf[9] = (png_byte)color_type;
817
buf[10] = (png_byte)compression_type;
818
buf[11] = (png_byte)filter_type;
819
buf[12] = (png_byte)interlace_type;
821
/* Write the chunk */
822
png_write_complete_chunk(png_ptr, png_IHDR, buf, 13);
824
if ((png_ptr->do_filter) == PNG_NO_FILTERS)
826
if (png_ptr->color_type == PNG_COLOR_TYPE_PALETTE ||
827
png_ptr->bit_depth < 8)
828
png_ptr->do_filter = PNG_FILTER_NONE;
831
png_ptr->do_filter = PNG_ALL_FILTERS;
834
png_ptr->mode = PNG_HAVE_IHDR; /* not READY_FOR_ZTXT */
837
/* Write the palette. We are careful not to trust png_color to be in the
838
* correct order for PNG, so people can redefine it to any convenient
842
png_write_PLTE(png_structrp png_ptr, png_const_colorp palette,
845
png_uint_32 max_palette_length, i;
846
png_const_colorp pal_ptr;
849
png_debug(1, "in png_write_PLTE");
851
max_palette_length = (png_ptr->color_type == PNG_COLOR_TYPE_PALETTE) ?
852
(1 << png_ptr->bit_depth) : PNG_MAX_PALETTE_LENGTH;
855
#ifdef PNG_MNG_FEATURES_SUPPORTED
856
(png_ptr->mng_features_permitted & PNG_FLAG_MNG_EMPTY_PLTE) == 0 &&
858
num_pal == 0) || num_pal > max_palette_length)
860
if (png_ptr->color_type == PNG_COLOR_TYPE_PALETTE)
862
png_error(png_ptr, "Invalid number of colors in palette");
867
png_warning(png_ptr, "Invalid number of colors in palette");
872
if ((png_ptr->color_type & PNG_COLOR_MASK_COLOR) == 0)
875
"Ignoring request to write a PLTE chunk in grayscale PNG");
880
png_ptr->num_palette = (png_uint_16)num_pal;
881
png_debug1(3, "num_palette = %d", png_ptr->num_palette);
883
png_write_chunk_header(png_ptr, png_PLTE, (png_uint_32)(num_pal * 3));
884
#ifdef PNG_POINTER_INDEXING_SUPPORTED
886
for (i = 0, pal_ptr = palette; i < num_pal; i++, pal_ptr++)
888
buf[0] = pal_ptr->red;
889
buf[1] = pal_ptr->green;
890
buf[2] = pal_ptr->blue;
891
png_write_chunk_data(png_ptr, buf, 3);
895
/* This is a little slower but some buggy compilers need to do this
900
for (i = 0; i < num_pal; i++)
902
buf[0] = pal_ptr[i].red;
903
buf[1] = pal_ptr[i].green;
904
buf[2] = pal_ptr[i].blue;
905
png_write_chunk_data(png_ptr, buf, 3);
909
png_write_chunk_end(png_ptr);
910
png_ptr->mode |= PNG_HAVE_PLTE;
913
/* This is similar to png_text_compress, above, except that it does not require
914
* all of the data at once and, instead of buffering the compressed result,
915
* writes it as IDAT chunks. Unlike png_text_compress it *can* png_error out
916
* because it calls the write interface. As a result it does its own error
917
* reporting and does not return an error code. In the event of error it will
918
* just call png_error. The input data length may exceed 32-bits. The 'flush'
919
* parameter is exactly the same as that to deflate, with the following
922
* Z_NO_FLUSH: normal incremental output of compressed data
923
* Z_SYNC_FLUSH: do a SYNC_FLUSH, used by png_write_flush
924
* Z_FINISH: this is the end of the input, do a Z_FINISH and clean up
926
* The routine manages the acquire and release of the png_ptr->zstream by
927
* checking and (at the end) clearing png_ptr->zowner; it does some sanity
928
* checks on the 'mode' flags while doing this.
931
png_compress_IDAT(png_structrp png_ptr, png_const_bytep input,
932
png_alloc_size_t input_len, int flush)
934
if (png_ptr->zowner != png_IDAT)
936
/* First time. Ensure we have a temporary buffer for compression and
937
* trim the buffer list if it has more than one entry to free memory.
938
* If 'WRITE_COMPRESSED_TEXT' is not set the list will never have been
939
* created at this point, but the check here is quick and safe.
941
if (png_ptr->zbuffer_list == NULL)
943
png_ptr->zbuffer_list = png_voidcast(png_compression_bufferp,
944
png_malloc(png_ptr, PNG_COMPRESSION_BUFFER_SIZE(png_ptr)));
945
png_ptr->zbuffer_list->next = NULL;
949
png_free_buffer_list(png_ptr, &png_ptr->zbuffer_list->next);
951
/* It is a terminal error if we can't claim the zstream. */
952
if (png_deflate_claim(png_ptr, png_IDAT, png_image_size(png_ptr)) != Z_OK)
953
png_error(png_ptr, png_ptr->zstream.msg);
955
/* The output state is maintained in png_ptr->zstream, so it must be
956
* initialized here after the claim.
958
png_ptr->zstream.next_out = png_ptr->zbuffer_list->output;
959
png_ptr->zstream.avail_out = png_ptr->zbuffer_size;
962
/* Now loop reading and writing until all the input is consumed or an error
963
* terminates the operation. The _out values are maintained across calls to
964
* this function, but the input must be reset each time.
966
png_ptr->zstream.next_in = PNGZ_INPUT_CAST(input);
967
png_ptr->zstream.avail_in = 0; /* set below */
972
/* INPUT: from the row data */
973
uInt avail = ZLIB_IO_MAX;
975
if (avail > input_len)
976
avail = (uInt)input_len; /* safe because of the check */
978
png_ptr->zstream.avail_in = avail;
981
ret = deflate(&png_ptr->zstream, input_len > 0 ? Z_NO_FLUSH : flush);
983
/* Include as-yet unconsumed input */
984
input_len += png_ptr->zstream.avail_in;
985
png_ptr->zstream.avail_in = 0;
987
/* OUTPUT: write complete IDAT chunks when avail_out drops to zero. Note
988
* that these two zstream fields are preserved across the calls, therefore
989
* there is no need to set these up on entry to the loop.
991
if (png_ptr->zstream.avail_out == 0)
993
png_bytep data = png_ptr->zbuffer_list->output;
994
uInt size = png_ptr->zbuffer_size;
996
/* Write an IDAT containing the data then reset the buffer. The
997
* first IDAT may need deflate header optimization.
999
#ifdef PNG_WRITE_OPTIMIZE_CMF_SUPPORTED
1000
if ((png_ptr->mode & PNG_HAVE_IDAT) == 0 &&
1001
png_ptr->compression_type == PNG_COMPRESSION_TYPE_BASE)
1002
optimize_cmf(data, png_image_size(png_ptr));
1006
png_write_complete_chunk(png_ptr, png_IDAT, data, size);
1007
png_ptr->mode |= PNG_HAVE_IDAT;
1009
png_ptr->zstream.next_out = data;
1010
png_ptr->zstream.avail_out = size;
1012
/* For SYNC_FLUSH or FINISH it is essential to keep calling zlib with
1013
* the same flush parameter until it has finished output, for NO_FLUSH
1014
* it doesn't matter.
1016
if (ret == Z_OK && flush != Z_NO_FLUSH)
1020
/* The order of these checks doesn't matter much; it just affects which
1021
* possible error might be detected if multiple things go wrong at once.
1023
if (ret == Z_OK) /* most likely return code! */
1025
/* If all the input has been consumed then just return. If Z_FINISH
1026
* was used as the flush parameter something has gone wrong if we get
1031
if (flush == Z_FINISH)
1032
png_error(png_ptr, "Z_OK on Z_FINISH with output space");
1038
else if (ret == Z_STREAM_END && flush == Z_FINISH)
1040
/* This is the end of the IDAT data; any pending output must be
1041
* flushed. For small PNG files we may still be at the beginning.
1043
png_bytep data = png_ptr->zbuffer_list->output;
1044
uInt size = png_ptr->zbuffer_size - png_ptr->zstream.avail_out;
1046
#ifdef PNG_WRITE_OPTIMIZE_CMF_SUPPORTED
1047
if ((png_ptr->mode & PNG_HAVE_IDAT) == 0 &&
1048
png_ptr->compression_type == PNG_COMPRESSION_TYPE_BASE)
1049
optimize_cmf(data, png_image_size(png_ptr));
1053
png_write_complete_chunk(png_ptr, png_IDAT, data, size);
1054
png_ptr->zstream.avail_out = 0;
1055
png_ptr->zstream.next_out = NULL;
1056
png_ptr->mode |= PNG_HAVE_IDAT | PNG_AFTER_IDAT;
1058
png_ptr->zowner = 0; /* Release the stream */
1064
/* This is an error condition. */
1065
png_zstream_error(png_ptr, ret);
1066
png_error(png_ptr, png_ptr->zstream.msg);
1071
/* Write an IEND chunk */
1073
png_write_IEND(png_structrp png_ptr)
1075
png_debug(1, "in png_write_IEND");
1077
png_write_complete_chunk(png_ptr, png_IEND, NULL, 0);
1078
png_ptr->mode |= PNG_HAVE_IEND;
1081
#ifdef PNG_WRITE_gAMA_SUPPORTED
1082
/* Write a gAMA chunk */
1084
png_write_gAMA_fixed(png_structrp png_ptr, png_fixed_point file_gamma)
1088
png_debug(1, "in png_write_gAMA");
1090
/* file_gamma is saved in 1/100,000ths */
1091
png_save_uint_32(buf, (png_uint_32)file_gamma);
1092
png_write_complete_chunk(png_ptr, png_gAMA, buf, 4);
1096
#ifdef PNG_WRITE_sRGB_SUPPORTED
1097
/* Write a sRGB chunk */
1099
png_write_sRGB(png_structrp png_ptr, int srgb_intent)
1103
png_debug(1, "in png_write_sRGB");
1105
if (srgb_intent >= PNG_sRGB_INTENT_LAST)
1106
png_warning(png_ptr,
1107
"Invalid sRGB rendering intent specified");
1109
buf[0]=(png_byte)srgb_intent;
1110
png_write_complete_chunk(png_ptr, png_sRGB, buf, 1);
1114
#ifdef PNG_WRITE_iCCP_SUPPORTED
1115
/* Write an iCCP chunk */
1117
png_write_iCCP(png_structrp png_ptr, png_const_charp name,
1118
png_const_bytep profile)
1120
png_uint_32 name_len;
1121
png_uint_32 profile_len;
1122
png_byte new_name[81]; /* 1 byte for the compression byte */
1123
compression_state comp;
1126
png_debug(1, "in png_write_iCCP");
1128
/* These are all internal problems: the profile should have been checked
1129
* before when it was stored.
1131
if (profile == NULL)
1132
png_error(png_ptr, "No profile for iCCP chunk"); /* internal error */
1134
profile_len = png_get_uint_32(profile);
1136
if (profile_len < 132)
1137
png_error(png_ptr, "ICC profile too short");
1139
temp = (png_uint_32) (*(profile+8));
1140
if (temp > 3 && (profile_len & 0x03))
1141
png_error(png_ptr, "ICC profile length invalid (not a multiple of 4)");
1144
png_uint_32 embedded_profile_len = png_get_uint_32(profile);
1146
if (profile_len != embedded_profile_len)
1147
png_error(png_ptr, "Profile length does not match profile");
1150
name_len = png_check_keyword(png_ptr, name, new_name);
1153
png_error(png_ptr, "iCCP: invalid keyword");
1155
new_name[++name_len] = PNG_COMPRESSION_TYPE_BASE;
1157
/* Make sure we include the NULL after the name and the compression type */
1160
png_text_compress_init(&comp, profile, profile_len);
1162
/* Allow for keyword terminator and compression byte */
1163
if (png_text_compress(png_ptr, png_iCCP, &comp, name_len) != Z_OK)
1164
png_error(png_ptr, png_ptr->zstream.msg);
1166
png_write_chunk_header(png_ptr, png_iCCP, name_len + comp.output_len);
1168
png_write_chunk_data(png_ptr, new_name, name_len);
1170
png_write_compressed_data_out(png_ptr, &comp);
1172
png_write_chunk_end(png_ptr);
1176
#ifdef PNG_WRITE_sPLT_SUPPORTED
1177
/* Write a sPLT chunk */
1179
png_write_sPLT(png_structrp png_ptr, png_const_sPLT_tp spalette)
1181
png_uint_32 name_len;
1182
png_byte new_name[80];
1183
png_byte entrybuf[10];
1184
size_t entry_size = (spalette->depth == 8 ? 6 : 10);
1185
size_t palette_size = entry_size * (size_t)spalette->nentries;
1187
#ifndef PNG_POINTER_INDEXING_SUPPORTED
1191
png_debug(1, "in png_write_sPLT");
1193
name_len = png_check_keyword(png_ptr, spalette->name, new_name);
1196
png_error(png_ptr, "sPLT: invalid keyword");
1198
/* Make sure we include the NULL after the name */
1199
png_write_chunk_header(png_ptr, png_sPLT,
1200
(png_uint_32)(name_len + 2 + palette_size));
1202
png_write_chunk_data(png_ptr, (png_bytep)new_name, (size_t)(name_len + 1));
1204
png_write_chunk_data(png_ptr, &spalette->depth, 1);
1206
/* Loop through each palette entry, writing appropriately */
1207
#ifdef PNG_POINTER_INDEXING_SUPPORTED
1208
for (ep = spalette->entries; ep<spalette->entries + spalette->nentries; ep++)
1210
if (spalette->depth == 8)
1212
entrybuf[0] = (png_byte)ep->red;
1213
entrybuf[1] = (png_byte)ep->green;
1214
entrybuf[2] = (png_byte)ep->blue;
1215
entrybuf[3] = (png_byte)ep->alpha;
1216
png_save_uint_16(entrybuf + 4, ep->frequency);
1221
png_save_uint_16(entrybuf + 0, ep->red);
1222
png_save_uint_16(entrybuf + 2, ep->green);
1223
png_save_uint_16(entrybuf + 4, ep->blue);
1224
png_save_uint_16(entrybuf + 6, ep->alpha);
1225
png_save_uint_16(entrybuf + 8, ep->frequency);
1228
png_write_chunk_data(png_ptr, entrybuf, entry_size);
1231
ep=spalette->entries;
1232
for (i = 0; i>spalette->nentries; i++)
1234
if (spalette->depth == 8)
1236
entrybuf[0] = (png_byte)ep[i].red;
1237
entrybuf[1] = (png_byte)ep[i].green;
1238
entrybuf[2] = (png_byte)ep[i].blue;
1239
entrybuf[3] = (png_byte)ep[i].alpha;
1240
png_save_uint_16(entrybuf + 4, ep[i].frequency);
1245
png_save_uint_16(entrybuf + 0, ep[i].red);
1246
png_save_uint_16(entrybuf + 2, ep[i].green);
1247
png_save_uint_16(entrybuf + 4, ep[i].blue);
1248
png_save_uint_16(entrybuf + 6, ep[i].alpha);
1249
png_save_uint_16(entrybuf + 8, ep[i].frequency);
1252
png_write_chunk_data(png_ptr, entrybuf, entry_size);
1256
png_write_chunk_end(png_ptr);
1260
#ifdef PNG_WRITE_sBIT_SUPPORTED
1261
/* Write the sBIT chunk */
1263
png_write_sBIT(png_structrp png_ptr, png_const_color_8p sbit, int color_type)
1268
png_debug(1, "in png_write_sBIT");
1270
/* Make sure we don't depend upon the order of PNG_COLOR_8 */
1271
if ((color_type & PNG_COLOR_MASK_COLOR) != 0)
1275
maxbits = (png_byte)(color_type==PNG_COLOR_TYPE_PALETTE ? 8 :
1276
png_ptr->usr_bit_depth);
1278
if (sbit->red == 0 || sbit->red > maxbits ||
1279
sbit->green == 0 || sbit->green > maxbits ||
1280
sbit->blue == 0 || sbit->blue > maxbits)
1282
png_warning(png_ptr, "Invalid sBIT depth specified");
1287
buf[1] = sbit->green;
1288
buf[2] = sbit->blue;
1294
if (sbit->gray == 0 || sbit->gray > png_ptr->usr_bit_depth)
1296
png_warning(png_ptr, "Invalid sBIT depth specified");
1300
buf[0] = sbit->gray;
1304
if ((color_type & PNG_COLOR_MASK_ALPHA) != 0)
1306
if (sbit->alpha == 0 || sbit->alpha > png_ptr->usr_bit_depth)
1308
png_warning(png_ptr, "Invalid sBIT depth specified");
1312
buf[size++] = sbit->alpha;
1315
png_write_complete_chunk(png_ptr, png_sBIT, buf, size);
1319
#ifdef PNG_WRITE_cHRM_SUPPORTED
1320
/* Write the cHRM chunk */
1322
png_write_cHRM_fixed(png_structrp png_ptr, const png_xy *xy)
1326
png_debug(1, "in png_write_cHRM");
1328
/* Each value is saved in 1/100,000ths */
1329
png_save_int_32(buf, xy->whitex);
1330
png_save_int_32(buf + 4, xy->whitey);
1332
png_save_int_32(buf + 8, xy->redx);
1333
png_save_int_32(buf + 12, xy->redy);
1335
png_save_int_32(buf + 16, xy->greenx);
1336
png_save_int_32(buf + 20, xy->greeny);
1338
png_save_int_32(buf + 24, xy->bluex);
1339
png_save_int_32(buf + 28, xy->bluey);
1341
png_write_complete_chunk(png_ptr, png_cHRM, buf, 32);
1345
#ifdef PNG_WRITE_tRNS_SUPPORTED
1346
/* Write the tRNS chunk */
1348
png_write_tRNS(png_structrp png_ptr, png_const_bytep trans_alpha,
1349
png_const_color_16p tran, int num_trans, int color_type)
1353
png_debug(1, "in png_write_tRNS");
1355
if (color_type == PNG_COLOR_TYPE_PALETTE)
1357
if (num_trans <= 0 || num_trans > (int)png_ptr->num_palette)
1359
png_app_warning(png_ptr,
1360
"Invalid number of transparent colors specified");
1364
/* Write the chunk out as it is */
1365
png_write_complete_chunk(png_ptr, png_tRNS, trans_alpha,
1369
else if (color_type == PNG_COLOR_TYPE_GRAY)
1371
/* One 16-bit value */
1372
if (tran->gray >= (1 << png_ptr->bit_depth))
1374
png_app_warning(png_ptr,
1375
"Ignoring attempt to write tRNS chunk out-of-range for bit_depth");
1380
png_save_uint_16(buf, tran->gray);
1381
png_write_complete_chunk(png_ptr, png_tRNS, buf, 2);
1384
else if (color_type == PNG_COLOR_TYPE_RGB)
1386
/* Three 16-bit values */
1387
png_save_uint_16(buf, tran->red);
1388
png_save_uint_16(buf + 2, tran->green);
1389
png_save_uint_16(buf + 4, tran->blue);
1390
#ifdef PNG_WRITE_16BIT_SUPPORTED
1391
if (png_ptr->bit_depth == 8 && (buf[0] | buf[2] | buf[4]) != 0)
1393
if ((buf[0] | buf[2] | buf[4]) != 0)
1396
png_app_warning(png_ptr,
1397
"Ignoring attempt to write 16-bit tRNS chunk when bit_depth is 8");
1401
png_write_complete_chunk(png_ptr, png_tRNS, buf, 6);
1406
png_app_warning(png_ptr, "Can't write tRNS with an alpha channel");
1411
#ifdef PNG_WRITE_bKGD_SUPPORTED
1412
/* Write the background chunk */
1414
png_write_bKGD(png_structrp png_ptr, png_const_color_16p back, int color_type)
1418
png_debug(1, "in png_write_bKGD");
1420
if (color_type == PNG_COLOR_TYPE_PALETTE)
1423
#ifdef PNG_MNG_FEATURES_SUPPORTED
1424
(png_ptr->num_palette != 0 ||
1425
(png_ptr->mng_features_permitted & PNG_FLAG_MNG_EMPTY_PLTE) == 0) &&
1427
back->index >= png_ptr->num_palette)
1429
png_warning(png_ptr, "Invalid background palette index");
1433
buf[0] = back->index;
1434
png_write_complete_chunk(png_ptr, png_bKGD, buf, 1);
1437
else if ((color_type & PNG_COLOR_MASK_COLOR) != 0)
1439
png_save_uint_16(buf, back->red);
1440
png_save_uint_16(buf + 2, back->green);
1441
png_save_uint_16(buf + 4, back->blue);
1442
#ifdef PNG_WRITE_16BIT_SUPPORTED
1443
if (png_ptr->bit_depth == 8 && (buf[0] | buf[2] | buf[4]) != 0)
1445
if ((buf[0] | buf[2] | buf[4]) != 0)
1448
png_warning(png_ptr,
1449
"Ignoring attempt to write 16-bit bKGD chunk "
1450
"when bit_depth is 8");
1455
png_write_complete_chunk(png_ptr, png_bKGD, buf, 6);
1460
if (back->gray >= (1 << png_ptr->bit_depth))
1462
png_warning(png_ptr,
1463
"Ignoring attempt to write bKGD chunk out-of-range for bit_depth");
1468
png_save_uint_16(buf, back->gray);
1469
png_write_complete_chunk(png_ptr, png_bKGD, buf, 2);
1474
#ifdef PNG_WRITE_eXIf_SUPPORTED
1475
/* Write the Exif data */
1477
png_write_eXIf(png_structrp png_ptr, png_bytep exif, int num_exif)
1482
png_debug(1, "in png_write_eXIf");
1484
png_write_chunk_header(png_ptr, png_eXIf, (png_uint_32)(num_exif));
1486
for (i = 0; i < num_exif; i++)
1489
png_write_chunk_data(png_ptr, buf, 1);
1492
png_write_chunk_end(png_ptr);
1496
#ifdef PNG_WRITE_hIST_SUPPORTED
1497
/* Write the histogram */
1499
png_write_hIST(png_structrp png_ptr, png_const_uint_16p hist, int num_hist)
1504
png_debug(1, "in png_write_hIST");
1506
if (num_hist > (int)png_ptr->num_palette)
1508
png_debug2(3, "num_hist = %d, num_palette = %d", num_hist,
1509
png_ptr->num_palette);
1511
png_warning(png_ptr, "Invalid number of histogram entries specified");
1515
png_write_chunk_header(png_ptr, png_hIST, (png_uint_32)(num_hist * 2));
1517
for (i = 0; i < num_hist; i++)
1519
png_save_uint_16(buf, hist[i]);
1520
png_write_chunk_data(png_ptr, buf, 2);
1523
png_write_chunk_end(png_ptr);
1527
#ifdef PNG_WRITE_tEXt_SUPPORTED
1528
/* Write a tEXt chunk */
1530
png_write_tEXt(png_structrp png_ptr, png_const_charp key, png_const_charp text,
1533
png_uint_32 key_len;
1534
png_byte new_key[80];
1536
png_debug(1, "in png_write_tEXt");
1538
key_len = png_check_keyword(png_ptr, key, new_key);
1541
png_error(png_ptr, "tEXt: invalid keyword");
1543
if (text == NULL || *text == '\0')
1547
text_len = strlen(text);
1549
if (text_len > PNG_UINT_31_MAX - (key_len+1))
1550
png_error(png_ptr, "tEXt: text too long");
1552
/* Make sure we include the 0 after the key */
1553
png_write_chunk_header(png_ptr, png_tEXt,
1554
(png_uint_32)/*checked above*/(key_len + text_len + 1));
1556
* We leave it to the application to meet PNG-1.0 requirements on the
1557
* contents of the text. PNG-1.0 through PNG-1.2 discourage the use of
1558
* any non-Latin-1 characters except for NEWLINE. ISO PNG will forbid them.
1559
* The NUL character is forbidden by PNG-1.0 through PNG-1.2 and ISO PNG.
1561
png_write_chunk_data(png_ptr, new_key, key_len + 1);
1564
png_write_chunk_data(png_ptr, (png_const_bytep)text, text_len);
1566
png_write_chunk_end(png_ptr);
1570
#ifdef PNG_WRITE_zTXt_SUPPORTED
1571
/* Write a compressed text chunk */
1573
png_write_zTXt(png_structrp png_ptr, png_const_charp key, png_const_charp text,
1576
png_uint_32 key_len;
1577
png_byte new_key[81];
1578
compression_state comp;
1580
png_debug(1, "in png_write_zTXt");
1582
if (compression == PNG_TEXT_COMPRESSION_NONE)
1584
png_write_tEXt(png_ptr, key, text, 0);
1588
if (compression != PNG_TEXT_COMPRESSION_zTXt)
1589
png_error(png_ptr, "zTXt: invalid compression type");
1591
key_len = png_check_keyword(png_ptr, key, new_key);
1594
png_error(png_ptr, "zTXt: invalid keyword");
1596
/* Add the compression method and 1 for the keyword separator. */
1597
new_key[++key_len] = PNG_COMPRESSION_TYPE_BASE;
1600
/* Compute the compressed data; do it now for the length */
1601
png_text_compress_init(&comp, (png_const_bytep)text,
1602
text == NULL ? 0 : strlen(text));
1604
if (png_text_compress(png_ptr, png_zTXt, &comp, key_len) != Z_OK)
1605
png_error(png_ptr, png_ptr->zstream.msg);
1607
/* Write start of chunk */
1608
png_write_chunk_header(png_ptr, png_zTXt, key_len + comp.output_len);
1611
png_write_chunk_data(png_ptr, new_key, key_len);
1613
/* Write the compressed data */
1614
png_write_compressed_data_out(png_ptr, &comp);
1616
/* Close the chunk */
1617
png_write_chunk_end(png_ptr);
1621
#ifdef PNG_WRITE_iTXt_SUPPORTED
1622
/* Write an iTXt chunk */
1624
png_write_iTXt(png_structrp png_ptr, int compression, png_const_charp key,
1625
png_const_charp lang, png_const_charp lang_key, png_const_charp text)
1627
png_uint_32 key_len, prefix_len;
1628
size_t lang_len, lang_key_len;
1629
png_byte new_key[82];
1630
compression_state comp;
1632
png_debug(1, "in png_write_iTXt");
1634
key_len = png_check_keyword(png_ptr, key, new_key);
1637
png_error(png_ptr, "iTXt: invalid keyword");
1639
/* Set the compression flag */
1640
switch (compression)
1642
case PNG_ITXT_COMPRESSION_NONE:
1643
case PNG_TEXT_COMPRESSION_NONE:
1644
compression = new_key[++key_len] = 0; /* no compression */
1647
case PNG_TEXT_COMPRESSION_zTXt:
1648
case PNG_ITXT_COMPRESSION_zTXt:
1649
compression = new_key[++key_len] = 1; /* compressed */
1653
png_error(png_ptr, "iTXt: invalid compression");
1656
new_key[++key_len] = PNG_COMPRESSION_TYPE_BASE;
1657
++key_len; /* for the keywod separator */
1659
/* We leave it to the application to meet PNG-1.0 requirements on the
1660
* contents of the text. PNG-1.0 through PNG-1.2 discourage the use of
1661
* any non-Latin-1 characters except for NEWLINE. ISO PNG, however,
1662
* specifies that the text is UTF-8 and this really doesn't require any
1665
* The NUL character is forbidden by PNG-1.0 through PNG-1.2 and ISO PNG.
1667
* TODO: validate the language tag correctly (see the spec.)
1669
if (lang == NULL) lang = ""; /* empty language is valid */
1670
lang_len = strlen(lang)+1;
1671
if (lang_key == NULL) lang_key = ""; /* may be empty */
1672
lang_key_len = strlen(lang_key)+1;
1673
if (text == NULL) text = ""; /* may be empty */
1675
prefix_len = key_len;
1676
if (lang_len > PNG_UINT_31_MAX-prefix_len)
1677
prefix_len = PNG_UINT_31_MAX;
1679
prefix_len = (png_uint_32)(prefix_len + lang_len);
1681
if (lang_key_len > PNG_UINT_31_MAX-prefix_len)
1682
prefix_len = PNG_UINT_31_MAX;
1684
prefix_len = (png_uint_32)(prefix_len + lang_key_len);
1686
png_text_compress_init(&comp, (png_const_bytep)text, strlen(text));
1688
if (compression != 0)
1690
if (png_text_compress(png_ptr, png_iTXt, &comp, prefix_len) != Z_OK)
1691
png_error(png_ptr, png_ptr->zstream.msg);
1696
if (comp.input_len > PNG_UINT_31_MAX-prefix_len)
1697
png_error(png_ptr, "iTXt: uncompressed text too long");
1699
/* So the string will fit in a chunk: */
1700
comp.output_len = (png_uint_32)/*SAFE*/comp.input_len;
1703
png_write_chunk_header(png_ptr, png_iTXt, comp.output_len + prefix_len);
1705
png_write_chunk_data(png_ptr, new_key, key_len);
1707
png_write_chunk_data(png_ptr, (png_const_bytep)lang, lang_len);
1709
png_write_chunk_data(png_ptr, (png_const_bytep)lang_key, lang_key_len);
1711
if (compression != 0)
1712
png_write_compressed_data_out(png_ptr, &comp);
1715
png_write_chunk_data(png_ptr, (png_const_bytep)text, comp.output_len);
1717
png_write_chunk_end(png_ptr);
1721
#ifdef PNG_WRITE_oFFs_SUPPORTED
1722
/* Write the oFFs chunk */
1724
png_write_oFFs(png_structrp png_ptr, png_int_32 x_offset, png_int_32 y_offset,
1729
png_debug(1, "in png_write_oFFs");
1731
if (unit_type >= PNG_OFFSET_LAST)
1732
png_warning(png_ptr, "Unrecognized unit type for oFFs chunk");
1734
png_save_int_32(buf, x_offset);
1735
png_save_int_32(buf + 4, y_offset);
1736
buf[8] = (png_byte)unit_type;
1738
png_write_complete_chunk(png_ptr, png_oFFs, buf, 9);
1741
#ifdef PNG_WRITE_pCAL_SUPPORTED
1742
/* Write the pCAL chunk (described in the PNG extensions document) */
1744
png_write_pCAL(png_structrp png_ptr, png_charp purpose, png_int_32 X0,
1745
png_int_32 X1, int type, int nparams, png_const_charp units,
1748
png_uint_32 purpose_len;
1749
size_t units_len, total_len;
1752
png_byte new_purpose[80];
1755
png_debug1(1, "in png_write_pCAL (%d parameters)", nparams);
1757
if (type >= PNG_EQUATION_LAST)
1758
png_error(png_ptr, "Unrecognized equation type for pCAL chunk");
1760
purpose_len = png_check_keyword(png_ptr, purpose, new_purpose);
1762
if (purpose_len == 0)
1763
png_error(png_ptr, "pCAL: invalid keyword");
1765
++purpose_len; /* terminator */
1767
png_debug1(3, "pCAL purpose length = %d", (int)purpose_len);
1768
units_len = strlen(units) + (nparams == 0 ? 0 : 1);
1769
png_debug1(3, "pCAL units length = %d", (int)units_len);
1770
total_len = purpose_len + units_len + 10;
1772
params_len = (size_t *)png_malloc(png_ptr,
1773
(png_alloc_size_t)((png_alloc_size_t)nparams * (sizeof (size_t))));
1775
/* Find the length of each parameter, making sure we don't count the
1776
* null terminator for the last parameter.
1778
for (i = 0; i < nparams; i++)
1780
params_len[i] = strlen(params[i]) + (i == nparams - 1 ? 0 : 1);
1781
png_debug2(3, "pCAL parameter %d length = %lu", i,
1782
(unsigned long)params_len[i]);
1783
total_len += params_len[i];
1786
png_debug1(3, "pCAL total length = %d", (int)total_len);
1787
png_write_chunk_header(png_ptr, png_pCAL, (png_uint_32)total_len);
1788
png_write_chunk_data(png_ptr, new_purpose, purpose_len);
1789
png_save_int_32(buf, X0);
1790
png_save_int_32(buf + 4, X1);
1791
buf[8] = (png_byte)type;
1792
buf[9] = (png_byte)nparams;
1793
png_write_chunk_data(png_ptr, buf, 10);
1794
png_write_chunk_data(png_ptr, (png_const_bytep)units, (size_t)units_len);
1796
for (i = 0; i < nparams; i++)
1798
png_write_chunk_data(png_ptr, (png_const_bytep)params[i], params_len[i]);
1801
png_free(png_ptr, params_len);
1802
png_write_chunk_end(png_ptr);
1806
#ifdef PNG_WRITE_sCAL_SUPPORTED
1807
/* Write the sCAL chunk */
1809
png_write_sCAL_s(png_structrp png_ptr, int unit, png_const_charp width,
1810
png_const_charp height)
1813
size_t wlen, hlen, total_len;
1815
png_debug(1, "in png_write_sCAL_s");
1817
wlen = strlen(width);
1818
hlen = strlen(height);
1819
total_len = wlen + hlen + 2;
1823
png_warning(png_ptr, "Can't write sCAL (buffer too small)");
1827
buf[0] = (png_byte)unit;
1828
memcpy(buf + 1, width, wlen + 1); /* Append the '\0' here */
1829
memcpy(buf + wlen + 2, height, hlen); /* Do NOT append the '\0' here */
1831
png_debug1(3, "sCAL total length = %u", (unsigned int)total_len);
1832
png_write_complete_chunk(png_ptr, png_sCAL, buf, total_len);
1836
#ifdef PNG_WRITE_pHYs_SUPPORTED
1837
/* Write the pHYs chunk */
1839
png_write_pHYs(png_structrp png_ptr, png_uint_32 x_pixels_per_unit,
1840
png_uint_32 y_pixels_per_unit,
1845
png_debug(1, "in png_write_pHYs");
1847
if (unit_type >= PNG_RESOLUTION_LAST)
1848
png_warning(png_ptr, "Unrecognized unit type for pHYs chunk");
1850
png_save_uint_32(buf, x_pixels_per_unit);
1851
png_save_uint_32(buf + 4, y_pixels_per_unit);
1852
buf[8] = (png_byte)unit_type;
1854
png_write_complete_chunk(png_ptr, png_pHYs, buf, 9);
1858
#ifdef PNG_WRITE_tIME_SUPPORTED
1859
/* Write the tIME chunk. Use either png_convert_from_struct_tm()
1860
* or png_convert_from_time_t(), or fill in the structure yourself.
1863
png_write_tIME(png_structrp png_ptr, png_const_timep mod_time)
1867
png_debug(1, "in png_write_tIME");
1869
if (mod_time->month > 12 || mod_time->month < 1 ||
1870
mod_time->day > 31 || mod_time->day < 1 ||
1871
mod_time->hour > 23 || mod_time->second > 60)
1873
png_warning(png_ptr, "Invalid time specified for tIME chunk");
1877
png_save_uint_16(buf, mod_time->year);
1878
buf[2] = mod_time->month;
1879
buf[3] = mod_time->day;
1880
buf[4] = mod_time->hour;
1881
buf[5] = mod_time->minute;
1882
buf[6] = mod_time->second;
1884
png_write_complete_chunk(png_ptr, png_tIME, buf, 7);
1888
/* Initializes the row writing capability of libpng */
1890
png_write_start_row(png_structrp png_ptr)
1892
#ifdef PNG_WRITE_INTERLACING_SUPPORTED
1893
/* Arrays to facilitate easy interlacing - use pass (0 - 6) as index */
1895
/* Start of interlace block */
1896
static const png_byte png_pass_start[7] = {0, 4, 0, 2, 0, 1, 0};
1898
/* Offset to next interlace block */
1899
static const png_byte png_pass_inc[7] = {8, 8, 4, 4, 2, 2, 1};
1901
/* Start of interlace block in the y direction */
1902
static const png_byte png_pass_ystart[7] = {0, 0, 4, 0, 2, 0, 1};
1904
/* Offset to next interlace block in the y direction */
1905
static const png_byte png_pass_yinc[7] = {8, 8, 8, 4, 4, 2, 2};
1908
png_alloc_size_t buf_size;
1909
int usr_pixel_depth;
1911
#ifdef PNG_WRITE_FILTER_SUPPORTED
1915
png_debug(1, "in png_write_start_row");
1917
usr_pixel_depth = png_ptr->usr_channels * png_ptr->usr_bit_depth;
1918
buf_size = PNG_ROWBYTES(usr_pixel_depth, png_ptr->width) + 1;
1920
/* 1.5.6: added to allow checking in the row write code. */
1921
png_ptr->transformed_pixel_depth = png_ptr->pixel_depth;
1922
png_ptr->maximum_pixel_depth = (png_byte)usr_pixel_depth;
1924
/* Set up row buffer */
1925
png_ptr->row_buf = png_voidcast(png_bytep, png_malloc(png_ptr, buf_size));
1927
png_ptr->row_buf[0] = PNG_FILTER_VALUE_NONE;
1929
#ifdef PNG_WRITE_FILTER_SUPPORTED
1930
filters = png_ptr->do_filter;
1932
if (png_ptr->height == 1)
1933
filters &= 0xff & ~(PNG_FILTER_UP|PNG_FILTER_AVG|PNG_FILTER_PAETH);
1935
if (png_ptr->width == 1)
1936
filters &= 0xff & ~(PNG_FILTER_SUB|PNG_FILTER_AVG|PNG_FILTER_PAETH);
1939
filters = PNG_FILTER_NONE;
1941
png_ptr->do_filter = filters;
1943
if (((filters & (PNG_FILTER_SUB | PNG_FILTER_UP | PNG_FILTER_AVG |
1944
PNG_FILTER_PAETH)) != 0) && png_ptr->try_row == NULL)
1946
int num_filters = 0;
1948
png_ptr->try_row = png_voidcast(png_bytep, png_malloc(png_ptr, buf_size));
1950
if (filters & PNG_FILTER_SUB)
1953
if (filters & PNG_FILTER_UP)
1956
if (filters & PNG_FILTER_AVG)
1959
if (filters & PNG_FILTER_PAETH)
1962
if (num_filters > 1)
1963
png_ptr->tst_row = png_voidcast(png_bytep, png_malloc(png_ptr,
1967
/* We only need to keep the previous row if we are using one of the following
1970
if ((filters & (PNG_FILTER_AVG | PNG_FILTER_UP | PNG_FILTER_PAETH)) != 0)
1971
png_ptr->prev_row = png_voidcast(png_bytep,
1972
png_calloc(png_ptr, buf_size));
1973
#endif /* WRITE_FILTER */
1975
#ifdef PNG_WRITE_INTERLACING_SUPPORTED
1976
/* If interlaced, we need to set up width and height of pass */
1977
if (png_ptr->interlaced != 0)
1979
if ((png_ptr->transformations & PNG_INTERLACE) == 0)
1981
png_ptr->num_rows = (png_ptr->height + png_pass_yinc[0] - 1 -
1982
png_pass_ystart[0]) / png_pass_yinc[0];
1984
png_ptr->usr_width = (png_ptr->width + png_pass_inc[0] - 1 -
1985
png_pass_start[0]) / png_pass_inc[0];
1990
png_ptr->num_rows = png_ptr->height;
1991
png_ptr->usr_width = png_ptr->width;
1998
png_ptr->num_rows = png_ptr->height;
1999
png_ptr->usr_width = png_ptr->width;
2003
/* Internal use only. Called when finished processing a row of data. */
2005
png_write_finish_row(png_structrp png_ptr)
2007
#ifdef PNG_WRITE_INTERLACING_SUPPORTED
2008
/* Arrays to facilitate easy interlacing - use pass (0 - 6) as index */
2010
/* Start of interlace block */
2011
static const png_byte png_pass_start[7] = {0, 4, 0, 2, 0, 1, 0};
2013
/* Offset to next interlace block */
2014
static const png_byte png_pass_inc[7] = {8, 8, 4, 4, 2, 2, 1};
2016
/* Start of interlace block in the y direction */
2017
static const png_byte png_pass_ystart[7] = {0, 0, 4, 0, 2, 0, 1};
2019
/* Offset to next interlace block in the y direction */
2020
static const png_byte png_pass_yinc[7] = {8, 8, 8, 4, 4, 2, 2};
2023
png_debug(1, "in png_write_finish_row");
2026
png_ptr->row_number++;
2028
/* See if we are done */
2029
if (png_ptr->row_number < png_ptr->num_rows)
2032
#ifdef PNG_WRITE_INTERLACING_SUPPORTED
2033
/* If interlaced, go to next pass */
2034
if (png_ptr->interlaced != 0)
2036
png_ptr->row_number = 0;
2037
if ((png_ptr->transformations & PNG_INTERLACE) != 0)
2044
/* Loop until we find a non-zero width or height pass */
2049
if (png_ptr->pass >= 7)
2052
png_ptr->usr_width = (png_ptr->width +
2053
png_pass_inc[png_ptr->pass] - 1 -
2054
png_pass_start[png_ptr->pass]) /
2055
png_pass_inc[png_ptr->pass];
2057
png_ptr->num_rows = (png_ptr->height +
2058
png_pass_yinc[png_ptr->pass] - 1 -
2059
png_pass_ystart[png_ptr->pass]) /
2060
png_pass_yinc[png_ptr->pass];
2062
if ((png_ptr->transformations & PNG_INTERLACE) != 0)
2065
} while (png_ptr->usr_width == 0 || png_ptr->num_rows == 0);
2069
/* Reset the row above the image for the next pass */
2070
if (png_ptr->pass < 7)
2072
if (png_ptr->prev_row != NULL)
2073
memset(png_ptr->prev_row, 0,
2074
PNG_ROWBYTES(png_ptr->usr_channels *
2075
png_ptr->usr_bit_depth, png_ptr->width) + 1);
2082
/* If we get here, we've just written the last row, so we need
2083
to flush the compressor */
2084
png_compress_IDAT(png_ptr, NULL, 0, Z_FINISH);
2087
#ifdef PNG_WRITE_INTERLACING_SUPPORTED
2088
/* Pick out the correct pixels for the interlace pass.
2089
* The basic idea here is to go through the row with a source
2090
* pointer and a destination pointer (sp and dp), and copy the
2091
* correct pixels for the pass. As the row gets compacted,
2092
* sp will always be >= dp, so we should never overwrite anything.
2093
* See the default: case for the easiest code to understand.
2096
png_do_write_interlace(png_row_infop row_info, png_bytep row, int pass)
2098
/* Arrays to facilitate easy interlacing - use pass (0 - 6) as index */
2100
/* Start of interlace block */
2101
static const png_byte png_pass_start[7] = {0, 4, 0, 2, 0, 1, 0};
2103
/* Offset to next interlace block */
2104
static const png_byte png_pass_inc[7] = {8, 8, 4, 4, 2, 2, 1};
2106
png_debug(1, "in png_do_write_interlace");
2108
/* We don't have to do anything on the last pass (6) */
2111
/* Each pixel depth is handled separately */
2112
switch (row_info->pixel_depth)
2122
png_uint_32 row_width = row_info->width;
2128
for (i = png_pass_start[pass]; i < row_width;
2129
i += png_pass_inc[pass])
2131
sp = row + (size_t)(i >> 3);
2132
value = (int)(*sp >> (7 - (int)(i & 0x07))) & 0x01;
2133
d |= (value << shift);
2138
*dp++ = (png_byte)d;
2160
png_uint_32 row_width = row_info->width;
2166
for (i = png_pass_start[pass]; i < row_width;
2167
i += png_pass_inc[pass])
2169
sp = row + (size_t)(i >> 2);
2170
value = (*sp >> ((3 - (int)(i & 0x03)) << 1)) & 0x03;
2171
d |= (value << shift);
2176
*dp++ = (png_byte)d;
2197
png_uint_32 row_width = row_info->width;
2202
for (i = png_pass_start[pass]; i < row_width;
2203
i += png_pass_inc[pass])
2205
sp = row + (size_t)(i >> 1);
2206
value = (*sp >> ((1 - (int)(i & 0x01)) << 2)) & 0x0f;
2207
d |= (value << shift);
2212
*dp++ = (png_byte)d;
2230
png_uint_32 row_width = row_info->width;
2233
/* Start at the beginning */
2236
/* Find out how many bytes each pixel takes up */
2237
pixel_bytes = (row_info->pixel_depth >> 3);
2239
/* Loop through the row, only looking at the pixels that matter */
2240
for (i = png_pass_start[pass]; i < row_width;
2241
i += png_pass_inc[pass])
2243
/* Find out where the original pixel is */
2244
sp = row + (size_t)i * pixel_bytes;
2246
/* Move the pixel */
2248
memcpy(dp, sp, pixel_bytes);
2256
/* Set new row width */
2257
row_info->width = (row_info->width +
2258
png_pass_inc[pass] - 1 -
2259
png_pass_start[pass]) /
2262
row_info->rowbytes = PNG_ROWBYTES(row_info->pixel_depth,
2269
/* This filters the row, chooses which filter to use, if it has not already
2270
* been specified by the application, and then writes the row out with the
2273
static void /* PRIVATE */
2274
png_write_filtered_row(png_structrp png_ptr, png_bytep filtered_row,
2277
#ifdef PNG_WRITE_FILTER_SUPPORTED
2278
static size_t /* PRIVATE */
2279
png_setup_sub_row(png_structrp png_ptr, png_uint_32 bpp,
2280
size_t row_bytes, size_t lmins)
2282
png_bytep rp, dp, lp;
2287
png_ptr->try_row[0] = PNG_FILTER_VALUE_SUB;
2289
for (i = 0, rp = png_ptr->row_buf + 1, dp = png_ptr->try_row + 1; i < bpp;
2294
sum += 128 - abs((int)v - 128);
2296
sum += (v < 128) ? v : 256 - v;
2300
for (lp = png_ptr->row_buf + 1; i < row_bytes;
2301
i++, rp++, lp++, dp++)
2303
v = *dp = (png_byte)(((int)*rp - (int)*lp) & 0xff);
2305
sum += 128 - abs((int)v - 128);
2307
sum += (v < 128) ? v : 256 - v;
2310
if (sum > lmins) /* We are already worse, don't continue. */
2317
static void /* PRIVATE */
2318
png_setup_sub_row_only(png_structrp png_ptr, png_uint_32 bpp,
2321
png_bytep rp, dp, lp;
2324
png_ptr->try_row[0] = PNG_FILTER_VALUE_SUB;
2326
for (i = 0, rp = png_ptr->row_buf + 1, dp = png_ptr->try_row + 1; i < bpp;
2332
for (lp = png_ptr->row_buf + 1; i < row_bytes;
2333
i++, rp++, lp++, dp++)
2335
*dp = (png_byte)(((int)*rp - (int)*lp) & 0xff);
2339
static size_t /* PRIVATE */
2340
png_setup_up_row(png_structrp png_ptr, size_t row_bytes, size_t lmins)
2342
png_bytep rp, dp, pp;
2347
png_ptr->try_row[0] = PNG_FILTER_VALUE_UP;
2349
for (i = 0, rp = png_ptr->row_buf + 1, dp = png_ptr->try_row + 1,
2350
pp = png_ptr->prev_row + 1; i < row_bytes;
2351
i++, rp++, pp++, dp++)
2353
v = *dp = (png_byte)(((int)*rp - (int)*pp) & 0xff);
2355
sum += 128 - abs((int)v - 128);
2357
sum += (v < 128) ? v : 256 - v;
2360
if (sum > lmins) /* We are already worse, don't continue. */
2366
static void /* PRIVATE */
2367
png_setup_up_row_only(png_structrp png_ptr, size_t row_bytes)
2369
png_bytep rp, dp, pp;
2372
png_ptr->try_row[0] = PNG_FILTER_VALUE_UP;
2374
for (i = 0, rp = png_ptr->row_buf + 1, dp = png_ptr->try_row + 1,
2375
pp = png_ptr->prev_row + 1; i < row_bytes;
2376
i++, rp++, pp++, dp++)
2378
*dp = (png_byte)(((int)*rp - (int)*pp) & 0xff);
2382
static size_t /* PRIVATE */
2383
png_setup_avg_row(png_structrp png_ptr, png_uint_32 bpp,
2384
size_t row_bytes, size_t lmins)
2386
png_bytep rp, dp, pp, lp;
2391
png_ptr->try_row[0] = PNG_FILTER_VALUE_AVG;
2393
for (i = 0, rp = png_ptr->row_buf + 1, dp = png_ptr->try_row + 1,
2394
pp = png_ptr->prev_row + 1; i < bpp; i++)
2396
v = *dp++ = (png_byte)(((int)*rp++ - ((int)*pp++ / 2)) & 0xff);
2399
sum += 128 - abs((int)v - 128);
2401
sum += (v < 128) ? v : 256 - v;
2405
for (lp = png_ptr->row_buf + 1; i < row_bytes; i++)
2407
v = *dp++ = (png_byte)(((int)*rp++ - (((int)*pp++ + (int)*lp++) / 2))
2411
sum += 128 - abs((int)v - 128);
2413
sum += (v < 128) ? v : 256 - v;
2416
if (sum > lmins) /* We are already worse, don't continue. */
2422
static void /* PRIVATE */
2423
png_setup_avg_row_only(png_structrp png_ptr, png_uint_32 bpp,
2426
png_bytep rp, dp, pp, lp;
2429
png_ptr->try_row[0] = PNG_FILTER_VALUE_AVG;
2431
for (i = 0, rp = png_ptr->row_buf + 1, dp = png_ptr->try_row + 1,
2432
pp = png_ptr->prev_row + 1; i < bpp; i++)
2434
*dp++ = (png_byte)(((int)*rp++ - ((int)*pp++ / 2)) & 0xff);
2437
for (lp = png_ptr->row_buf + 1; i < row_bytes; i++)
2439
*dp++ = (png_byte)(((int)*rp++ - (((int)*pp++ + (int)*lp++) / 2))
2444
static size_t /* PRIVATE */
2445
png_setup_paeth_row(png_structrp png_ptr, png_uint_32 bpp,
2446
size_t row_bytes, size_t lmins)
2448
png_bytep rp, dp, pp, cp, lp;
2453
png_ptr->try_row[0] = PNG_FILTER_VALUE_PAETH;
2455
for (i = 0, rp = png_ptr->row_buf + 1, dp = png_ptr->try_row + 1,
2456
pp = png_ptr->prev_row + 1; i < bpp; i++)
2458
v = *dp++ = (png_byte)(((int)*rp++ - (int)*pp++) & 0xff);
2461
sum += 128 - abs((int)v - 128);
2463
sum += (v < 128) ? v : 256 - v;
2467
for (lp = png_ptr->row_buf + 1, cp = png_ptr->prev_row + 1; i < row_bytes;
2470
int a, b, c, pa, pb, pc, p;
2484
pa = p < 0 ? -p : p;
2485
pb = pc < 0 ? -pc : pc;
2486
pc = (p + pc) < 0 ? -(p + pc) : p + pc;
2489
p = (pa <= pb && pa <=pc) ? a : (pb <= pc) ? b : c;
2491
v = *dp++ = (png_byte)(((int)*rp++ - p) & 0xff);
2494
sum += 128 - abs((int)v - 128);
2496
sum += (v < 128) ? v : 256 - v;
2499
if (sum > lmins) /* We are already worse, don't continue. */
2505
static void /* PRIVATE */
2506
png_setup_paeth_row_only(png_structrp png_ptr, png_uint_32 bpp,
2509
png_bytep rp, dp, pp, cp, lp;
2512
png_ptr->try_row[0] = PNG_FILTER_VALUE_PAETH;
2514
for (i = 0, rp = png_ptr->row_buf + 1, dp = png_ptr->try_row + 1,
2515
pp = png_ptr->prev_row + 1; i < bpp; i++)
2517
*dp++ = (png_byte)(((int)*rp++ - (int)*pp++) & 0xff);
2520
for (lp = png_ptr->row_buf + 1, cp = png_ptr->prev_row + 1; i < row_bytes;
2523
int a, b, c, pa, pb, pc, p;
2537
pa = p < 0 ? -p : p;
2538
pb = pc < 0 ? -pc : pc;
2539
pc = (p + pc) < 0 ? -(p + pc) : p + pc;
2542
p = (pa <= pb && pa <=pc) ? a : (pb <= pc) ? b : c;
2544
*dp++ = (png_byte)(((int)*rp++ - p) & 0xff);
2547
#endif /* WRITE_FILTER */
2550
png_write_find_filter(png_structrp png_ptr, png_row_infop row_info)
2552
#ifndef PNG_WRITE_FILTER_SUPPORTED
2553
png_write_filtered_row(png_ptr, png_ptr->row_buf, row_info->rowbytes+1);
2555
unsigned int filter_to_do = png_ptr->do_filter;
2560
size_t row_bytes = row_info->rowbytes;
2562
png_debug(1, "in png_write_find_filter");
2564
/* Find out how many bytes offset each pixel is */
2565
bpp = (row_info->pixel_depth + 7) >> 3;
2567
row_buf = png_ptr->row_buf;
2568
mins = PNG_SIZE_MAX - 256/* so we can detect potential overflow of the
2571
/* The prediction method we use is to find which method provides the
2572
* smallest value when summing the absolute values of the distances
2573
* from zero, using anything >= 128 as negative numbers. This is known
2574
* as the "minimum sum of absolute differences" heuristic. Other
2575
* heuristics are the "weighted minimum sum of absolute differences"
2576
* (experimental and can in theory improve compression), and the "zlib
2577
* predictive" method (not implemented yet), which does test compressions
2578
* of lines using different filter methods, and then chooses the
2579
* (series of) filter(s) that give minimum compressed data size (VERY
2580
* computationally expensive).
2582
* GRR 980525: consider also
2584
* (1) minimum sum of absolute differences from running average (i.e.,
2585
* keep running sum of non-absolute differences & count of bytes)
2586
* [track dispersion, too? restart average if dispersion too large?]
2588
* (1b) minimum sum of absolute differences from sliding average, probably
2589
* with window size <= deflate window (usually 32K)
2591
* (2) minimum sum of squared differences from zero or running average
2592
* (i.e., ~ root-mean-square approach)
2596
/* We don't need to test the 'no filter' case if this is the only filter
2597
* that has been chosen, as it doesn't actually do anything to the data.
2599
best_row = png_ptr->row_buf;
2601
if (PNG_SIZE_MAX/128 <= row_bytes)
2603
/* Overflow can occur in the calculation, just select the lowest set
2606
filter_to_do &= 0U-filter_to_do;
2608
else if ((filter_to_do & PNG_FILTER_NONE) != 0 &&
2609
filter_to_do != PNG_FILTER_NONE)
2611
/* Overflow not possible and multiple filters in the list, including the
2620
for (i = 0, rp = row_buf + 1; i < row_bytes; i++, rp++)
2624
sum += 128 - abs((int)v - 128);
2626
sum += (v < 128) ? v : 256 - v;
2635
if (filter_to_do == PNG_FILTER_SUB)
2636
/* It's the only filter so no testing is needed */
2638
png_setup_sub_row_only(png_ptr, bpp, row_bytes);
2639
best_row = png_ptr->try_row;
2642
else if ((filter_to_do & PNG_FILTER_SUB) != 0)
2645
size_t lmins = mins;
2647
sum = png_setup_sub_row(png_ptr, bpp, row_bytes, lmins);
2652
best_row = png_ptr->try_row;
2653
if (png_ptr->tst_row != NULL)
2655
png_ptr->try_row = png_ptr->tst_row;
2656
png_ptr->tst_row = best_row;
2662
if (filter_to_do == PNG_FILTER_UP)
2664
png_setup_up_row_only(png_ptr, row_bytes);
2665
best_row = png_ptr->try_row;
2668
else if ((filter_to_do & PNG_FILTER_UP) != 0)
2671
size_t lmins = mins;
2673
sum = png_setup_up_row(png_ptr, row_bytes, lmins);
2678
best_row = png_ptr->try_row;
2679
if (png_ptr->tst_row != NULL)
2681
png_ptr->try_row = png_ptr->tst_row;
2682
png_ptr->tst_row = best_row;
2688
if (filter_to_do == PNG_FILTER_AVG)
2690
png_setup_avg_row_only(png_ptr, bpp, row_bytes);
2691
best_row = png_ptr->try_row;
2694
else if ((filter_to_do & PNG_FILTER_AVG) != 0)
2697
size_t lmins = mins;
2699
sum= png_setup_avg_row(png_ptr, bpp, row_bytes, lmins);
2704
best_row = png_ptr->try_row;
2705
if (png_ptr->tst_row != NULL)
2707
png_ptr->try_row = png_ptr->tst_row;
2708
png_ptr->tst_row = best_row;
2714
if (filter_to_do == PNG_FILTER_PAETH)
2716
png_setup_paeth_row_only(png_ptr, bpp, row_bytes);
2717
best_row = png_ptr->try_row;
2720
else if ((filter_to_do & PNG_FILTER_PAETH) != 0)
2723
size_t lmins = mins;
2725
sum = png_setup_paeth_row(png_ptr, bpp, row_bytes, lmins);
2729
best_row = png_ptr->try_row;
2730
if (png_ptr->tst_row != NULL)
2732
png_ptr->try_row = png_ptr->tst_row;
2733
png_ptr->tst_row = best_row;
2738
/* Do the actual writing of the filtered row data from the chosen filter. */
2739
png_write_filtered_row(png_ptr, best_row, row_info->rowbytes+1);
2741
#endif /* WRITE_FILTER */
2745
/* Do the actual writing of a previously filtered row. */
2747
png_write_filtered_row(png_structrp png_ptr, png_bytep filtered_row,
2748
size_t full_row_length/*includes filter byte*/)
2750
png_debug(1, "in png_write_filtered_row");
2752
png_debug1(2, "filter = %d", filtered_row[0]);
2754
png_compress_IDAT(png_ptr, filtered_row, full_row_length, Z_NO_FLUSH);
2756
#ifdef PNG_WRITE_FILTER_SUPPORTED
2757
/* Swap the current and previous rows */
2758
if (png_ptr->prev_row != NULL)
2762
tptr = png_ptr->prev_row;
2763
png_ptr->prev_row = png_ptr->row_buf;
2764
png_ptr->row_buf = tptr;
2766
#endif /* WRITE_FILTER */
2768
/* Finish row - updates counters and flushes zlib if last row */
2769
png_write_finish_row(png_ptr);
2771
#ifdef PNG_WRITE_FLUSH_SUPPORTED
2772
png_ptr->flush_rows++;
2774
if (png_ptr->flush_dist > 0 &&
2775
png_ptr->flush_rows >= png_ptr->flush_dist)
2777
png_write_flush(png_ptr);
2779
#endif /* WRITE_FLUSH */