This repository has been archived on 2023-11-11. You can view files and clone it, but cannot push or open issues or pull requests.
libpng/pngset.c

1254 lines
38 KiB
C
Raw Normal View History

1997-05-16 07:46:07 +00:00
/* pngset.c - storage of image information into info struct
1998-01-01 13:13:13 +00:00
*
2009-02-14 21:59:43 +00:00
* Last changed in libpng 1.2.35 [February 14, 2009]
1998-01-01 13:13:13 +00:00
* For conditions of distribution and use, see copyright notice in png.h
2009-02-04 19:11:41 +00:00
* Copyright (c) 1998-2009 Glenn Randers-Pehrson
2000-06-04 19:29:29 +00:00
* (Version 0.96 Copyright (c) 1996, 1997 Andreas Dilger)
* (Version 0.88 Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.)
1998-01-01 13:13:13 +00:00
*
* The functions here are used during reads to store data from the file
* into the info struct, and during writes to store application data
* into the info struct for writing into the file. This abstracts the
* info struct and allows us to change the structure in the future.
*/
1997-05-16 07:46:07 +00:00
#define PNG_INTERNAL
#include "png.h"
2006-02-21 04:09:05 +00:00
#if defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED)
1999-12-10 15:43:02 +00:00
#if defined(PNG_bKGD_SUPPORTED)
2000-05-06 19:09:57 +00:00
void PNGAPI
1997-05-16 07:46:07 +00:00
png_set_bKGD(png_structp png_ptr, png_infop info_ptr, png_color_16p background)
{
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", "bKGD");
1998-02-09 02:56:40 +00:00
if (png_ptr == NULL || info_ptr == NULL)
1997-05-16 07:46:07 +00:00
return;
2004-07-28 13:20:44 +00:00
png_memcpy(&(info_ptr->background), background, png_sizeof(png_color_16));
1997-05-16 07:46:07 +00:00
info_ptr->valid |= PNG_INFO_bKGD;
}
#endif
1999-12-10 15:43:02 +00:00
#if defined(PNG_cHRM_SUPPORTED)
#ifdef PNG_FLOATING_POINT_SUPPORTED
2000-05-06 19:09:57 +00:00
void PNGAPI
1997-05-16 07:46:07 +00:00
png_set_cHRM(png_structp png_ptr, png_infop info_ptr,
double white_x, double white_y, double red_x, double red_y,
double green_x, double green_y, double blue_x, double blue_y)
{
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", "cHRM");
1998-02-09 02:56:40 +00:00
if (png_ptr == NULL || info_ptr == NULL)
1997-05-16 07:46:07 +00:00
return;
2002-02-22 05:14:23 +00:00
1997-05-16 07:46:07 +00:00
info_ptr->x_white = (float)white_x;
info_ptr->y_white = (float)white_y;
info_ptr->x_red = (float)red_x;
info_ptr->y_red = (float)red_y;
info_ptr->x_green = (float)green_x;
info_ptr->y_green = (float)green_y;
info_ptr->x_blue = (float)blue_x;
info_ptr->y_blue = (float)blue_y;
2000-02-05 05:40:16 +00:00
#ifdef PNG_FIXED_POINT_SUPPORTED
info_ptr->int_x_white = (png_fixed_point)(white_x*100000.+0.5);
info_ptr->int_y_white = (png_fixed_point)(white_y*100000.+0.5);
2002-02-22 05:14:23 +00:00
info_ptr->int_x_red = (png_fixed_point)( red_x*100000.+0.5);
info_ptr->int_y_red = (png_fixed_point)( red_y*100000.+0.5);
2000-02-05 05:40:16 +00:00
info_ptr->int_x_green = (png_fixed_point)(green_x*100000.+0.5);
info_ptr->int_y_green = (png_fixed_point)(green_y*100000.+0.5);
2002-02-22 05:14:23 +00:00
info_ptr->int_x_blue = (png_fixed_point)( blue_x*100000.+0.5);
info_ptr->int_y_blue = (png_fixed_point)( blue_y*100000.+0.5);
2000-02-05 05:40:16 +00:00
#endif
1997-05-16 07:46:07 +00:00
info_ptr->valid |= PNG_INFO_cHRM;
}
2009-02-04 19:11:41 +00:00
#endif /* PNG_FLOATING_POINT_SUPPORTED */
1999-12-10 15:43:02 +00:00
#ifdef PNG_FIXED_POINT_SUPPORTED
2000-05-06 19:09:57 +00:00
void PNGAPI
1999-12-10 15:43:02 +00:00
png_set_cHRM_fixed(png_structp png_ptr, png_infop info_ptr,
2000-02-05 05:40:16 +00:00
png_fixed_point white_x, png_fixed_point white_y, png_fixed_point red_x,
png_fixed_point red_y, png_fixed_point green_x, png_fixed_point green_y,
png_fixed_point blue_x, png_fixed_point blue_y)
1999-12-10 15:43:02 +00:00
{
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", "cHRM fixed");
1999-12-10 15:43:02 +00:00
if (png_ptr == NULL || info_ptr == NULL)
return;
1997-05-16 07:46:07 +00:00
2008-11-27 12:44:23 +00:00
#if !defined(PNG_NO_CHECK_cHRM)
if (png_check_cHRM_fixed(png_ptr,
white_x, white_y, red_x, red_y, green_x, green_y, blue_x, blue_y))
#endif
2002-02-22 05:14:23 +00:00
{
2008-11-27 12:44:23 +00:00
info_ptr->int_x_white = white_x;
info_ptr->int_y_white = white_y;
info_ptr->int_x_red = red_x;
info_ptr->int_y_red = red_y;
info_ptr->int_x_green = green_x;
info_ptr->int_y_green = green_y;
info_ptr->int_x_blue = blue_x;
info_ptr->int_y_blue = blue_y;
2000-02-05 05:40:16 +00:00
#ifdef PNG_FLOATING_POINT_SUPPORTED
2008-11-27 12:44:23 +00:00
info_ptr->x_white = (float)(white_x/100000.);
info_ptr->y_white = (float)(white_y/100000.);
info_ptr->x_red = (float)( red_x/100000.);
info_ptr->y_red = (float)( red_y/100000.);
info_ptr->x_green = (float)(green_x/100000.);
info_ptr->y_green = (float)(green_y/100000.);
info_ptr->x_blue = (float)( blue_x/100000.);
info_ptr->y_blue = (float)( blue_y/100000.);
#endif
info_ptr->valid |= PNG_INFO_cHRM;
}
1999-12-10 15:43:02 +00:00
}
2008-11-27 12:44:23 +00:00
#endif /* PNG_FIXED_POINT_SUPPORTED */
#endif /* PNG_cHRM_SUPPORTED */
1999-12-10 15:43:02 +00:00
#if defined(PNG_gAMA_SUPPORTED)
#ifdef PNG_FLOATING_POINT_SUPPORTED
2000-05-06 19:09:57 +00:00
void PNGAPI
1997-05-16 07:46:07 +00:00
png_set_gAMA(png_structp png_ptr, png_infop info_ptr, double file_gamma)
{
2002-02-22 05:14:23 +00:00
double gamma;
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", "gAMA");
1998-02-09 02:56:40 +00:00
if (png_ptr == NULL || info_ptr == NULL)
1997-05-16 07:46:07 +00:00
return;
2002-02-22 05:14:23 +00:00
/* Check for overflow */
if (file_gamma > 21474.83)
{
png_warning(png_ptr, "Limiting gamma to 21474.83");
gamma=21474.83;
}
else
2008-07-25 13:38:43 +00:00
gamma = file_gamma;
2002-02-22 05:14:23 +00:00
info_ptr->gamma = (float)gamma;
1999-12-10 15:43:02 +00:00
#ifdef PNG_FIXED_POINT_SUPPORTED
2002-02-22 05:14:23 +00:00
info_ptr->int_gamma = (int)(gamma*100000.+.5);
1999-12-10 15:43:02 +00:00
#endif
info_ptr->valid |= PNG_INFO_gAMA;
2008-07-10 14:10:58 +00:00
if (gamma == 0.0)
2001-05-07 19:52:45 +00:00
png_warning(png_ptr, "Setting gamma=0");
1999-12-10 15:43:02 +00:00
}
#endif
2000-05-06 19:09:57 +00:00
void PNGAPI
2000-02-05 05:40:16 +00:00
png_set_gAMA_fixed(png_structp png_ptr, png_infop info_ptr, png_fixed_point
int_gamma)
1999-12-10 15:43:02 +00:00
{
2002-02-22 05:14:23 +00:00
png_fixed_point gamma;
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", "gAMA");
1999-12-10 15:43:02 +00:00
if (png_ptr == NULL || info_ptr == NULL)
return;
2004-07-28 13:20:44 +00:00
if (int_gamma > (png_fixed_point) PNG_UINT_31_MAX)
2002-02-22 05:14:23 +00:00
{
png_warning(png_ptr, "Limiting gamma to 21474.83");
2004-07-28 13:20:44 +00:00
gamma=PNG_UINT_31_MAX;
2002-02-22 05:14:23 +00:00
}
else
{
if (int_gamma < 0)
{
png_warning(png_ptr, "Setting negative gamma to zero");
2008-07-10 14:10:58 +00:00
gamma = 0;
2002-02-22 05:14:23 +00:00
}
else
2008-07-25 13:38:43 +00:00
gamma = int_gamma;
2002-02-22 05:14:23 +00:00
}
1999-12-10 15:43:02 +00:00
#ifdef PNG_FLOATING_POINT_SUPPORTED
2002-02-22 05:14:23 +00:00
info_ptr->gamma = (float)(gamma/100000.);
1999-12-10 15:43:02 +00:00
#endif
2000-05-01 14:31:54 +00:00
#ifdef PNG_FIXED_POINT_SUPPORTED
2002-02-22 05:14:23 +00:00
info_ptr->int_gamma = gamma;
2000-05-01 14:31:54 +00:00
#endif
1997-05-16 07:46:07 +00:00
info_ptr->valid |= PNG_INFO_gAMA;
2008-07-10 14:10:58 +00:00
if (gamma == 0)
2001-05-07 19:52:45 +00:00
png_warning(png_ptr, "Setting gamma=0");
1997-05-16 07:46:07 +00:00
}
2001-05-07 19:52:45 +00:00
#endif
1997-05-16 07:46:07 +00:00
1999-12-10 15:43:02 +00:00
#if defined(PNG_hIST_SUPPORTED)
2000-05-06 19:09:57 +00:00
void PNGAPI
1997-05-16 07:46:07 +00:00
png_set_hIST(png_structp png_ptr, png_infop info_ptr, png_uint_16p hist)
{
2002-06-20 11:54:34 +00:00
int i;
2000-12-28 13:50:05 +00:00
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", "hIST");
1998-02-09 02:56:40 +00:00
if (png_ptr == NULL || info_ptr == NULL)
1997-05-16 07:46:07 +00:00
return;
2007-09-14 15:24:18 +00:00
if (info_ptr->num_palette == 0 || info_ptr->num_palette
2006-02-21 04:09:05 +00:00
> PNG_MAX_PALETTE_LENGTH)
2001-05-07 19:52:45 +00:00
{
2000-12-28 13:50:05 +00:00
png_warning(png_ptr,
2006-02-21 04:09:05 +00:00
"Invalid palette size, hIST allocation skipped.");
2001-05-07 19:52:45 +00:00
return;
}
2000-12-28 13:50:05 +00:00
#ifdef PNG_FREE_ME_SUPPORTED
png_free_data(png_ptr, info_ptr, PNG_FREE_HIST, 0);
#endif
2006-02-21 04:09:05 +00:00
/* Changed from info->num_palette to PNG_MAX_PALETTE_LENGTH in version
1.2.1 */
2002-05-25 16:12:10 +00:00
png_ptr->hist = (png_uint_16p)png_malloc_warn(png_ptr,
2008-07-06 11:05:04 +00:00
(png_uint_32)(PNG_MAX_PALETTE_LENGTH * png_sizeof(png_uint_16)));
2002-05-25 16:12:10 +00:00
if (png_ptr->hist == NULL)
{
png_warning(png_ptr, "Insufficient memory for hIST chunk data.");
return;
}
1997-05-16 07:46:07 +00:00
2000-12-28 13:50:05 +00:00
for (i = 0; i < info_ptr->num_palette; i++)
png_ptr->hist[i] = hist[i];
info_ptr->hist = png_ptr->hist;
1997-05-16 07:46:07 +00:00
info_ptr->valid |= PNG_INFO_hIST;
2000-12-28 13:50:05 +00:00
#ifdef PNG_FREE_ME_SUPPORTED
info_ptr->free_me |= PNG_FREE_HIST;
#else
png_ptr->flags |= PNG_FLAG_FREE_HIST;
#endif
1997-05-16 07:46:07 +00:00
}
#endif
2000-05-06 19:09:57 +00:00
void PNGAPI
1997-05-16 07:46:07 +00:00
png_set_IHDR(png_structp png_ptr, png_infop info_ptr,
png_uint_32 width, png_uint_32 height, int bit_depth,
int color_type, int interlace_type, int compression_type,
int filter_type)
{
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", "IHDR");
1998-02-09 02:56:40 +00:00
if (png_ptr == NULL || info_ptr == NULL)
1997-05-16 07:46:07 +00:00
return;
2001-05-07 19:52:45 +00:00
/* check for width and height valid values */
if (width == 0 || height == 0)
png_error(png_ptr, "Image width or height is zero in IHDR");
2004-08-04 11:34:52 +00:00
#ifdef PNG_SET_USER_LIMITS_SUPPORTED
if (width > png_ptr->user_width_max || height > png_ptr->user_height_max)
png_error(png_ptr, "image size exceeds user limits in IHDR");
#else
if (width > PNG_USER_WIDTH_MAX || height > PNG_USER_HEIGHT_MAX)
png_error(png_ptr, "image size exceeds user limits in IHDR");
#endif
2004-07-28 13:20:44 +00:00
if (width > PNG_UINT_31_MAX || height > PNG_UINT_31_MAX)
2001-05-07 19:52:45 +00:00
png_error(png_ptr, "Invalid image size in IHDR");
2004-08-04 11:34:52 +00:00
if ( width > (PNG_UINT_32_MAX
>> 3) /* 8-byte RGBA pixels */
- 64 /* bigrowbuf hack */
- 1 /* filter byte */
- 7*8 /* rounding of width to multiple of 8 pixels */
- 8) /* extra max_pixel_depth pad */
png_warning(png_ptr, "Width is too large for libpng to process pixels");
2001-05-07 19:52:45 +00:00
/* check other values */
if (bit_depth != 1 && bit_depth != 2 && bit_depth != 4 &&
bit_depth != 8 && bit_depth != 16)
png_error(png_ptr, "Invalid bit depth in IHDR");
if (color_type < 0 || color_type == 1 ||
color_type == 5 || color_type > 6)
png_error(png_ptr, "Invalid color type in IHDR");
if (((color_type == PNG_COLOR_TYPE_PALETTE) && bit_depth > 8) ||
((color_type == PNG_COLOR_TYPE_RGB ||
color_type == PNG_COLOR_TYPE_GRAY_ALPHA ||
color_type == PNG_COLOR_TYPE_RGB_ALPHA) && bit_depth < 8))
png_error(png_ptr, "Invalid color type/bit depth combination in IHDR");
if (interlace_type >= PNG_INTERLACE_LAST)
png_error(png_ptr, "Unknown interlace method in IHDR");
if (compression_type != PNG_COMPRESSION_TYPE_BASE)
png_error(png_ptr, "Unknown compression method in IHDR");
#if defined(PNG_MNG_FEATURES_SUPPORTED)
/* Accept filter_method 64 (intrapixel differencing) only if
* 1. Libpng was compiled with PNG_MNG_FEATURES_SUPPORTED and
* 2. Libpng did not read a PNG signature (this filter_method is only
* used in PNG datastreams that are embedded in MNG datastreams) and
* 3. The application called png_permit_mng_features with a mask that
* included PNG_FLAG_MNG_FILTER_64 and
* 4. The filter_method is 64 and
* 5. The color_type is RGB or RGBA
*/
2008-07-10 14:10:58 +00:00
if ((png_ptr->mode&PNG_HAVE_PNG_SIGNATURE)&&png_ptr->mng_features_permitted)
2008-07-06 11:05:04 +00:00
png_warning(png_ptr, "MNG features are not allowed in a PNG datastream");
2008-07-10 14:10:58 +00:00
if (filter_type != PNG_FILTER_TYPE_BASE)
2001-05-07 19:52:45 +00:00
{
2008-07-10 14:10:58 +00:00
if (!((png_ptr->mng_features_permitted & PNG_FLAG_MNG_FILTER_64) &&
2001-05-07 19:52:45 +00:00
(filter_type == PNG_INTRAPIXEL_DIFFERENCING) &&
((png_ptr->mode&PNG_HAVE_PNG_SIGNATURE) == 0) &&
2006-03-04 22:50:47 +00:00
(color_type == PNG_COLOR_TYPE_RGB ||
2001-05-07 19:52:45 +00:00
color_type == PNG_COLOR_TYPE_RGB_ALPHA)))
png_error(png_ptr, "Unknown filter method in IHDR");
2008-07-10 14:10:58 +00:00
if (png_ptr->mode&PNG_HAVE_PNG_SIGNATURE)
2001-05-07 19:52:45 +00:00
png_warning(png_ptr, "Invalid filter method in IHDR");
}
#else
2008-07-10 14:10:58 +00:00
if (filter_type != PNG_FILTER_TYPE_BASE)
2001-05-07 19:52:45 +00:00
png_error(png_ptr, "Unknown filter method in IHDR");
#endif
1997-05-16 07:46:07 +00:00
info_ptr->width = width;
info_ptr->height = height;
info_ptr->bit_depth = (png_byte)bit_depth;
info_ptr->color_type =(png_byte) color_type;
info_ptr->compression_type = (png_byte)compression_type;
info_ptr->filter_type = (png_byte)filter_type;
info_ptr->interlace_type = (png_byte)interlace_type;
2002-05-01 16:51:26 +00:00
if (info_ptr->color_type == PNG_COLOR_TYPE_PALETTE)
info_ptr->channels = 1;
else if (info_ptr->color_type & PNG_COLOR_MASK_COLOR)
1997-05-16 07:46:07 +00:00
info_ptr->channels = 3;
else
info_ptr->channels = 1;
if (info_ptr->color_type & PNG_COLOR_MASK_ALPHA)
info_ptr->channels++;
info_ptr->pixel_depth = (png_byte)(info_ptr->channels * info_ptr->bit_depth);
1998-02-07 16:20:57 +00:00
2004-08-04 11:34:52 +00:00
/* check for potential overflow */
2007-05-28 13:45:13 +00:00
if (width > (PNG_UINT_32_MAX
2004-08-04 11:34:52 +00:00
>> 3) /* 8-byte RGBA pixels */
- 64 /* bigrowbuf hack */
- 1 /* filter byte */
- 7*8 /* rounding of width to multiple of 8 pixels */
- 8) /* extra max_pixel_depth pad */
1998-02-07 16:20:57 +00:00
info_ptr->rowbytes = (png_size_t)0;
1998-04-21 20:03:57 +00:00
else
2008-07-06 11:05:04 +00:00
info_ptr->rowbytes = PNG_ROWBYTES(info_ptr->pixel_depth, width);
1997-05-16 07:46:07 +00:00
}
1999-12-10 15:43:02 +00:00
#if defined(PNG_oFFs_SUPPORTED)
2000-05-06 19:09:57 +00:00
void PNGAPI
1997-05-16 07:46:07 +00:00
png_set_oFFs(png_structp png_ptr, png_infop info_ptr,
1999-12-10 15:43:02 +00:00
png_int_32 offset_x, png_int_32 offset_y, int unit_type)
1997-05-16 07:46:07 +00:00
{
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", "oFFs");
1998-02-09 02:56:40 +00:00
if (png_ptr == NULL || info_ptr == NULL)
1997-05-16 07:46:07 +00:00
return;
info_ptr->x_offset = offset_x;
info_ptr->y_offset = offset_y;
info_ptr->offset_unit_type = (png_byte)unit_type;
info_ptr->valid |= PNG_INFO_oFFs;
}
#endif
1999-12-10 15:43:02 +00:00
#if defined(PNG_pCAL_SUPPORTED)
2000-05-06 19:09:57 +00:00
void PNGAPI
1997-05-16 07:46:07 +00:00
png_set_pCAL(png_structp png_ptr, png_infop info_ptr,
png_charp purpose, png_int_32 X0, png_int_32 X1, int type, int nparams,
png_charp units, png_charpp params)
{
1998-02-07 16:20:57 +00:00
png_uint_32 length;
1998-02-09 02:56:40 +00:00
int i;
1997-05-16 07:46:07 +00:00
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", "pCAL");
1998-02-09 02:56:40 +00:00
if (png_ptr == NULL || info_ptr == NULL)
1997-05-16 07:46:07 +00:00
return;
length = png_strlen(purpose) + 1;
2008-12-01 14:58:57 +00:00
png_debug1(3, "allocating purpose for info (%lu bytes)",
2008-07-10 14:10:58 +00:00
(unsigned long)length);
2002-05-25 16:12:10 +00:00
info_ptr->pcal_purpose = (png_charp)png_malloc_warn(png_ptr, length);
if (info_ptr->pcal_purpose == NULL)
2008-07-10 14:10:58 +00:00
{
2002-05-25 16:12:10 +00:00
png_warning(png_ptr, "Insufficient memory for pCAL purpose.");
2008-07-10 14:10:58 +00:00
return;
}
1998-02-07 16:20:57 +00:00
png_memcpy(info_ptr->pcal_purpose, purpose, (png_size_t)length);
1997-05-16 07:46:07 +00:00
2008-12-01 14:58:57 +00:00
png_debug(3, "storing X0, X1, type, and nparams in info");
1997-05-16 07:46:07 +00:00
info_ptr->pcal_X0 = X0;
info_ptr->pcal_X1 = X1;
info_ptr->pcal_type = (png_byte)type;
info_ptr->pcal_nparams = (png_byte)nparams;
length = png_strlen(units) + 1;
2008-12-01 14:58:57 +00:00
png_debug1(3, "allocating units for info (%lu bytes)",
2008-07-10 14:10:58 +00:00
(unsigned long)length);
2002-05-25 16:12:10 +00:00
info_ptr->pcal_units = (png_charp)png_malloc_warn(png_ptr, length);
if (info_ptr->pcal_units == NULL)
2008-07-10 14:10:58 +00:00
{
2002-05-25 16:12:10 +00:00
png_warning(png_ptr, "Insufficient memory for pCAL units.");
2008-07-10 14:10:58 +00:00
return;
}
1998-02-07 16:20:57 +00:00
png_memcpy(info_ptr->pcal_units, units, (png_size_t)length);
1997-05-16 07:46:07 +00:00
2002-05-25 16:12:10 +00:00
info_ptr->pcal_params = (png_charpp)png_malloc_warn(png_ptr,
2004-07-28 13:20:44 +00:00
(png_uint_32)((nparams + 1) * png_sizeof(png_charp)));
2002-05-25 16:12:10 +00:00
if (info_ptr->pcal_params == NULL)
2008-07-10 14:10:58 +00:00
{
2002-05-25 16:12:10 +00:00
png_warning(png_ptr, "Insufficient memory for pCAL params.");
2008-07-10 14:10:58 +00:00
return;
}
2001-05-07 19:52:45 +00:00
2009-02-12 21:27:36 +00:00
png_memset(info_ptr->pcal_params, 0, (nparams + 1) * png_sizeof(png_charp));
1997-05-16 07:46:07 +00:00
for (i = 0; i < nparams; i++)
{
length = png_strlen(params[i]) + 1;
2008-12-01 14:58:57 +00:00
png_debug2(3, "allocating parameter %d for info (%lu bytes)", i,
2008-07-10 14:10:58 +00:00
(unsigned long)length);
2002-05-25 16:12:10 +00:00
info_ptr->pcal_params[i] = (png_charp)png_malloc_warn(png_ptr, length);
if (info_ptr->pcal_params[i] == NULL)
2008-07-10 14:10:58 +00:00
{
2002-05-25 16:12:10 +00:00
png_warning(png_ptr, "Insufficient memory for pCAL parameter.");
return;
2008-07-10 14:10:58 +00:00
}
2001-04-20 15:32:10 +00:00
png_memcpy(info_ptr->pcal_params[i], params[i], (png_size_t)length);
1997-05-16 07:46:07 +00:00
}
info_ptr->valid |= PNG_INFO_pCAL;
2009-03-21 13:10:28 +00:00
#ifdef PNG_FREE_ME_SUPPORTED
info_ptr->free_me |= PNG_FREE_PCAL;
#endif
1997-05-16 07:46:07 +00:00
}
#endif
1999-12-10 15:43:02 +00:00
#if defined(PNG_READ_sCAL_SUPPORTED) || defined(PNG_WRITE_sCAL_SUPPORTED)
#ifdef PNG_FLOATING_POINT_SUPPORTED
2000-05-06 19:09:57 +00:00
void PNGAPI
1999-12-10 15:43:02 +00:00
png_set_sCAL(png_structp png_ptr, png_infop info_ptr,
2000-02-05 05:40:16 +00:00
int unit, double width, double height)
1999-12-10 15:43:02 +00:00
{
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", "sCAL");
1999-12-10 15:43:02 +00:00
if (png_ptr == NULL || info_ptr == NULL)
return;
2000-02-05 05:40:16 +00:00
info_ptr->scal_unit = (png_byte)unit;
1999-12-10 15:43:02 +00:00
info_ptr->scal_pixel_width = width;
info_ptr->scal_pixel_height = height;
info_ptr->valid |= PNG_INFO_sCAL;
}
2000-02-05 05:40:16 +00:00
#else
#ifdef PNG_FIXED_POINT_SUPPORTED
2000-05-06 19:09:57 +00:00
void PNGAPI
1999-12-10 15:43:02 +00:00
png_set_sCAL_s(png_structp png_ptr, png_infop info_ptr,
2000-02-05 05:40:16 +00:00
int unit, png_charp swidth, png_charp sheight)
1999-12-10 15:43:02 +00:00
{
png_uint_32 length;
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", "sCAL");
1999-12-10 15:43:02 +00:00
if (png_ptr == NULL || info_ptr == NULL)
return;
2000-02-05 05:40:16 +00:00
info_ptr->scal_unit = (png_byte)unit;
1999-12-10 15:43:02 +00:00
length = png_strlen(swidth) + 1;
2008-12-01 14:58:57 +00:00
png_debug1(3, "allocating unit for info (%u bytes)",
2008-07-10 14:10:58 +00:00
(unsigned int)length);
2004-07-28 13:20:44 +00:00
info_ptr->scal_s_width = (png_charp)png_malloc_warn(png_ptr, length);
if (info_ptr->scal_s_width == NULL)
{
2007-05-28 13:45:13 +00:00
png_warning(png_ptr,
"Memory allocation failed while processing sCAL.");
2008-01-22 03:07:36 +00:00
return;
2004-07-28 13:20:44 +00:00
}
2001-04-20 15:32:10 +00:00
png_memcpy(info_ptr->scal_s_width, swidth, (png_size_t)length);
1999-12-10 15:43:02 +00:00
length = png_strlen(sheight) + 1;
2008-12-01 14:58:57 +00:00
png_debug1(3, "allocating unit for info (%u bytes)",
2008-07-10 14:10:58 +00:00
(unsigned int)length);
2004-07-28 13:20:44 +00:00
info_ptr->scal_s_height = (png_charp)png_malloc_warn(png_ptr, length);
if (info_ptr->scal_s_height == NULL)
{
png_free (png_ptr, info_ptr->scal_s_width);
2008-07-25 13:38:43 +00:00
info_ptr->scal_s_width = NULL;
2007-05-28 13:45:13 +00:00
png_warning(png_ptr,
"Memory allocation failed while processing sCAL.");
2008-01-22 03:07:36 +00:00
return;
2004-07-28 13:20:44 +00:00
}
2001-04-20 15:32:10 +00:00
png_memcpy(info_ptr->scal_s_height, sheight, (png_size_t)length);
1999-12-10 15:43:02 +00:00
info_ptr->valid |= PNG_INFO_sCAL;
2000-05-12 11:19:53 +00:00
#ifdef PNG_FREE_ME_SUPPORTED
info_ptr->free_me |= PNG_FREE_SCAL;
#endif
1999-12-10 15:43:02 +00:00
}
#endif
2000-02-05 05:40:16 +00:00
#endif
#endif
1999-12-10 15:43:02 +00:00
#if defined(PNG_pHYs_SUPPORTED)
2000-05-06 19:09:57 +00:00
void PNGAPI
1997-05-16 07:46:07 +00:00
png_set_pHYs(png_structp png_ptr, png_infop info_ptr,
png_uint_32 res_x, png_uint_32 res_y, int unit_type)
{
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", "pHYs");
1998-02-09 02:56:40 +00:00
if (png_ptr == NULL || info_ptr == NULL)
1997-05-16 07:46:07 +00:00
return;
info_ptr->x_pixels_per_unit = res_x;
info_ptr->y_pixels_per_unit = res_y;
info_ptr->phys_unit_type = (png_byte)unit_type;
info_ptr->valid |= PNG_INFO_pHYs;
}
#endif
2000-05-06 19:09:57 +00:00
void PNGAPI
1997-05-16 07:46:07 +00:00
png_set_PLTE(png_structp png_ptr, png_infop info_ptr,
png_colorp palette, int num_palette)
{
2000-02-05 05:40:16 +00:00
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", "PLTE");
1998-02-09 02:56:40 +00:00
if (png_ptr == NULL || info_ptr == NULL)
1997-05-16 07:46:07 +00:00
return;
2006-02-21 04:09:05 +00:00
if (num_palette < 0 || num_palette > PNG_MAX_PALETTE_LENGTH)
{
if (info_ptr->color_type == PNG_COLOR_TYPE_PALETTE)
png_error(png_ptr, "Invalid palette length");
else
{
png_warning(png_ptr, "Invalid palette length");
return;
}
}
2000-12-28 13:50:05 +00:00
/*
* It may not actually be necessary to set png_ptr->palette here;
* we do it for backward compatibility with the way the png_handle_tRNS
* function used to do the allocation.
*/
#ifdef PNG_FREE_ME_SUPPORTED
png_free_data(png_ptr, info_ptr, PNG_FREE_PLTE, 0);
#endif
2004-07-28 13:20:44 +00:00
2006-02-21 04:09:05 +00:00
/* Changed in libpng-1.2.1 to allocate PNG_MAX_PALETTE_LENGTH instead
of num_palette entries,
2001-12-04 12:30:43 +00:00
in case of an invalid PNG file that has too-large sample values. */
2004-07-28 13:20:44 +00:00
png_ptr->palette = (png_colorp)png_malloc(png_ptr,
2006-02-21 04:09:05 +00:00
PNG_MAX_PALETTE_LENGTH * png_sizeof(png_color));
png_memset(png_ptr->palette, 0, PNG_MAX_PALETTE_LENGTH *
png_sizeof(png_color));
2008-07-06 11:05:04 +00:00
png_memcpy(png_ptr->palette, palette, num_palette * png_sizeof(png_color));
2000-12-28 13:50:05 +00:00
info_ptr->palette = png_ptr->palette;
info_ptr->num_palette = png_ptr->num_palette = (png_uint_16)num_palette;
#ifdef PNG_FREE_ME_SUPPORTED
info_ptr->free_me |= PNG_FREE_PLTE;
#else
png_ptr->flags |= PNG_FLAG_FREE_PLTE;
#endif
2000-02-05 05:40:16 +00:00
2000-02-18 19:48:52 +00:00
info_ptr->valid |= PNG_INFO_PLTE;
1997-05-16 07:46:07 +00:00
}
1999-12-10 15:43:02 +00:00
#if defined(PNG_sBIT_SUPPORTED)
2000-05-06 19:09:57 +00:00
void PNGAPI
1997-05-16 07:46:07 +00:00
png_set_sBIT(png_structp png_ptr, png_infop info_ptr,
png_color_8p sig_bit)
{
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", "sBIT");
1998-02-09 02:56:40 +00:00
if (png_ptr == NULL || info_ptr == NULL)
1997-05-16 07:46:07 +00:00
return;
2008-07-06 11:05:04 +00:00
png_memcpy(&(info_ptr->sig_bit), sig_bit, png_sizeof(png_color_8));
1997-05-16 07:46:07 +00:00
info_ptr->valid |= PNG_INFO_sBIT;
}
#endif
1999-12-10 15:43:02 +00:00
#if defined(PNG_sRGB_SUPPORTED)
2000-05-06 19:09:57 +00:00
void PNGAPI
1998-01-17 04:06:18 +00:00
png_set_sRGB(png_structp png_ptr, png_infop info_ptr, int intent)
1998-01-01 13:13:13 +00:00
{
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", "sRGB");
1998-02-09 02:56:40 +00:00
if (png_ptr == NULL || info_ptr == NULL)
1998-01-01 13:13:13 +00:00
return;
1998-01-17 04:06:18 +00:00
info_ptr->srgb_intent = (png_byte)intent;
1998-01-01 13:13:13 +00:00
info_ptr->valid |= PNG_INFO_sRGB;
}
1999-12-10 15:43:02 +00:00
2000-05-06 19:09:57 +00:00
void PNGAPI
1998-01-01 13:13:13 +00:00
png_set_sRGB_gAMA_and_cHRM(png_structp png_ptr, png_infop info_ptr,
1998-01-17 04:06:18 +00:00
int intent)
1998-01-01 13:13:13 +00:00
{
1999-12-10 15:43:02 +00:00
#if defined(PNG_gAMA_SUPPORTED)
#ifdef PNG_FLOATING_POINT_SUPPORTED
1998-01-01 13:13:13 +00:00
float file_gamma;
#endif
1999-12-10 15:43:02 +00:00
#ifdef PNG_FIXED_POINT_SUPPORTED
2000-02-05 05:40:16 +00:00
png_fixed_point int_file_gamma;
1999-12-10 15:43:02 +00:00
#endif
#endif
#if defined(PNG_cHRM_SUPPORTED)
#ifdef PNG_FLOATING_POINT_SUPPORTED
1998-01-01 13:13:13 +00:00
float white_x, white_y, red_x, red_y, green_x, green_y, blue_x, blue_y;
1999-12-10 15:43:02 +00:00
#endif
2000-02-05 05:40:16 +00:00
png_fixed_point int_white_x, int_white_y, int_red_x, int_red_y, int_green_x,
1999-12-10 15:43:02 +00:00
int_green_y, int_blue_x, int_blue_y;
#endif
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", "sRGB_gAMA_and_cHRM");
1998-02-09 02:56:40 +00:00
if (png_ptr == NULL || info_ptr == NULL)
1998-01-01 13:13:13 +00:00
return;
png_set_sRGB(png_ptr, info_ptr, intent);
1999-12-10 15:43:02 +00:00
#if defined(PNG_gAMA_SUPPORTED)
#ifdef PNG_FLOATING_POINT_SUPPORTED
1999-10-06 09:57:42 +00:00
file_gamma = (float).45455;
1998-01-01 13:13:13 +00:00
png_set_gAMA(png_ptr, info_ptr, file_gamma);
#endif
1999-12-10 15:43:02 +00:00
#ifdef PNG_FIXED_POINT_SUPPORTED
int_file_gamma = 45455L;
png_set_gAMA_fixed(png_ptr, info_ptr, int_file_gamma);
#endif
#endif
1998-01-01 13:13:13 +00:00
1999-12-10 15:43:02 +00:00
#if defined(PNG_cHRM_SUPPORTED)
int_white_x = 31270L;
int_white_y = 32900L;
int_red_x = 64000L;
int_red_y = 33000L;
int_green_x = 30000L;
int_green_y = 60000L;
int_blue_x = 15000L;
int_blue_y = 6000L;
#ifdef PNG_FLOATING_POINT_SUPPORTED
1998-01-04 04:40:55 +00:00
white_x = (float).3127;
white_y = (float).3290;
red_x = (float).64;
red_y = (float).33;
green_x = (float).30;
green_y = (float).60;
blue_x = (float).15;
blue_y = (float).06;
2008-11-27 12:44:23 +00:00
#endif
1998-01-01 13:13:13 +00:00
2008-11-27 12:44:23 +00:00
#if !defined(PNG_NO_CHECK_cHRM)
if (png_check_cHRM_fixed(png_ptr,
int_white_x, int_white_y, int_red_x, int_red_y, int_green_x,
int_green_y, int_blue_x, int_blue_y))
1999-12-10 15:43:02 +00:00
#endif
2008-11-27 12:44:23 +00:00
{
#ifdef PNG_FIXED_POINT_SUPPORTED
png_set_cHRM_fixed(png_ptr, info_ptr,
int_white_x, int_white_y, int_red_x, int_red_y, int_green_x,
int_green_y, int_blue_x, int_blue_y);
1998-01-01 13:13:13 +00:00
#endif
2008-11-27 12:44:23 +00:00
#ifdef PNG_FLOATING_POINT_SUPPORTED
png_set_cHRM(png_ptr, info_ptr,
white_x, white_y, red_x, red_y, green_x, green_y, blue_x, blue_y);
#endif
}
#endif /* cHRM */
1998-01-01 13:13:13 +00:00
}
2009-02-04 19:11:41 +00:00
#endif /* sRGB */
1998-01-01 13:13:13 +00:00
1999-12-10 15:43:02 +00:00
#if defined(PNG_iCCP_SUPPORTED)
2000-05-06 19:09:57 +00:00
void PNGAPI
1999-12-10 15:43:02 +00:00
png_set_iCCP(png_structp png_ptr, png_infop info_ptr,
png_charp name, int compression_type,
2000-02-05 05:40:16 +00:00
png_charp profile, png_uint_32 proflen)
1999-12-10 15:43:02 +00:00
{
2000-04-14 19:20:47 +00:00
png_charp new_iccp_name;
png_charp new_iccp_profile;
2007-10-15 18:39:24 +00:00
png_uint_32 length;
2000-04-14 19:20:47 +00:00
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", "iCCP");
1999-12-10 15:43:02 +00:00
if (png_ptr == NULL || info_ptr == NULL || name == NULL || profile == NULL)
return;
2007-10-15 18:39:24 +00:00
length = png_strlen(name)+1;
new_iccp_name = (png_charp)png_malloc_warn(png_ptr, length);
2004-07-28 13:20:44 +00:00
if (new_iccp_name == NULL)
{
png_warning(png_ptr, "Insufficient memory to process iCCP chunk.");
return;
}
2007-10-16 19:27:46 +00:00
png_memcpy(new_iccp_name, name, length);
2004-07-28 13:20:44 +00:00
new_iccp_profile = (png_charp)png_malloc_warn(png_ptr, proflen);
if (new_iccp_profile == NULL)
{
png_free (png_ptr, new_iccp_name);
2008-07-10 14:10:58 +00:00
png_warning(png_ptr,
"Insufficient memory to process iCCP profile.");
2004-07-28 13:20:44 +00:00
return;
}
2000-04-14 19:20:47 +00:00
png_memcpy(new_iccp_profile, profile, (png_size_t)proflen);
2000-04-10 00:06:13 +00:00
png_free_data(png_ptr, info_ptr, PNG_FREE_ICCP, 0);
2000-04-14 19:20:47 +00:00
2000-02-05 05:40:16 +00:00
info_ptr->iccp_proflen = proflen;
2000-04-14 19:20:47 +00:00
info_ptr->iccp_name = new_iccp_name;
info_ptr->iccp_profile = new_iccp_profile;
1999-12-10 15:43:02 +00:00
/* Compression is always zero but is here so the API and info structure
2000-04-14 19:20:47 +00:00
* does not have to change if we introduce multiple compression types */
1999-12-10 15:43:02 +00:00
info_ptr->iccp_compression = (png_byte)compression_type;
2000-05-01 14:31:54 +00:00
#ifdef PNG_FREE_ME_SUPPORTED
2000-02-18 19:48:52 +00:00
info_ptr->free_me |= PNG_FREE_ICCP;
2000-05-01 14:31:54 +00:00
#endif
1999-12-10 15:43:02 +00:00
info_ptr->valid |= PNG_INFO_iCCP;
}
#endif
#if defined(PNG_TEXT_SUPPORTED)
2000-05-06 19:09:57 +00:00
void PNGAPI
1997-05-16 07:46:07 +00:00
png_set_text(png_structp png_ptr, png_infop info_ptr, png_textp text_ptr,
int num_text)
2002-05-25 16:12:10 +00:00
{
int ret;
2008-07-25 13:38:43 +00:00
ret = png_set_text_2(png_ptr, info_ptr, text_ptr, num_text);
2002-05-25 16:12:10 +00:00
if (ret)
png_error(png_ptr, "Insufficient memory to store text");
}
int /* PRIVATE */
png_set_text_2(png_structp png_ptr, png_infop info_ptr, png_textp text_ptr,
int num_text)
1997-05-16 07:46:07 +00:00
{
int i;
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", (png_ptr->chunk_name[0] == '\0' ?
1998-01-17 04:06:18 +00:00
"text" : (png_const_charp)png_ptr->chunk_name));
1997-05-16 07:46:07 +00:00
1998-02-09 02:56:40 +00:00
if (png_ptr == NULL || info_ptr == NULL || num_text == 0)
2002-05-25 16:12:10 +00:00
return(0);
1997-05-16 07:46:07 +00:00
/* Make sure we have enough space in the "text" array in info_struct
* to hold all of the incoming text_ptr objects.
*/
if (info_ptr->num_text + num_text > info_ptr->max_text)
{
if (info_ptr->text != NULL)
{
png_textp old_text;
int old_max;
old_max = info_ptr->max_text;
info_ptr->max_text = info_ptr->num_text + num_text + 8;
old_text = info_ptr->text;
2002-05-25 16:12:10 +00:00
info_ptr->text = (png_textp)png_malloc_warn(png_ptr,
2008-07-06 11:05:04 +00:00
(png_uint_32)(info_ptr->max_text * png_sizeof(png_text)));
2002-05-25 16:12:10 +00:00
if (info_ptr->text == NULL)
{
png_free(png_ptr, old_text);
return(1);
}
1998-02-07 16:20:57 +00:00
png_memcpy(info_ptr->text, old_text, (png_size_t)(old_max *
2004-07-28 13:20:44 +00:00
png_sizeof(png_text)));
1997-05-16 07:46:07 +00:00
png_free(png_ptr, old_text);
}
else
{
info_ptr->max_text = num_text + 8;
info_ptr->num_text = 0;
2002-05-25 16:12:10 +00:00
info_ptr->text = (png_textp)png_malloc_warn(png_ptr,
2008-07-06 11:05:04 +00:00
(png_uint_32)(info_ptr->max_text * png_sizeof(png_text)));
2002-05-25 16:12:10 +00:00
if (info_ptr->text == NULL)
return(1);
2000-05-12 11:19:53 +00:00
#ifdef PNG_FREE_ME_SUPPORTED
info_ptr->free_me |= PNG_FREE_TEXT;
#endif
1997-05-16 07:46:07 +00:00
}
2008-12-01 14:58:57 +00:00
png_debug1(3, "allocated %d entries for info_ptr->text",
1997-05-16 07:46:07 +00:00
info_ptr->max_text);
}
for (i = 0; i < num_text; i++)
{
2008-07-06 11:05:04 +00:00
png_size_t text_length, key_len;
png_size_t lang_len, lang_key_len;
1997-05-16 07:46:07 +00:00
png_textp textp = &(info_ptr->text[info_ptr->num_text]);
2001-05-07 19:52:45 +00:00
if (text_ptr[i].key == NULL)
1999-12-10 15:43:02 +00:00
continue;
2000-02-05 05:40:16 +00:00
key_len = png_strlen(text_ptr[i].key);
2008-07-10 14:10:58 +00:00
if (text_ptr[i].compression <= 0)
2000-05-12 11:19:53 +00:00
{
lang_len = 0;
lang_key_len = 0;
}
else
2000-05-06 19:09:57 +00:00
#ifdef PNG_iTXt_SUPPORTED
2000-02-05 05:40:16 +00:00
{
/* set iTXt data */
2002-03-26 00:49:08 +00:00
if (text_ptr[i].lang != NULL)
2000-04-14 19:20:47 +00:00
lang_len = png_strlen(text_ptr[i].lang);
else
lang_len = 0;
2001-05-07 19:52:45 +00:00
if (text_ptr[i].lang_key != NULL)
2000-04-14 19:20:47 +00:00
lang_key_len = png_strlen(text_ptr[i].lang_key);
else
lang_key_len = 0;
2000-02-05 05:40:16 +00:00
}
2000-05-06 19:09:57 +00:00
#else
{
png_warning(png_ptr, "iTXt chunk not supported.");
continue;
}
#endif
1997-05-16 07:46:07 +00:00
2001-05-07 19:52:45 +00:00
if (text_ptr[i].text == NULL || text_ptr[i].text[0] == '\0')
1997-05-16 07:46:07 +00:00
{
2000-02-05 05:40:16 +00:00
text_length = 0;
2000-05-06 19:09:57 +00:00
#ifdef PNG_iTXt_SUPPORTED
2008-07-10 14:10:58 +00:00
if (text_ptr[i].compression > 0)
2000-02-05 05:40:16 +00:00
textp->compression = PNG_ITXT_COMPRESSION_NONE;
else
2000-05-06 19:09:57 +00:00
#endif
2000-02-05 05:40:16 +00:00
textp->compression = PNG_TEXT_COMPRESSION_NONE;
1997-05-16 07:46:07 +00:00
}
else
{
2000-02-05 05:40:16 +00:00
text_length = png_strlen(text_ptr[i].text);
1997-05-16 07:46:07 +00:00
textp->compression = text_ptr[i].compression;
}
1999-10-23 13:39:18 +00:00
2002-05-25 16:12:10 +00:00
textp->key = (png_charp)png_malloc_warn(png_ptr,
2008-07-10 14:10:58 +00:00
(png_uint_32)
(key_len + text_length + lang_len + lang_key_len + 4));
2002-05-25 16:12:10 +00:00
if (textp->key == NULL)
return(1);
2008-12-01 14:58:57 +00:00
png_debug2(2, "Allocated %lu bytes at %x in png_set_text",
2008-07-10 14:10:58 +00:00
(png_uint_32)
(key_len + lang_len + lang_key_len + text_length + 4),
2001-05-18 09:54:50 +00:00
(int)textp->key);
1999-10-23 13:39:18 +00:00
png_memcpy(textp->key, text_ptr[i].key,
2000-02-05 05:40:16 +00:00
(png_size_t)(key_len));
2008-07-10 14:10:58 +00:00
*(textp->key + key_len) = '\0';
2000-05-06 19:09:57 +00:00
#ifdef PNG_iTXt_SUPPORTED
2000-02-05 05:40:16 +00:00
if (text_ptr[i].compression > 0)
{
2008-07-25 13:38:43 +00:00
textp->lang = textp->key + key_len + 1;
2000-02-05 05:40:16 +00:00
png_memcpy(textp->lang, text_ptr[i].lang, lang_len);
2008-07-10 14:10:58 +00:00
*(textp->lang + lang_len) = '\0';
2008-07-25 13:38:43 +00:00
textp->lang_key = textp->lang + lang_len + 1;
2000-02-05 05:40:16 +00:00
png_memcpy(textp->lang_key, text_ptr[i].lang_key, lang_key_len);
2008-07-10 14:10:58 +00:00
*(textp->lang_key + lang_key_len) = '\0';
2008-07-25 13:38:43 +00:00
textp->text = textp->lang_key + lang_key_len + 1;
2000-02-05 05:40:16 +00:00
}
else
2000-05-06 19:09:57 +00:00
#endif
2000-02-05 05:40:16 +00:00
{
2000-05-06 19:09:57 +00:00
#ifdef PNG_iTXt_SUPPORTED
2001-10-27 12:35:13 +00:00
textp->lang=NULL;
textp->lang_key=NULL;
2000-05-06 19:09:57 +00:00
#endif
2008-07-25 13:38:43 +00:00
textp->text = textp->key + key_len + 1;
2000-02-05 05:40:16 +00:00
}
2008-07-10 14:10:58 +00:00
if (text_length)
1999-10-23 13:39:18 +00:00
png_memcpy(textp->text, text_ptr[i].text,
2000-02-05 05:40:16 +00:00
(png_size_t)(text_length));
2008-07-10 14:10:58 +00:00
*(textp->text + text_length) = '\0';
2000-02-05 05:40:16 +00:00
2000-05-06 19:09:57 +00:00
#ifdef PNG_iTXt_SUPPORTED
2008-07-10 14:10:58 +00:00
if (textp->compression > 0)
2000-02-05 05:40:16 +00:00
{
textp->text_length = 0;
textp->itxt_length = text_length;
}
else
2000-05-06 19:09:57 +00:00
#endif
2000-02-05 05:40:16 +00:00
{
textp->text_length = text_length;
2000-05-06 19:09:57 +00:00
#ifdef PNG_iTXt_SUPPORTED
2000-02-05 05:40:16 +00:00
textp->itxt_length = 0;
2000-05-06 19:09:57 +00:00
#endif
2000-02-05 05:40:16 +00:00
}
1997-05-16 07:46:07 +00:00
info_ptr->num_text++;
2008-12-01 14:58:57 +00:00
png_debug1(3, "transferred text chunk %d", info_ptr->num_text);
1997-05-16 07:46:07 +00:00
}
2002-05-25 16:12:10 +00:00
return(0);
1997-05-16 07:46:07 +00:00
}
#endif
1999-12-10 15:43:02 +00:00
#if defined(PNG_tIME_SUPPORTED)
2000-05-06 19:09:57 +00:00
void PNGAPI
1997-05-16 07:46:07 +00:00
png_set_tIME(png_structp png_ptr, png_infop info_ptr, png_timep mod_time)
{
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", "tIME");
1999-09-17 17:27:26 +00:00
if (png_ptr == NULL || info_ptr == NULL ||
1999-11-27 16:22:33 +00:00
(png_ptr->mode & PNG_WROTE_tIME))
1997-05-16 07:46:07 +00:00
return;
2008-07-06 11:05:04 +00:00
png_memcpy(&(info_ptr->mod_time), mod_time, png_sizeof(png_time));
1997-05-16 07:46:07 +00:00
info_ptr->valid |= PNG_INFO_tIME;
}
#endif
1999-12-10 15:43:02 +00:00
#if defined(PNG_tRNS_SUPPORTED)
2000-05-06 19:09:57 +00:00
void PNGAPI
1997-05-16 07:46:07 +00:00
png_set_tRNS(png_structp png_ptr, png_infop info_ptr,
png_bytep trans, int num_trans, png_color_16p trans_values)
{
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", "tRNS");
1998-02-09 02:56:40 +00:00
if (png_ptr == NULL || info_ptr == NULL)
1997-05-16 07:46:07 +00:00
return;
if (trans != NULL)
2000-12-28 13:50:05 +00:00
{
/*
2002-06-20 11:54:34 +00:00
* It may not actually be necessary to set png_ptr->trans here;
* we do it for backward compatibility with the way the png_handle_tRNS
* function used to do the allocation.
*/
2008-04-14 14:26:03 +00:00
2008-07-10 14:10:58 +00:00
#ifdef PNG_FREE_ME_SUPPORTED
png_free_data(png_ptr, info_ptr, PNG_FREE_TRNS, 0);
#endif
2006-02-21 04:09:05 +00:00
/* Changed from num_trans to PNG_MAX_PALETTE_LENGTH in version 1.2.1 */
2001-05-07 19:52:45 +00:00
png_ptr->trans = info_ptr->trans = (png_bytep)png_malloc(png_ptr,
2006-02-21 04:09:05 +00:00
(png_uint_32)PNG_MAX_PALETTE_LENGTH);
2008-04-14 14:26:03 +00:00
if (num_trans > 0 && num_trans <= PNG_MAX_PALETTE_LENGTH)
2006-02-21 04:09:05 +00:00
png_memcpy(info_ptr->trans, trans, (png_size_t)num_trans);
2000-12-28 13:50:05 +00:00
}
1997-05-16 07:46:07 +00:00
if (trans_values != NULL)
{
2008-04-12 11:59:47 +00:00
int sample_max = (1 << info_ptr->bit_depth);
if ((info_ptr->color_type == PNG_COLOR_TYPE_GRAY &&
(int)trans_values->gray > sample_max) ||
(info_ptr->color_type == PNG_COLOR_TYPE_RGB &&
((int)trans_values->red > sample_max ||
(int)trans_values->green > sample_max ||
(int)trans_values->blue > sample_max)))
2008-04-14 14:26:03 +00:00
png_warning(png_ptr,
"tRNS chunk has out-of-range samples for bit_depth");
1997-05-16 07:46:07 +00:00
png_memcpy(&(info_ptr->trans_values), trans_values,
2004-07-28 13:20:44 +00:00
png_sizeof(png_color_16));
1998-01-01 13:13:13 +00:00
if (num_trans == 0)
num_trans = 1;
1997-05-16 07:46:07 +00:00
}
2008-04-14 14:26:03 +00:00
1997-05-16 07:46:07 +00:00
info_ptr->num_trans = (png_uint_16)num_trans;
2008-04-14 14:26:03 +00:00
if (num_trans != 0)
{
info_ptr->valid |= PNG_INFO_tRNS;
#ifdef PNG_FREE_ME_SUPPORTED
info_ptr->free_me |= PNG_FREE_TRNS;
#else
png_ptr->flags |= PNG_FLAG_FREE_TRNS;
#endif
}
1997-05-16 07:46:07 +00:00
}
#endif
1999-12-10 15:43:02 +00:00
#if defined(PNG_sPLT_SUPPORTED)
2000-05-06 19:09:57 +00:00
void PNGAPI
2000-02-18 19:48:52 +00:00
png_set_sPLT(png_structp png_ptr,
2000-03-21 11:13:06 +00:00
png_infop info_ptr, png_sPLT_tp entries, int nentries)
2008-07-10 14:10:58 +00:00
/*
* entries - array of png_sPLT_t structures
* to be added to the list of palettes
* in the info structure.
* nentries - number of palette structures to be
* added.
*/
1999-12-10 15:43:02 +00:00
{
2000-03-21 11:13:06 +00:00
png_sPLT_tp np;
1999-12-10 15:43:02 +00:00
int i;
2006-03-10 16:19:04 +00:00
if (png_ptr == NULL || info_ptr == NULL)
return;
2002-05-25 16:12:10 +00:00
np = (png_sPLT_tp)png_malloc_warn(png_ptr,
2008-07-10 14:10:58 +00:00
(info_ptr->splt_palettes_num + nentries) *
(png_uint_32)png_sizeof(png_sPLT_t));
2002-05-25 16:12:10 +00:00
if (np == NULL)
{
2002-07-08 00:15:20 +00:00
png_warning(png_ptr, "No memory for sPLT palettes.");
2002-05-25 16:12:10 +00:00
return;
}
1999-12-10 15:43:02 +00:00
2000-02-05 05:40:16 +00:00
png_memcpy(np, info_ptr->splt_palettes,
2004-07-28 13:20:44 +00:00
info_ptr->splt_palettes_num * png_sizeof(png_sPLT_t));
1999-12-10 15:43:02 +00:00
png_free(png_ptr, info_ptr->splt_palettes);
2000-07-17 11:17:09 +00:00
info_ptr->splt_palettes=NULL;
1999-12-10 15:43:02 +00:00
for (i = 0; i < nentries; i++)
{
2000-03-21 11:13:06 +00:00
png_sPLT_tp to = np + info_ptr->splt_palettes_num + i;
png_sPLT_tp from = entries + i;
2007-10-15 18:39:24 +00:00
png_uint_32 length;
1999-12-10 15:43:02 +00:00
2007-10-15 18:39:24 +00:00
length = png_strlen(from->name) + 1;
to->name = (png_charp)png_malloc_warn(png_ptr, length);
2007-05-28 13:45:13 +00:00
if (to->name == NULL)
{
png_warning(png_ptr,
"Out of memory while processing sPLT chunk");
2008-01-22 03:07:36 +00:00
continue;
2007-05-28 13:45:13 +00:00
}
2007-10-16 19:27:46 +00:00
png_memcpy(to->name, from->name, length);
2007-05-28 13:45:13 +00:00
to->entries = (png_sPLT_entryp)png_malloc_warn(png_ptr,
2008-07-10 14:10:58 +00:00
(png_uint_32)(from->nentries * png_sizeof(png_sPLT_entry)));
2007-05-28 13:45:13 +00:00
if (to->entries == NULL)
{
png_warning(png_ptr,
"Out of memory while processing sPLT chunk");
2008-07-06 11:05:04 +00:00
png_free(png_ptr, to->name);
2007-05-28 13:45:13 +00:00
to->name = NULL;
2008-01-22 03:07:36 +00:00
continue;
2007-05-28 13:45:13 +00:00
}
2007-11-20 02:02:11 +00:00
png_memcpy(to->entries, from->entries,
from->nentries * png_sizeof(png_sPLT_entry));
2001-04-20 15:32:10 +00:00
to->nentries = from->nentries;
to->depth = from->depth;
1999-12-10 15:43:02 +00:00
}
info_ptr->splt_palettes = np;
info_ptr->splt_palettes_num += nentries;
2000-02-05 05:40:16 +00:00
info_ptr->valid |= PNG_INFO_sPLT;
2000-05-01 14:31:54 +00:00
#ifdef PNG_FREE_ME_SUPPORTED
2000-02-18 19:48:52 +00:00
info_ptr->free_me |= PNG_FREE_SPLT;
2000-05-01 14:31:54 +00:00
#endif
1999-12-10 15:43:02 +00:00
}
#endif /* PNG_sPLT_SUPPORTED */
2001-05-07 19:52:45 +00:00
#if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED)
2000-05-06 19:09:57 +00:00
void PNGAPI
1999-12-10 15:43:02 +00:00
png_set_unknown_chunks(png_structp png_ptr,
2000-02-05 05:40:16 +00:00
png_infop info_ptr, png_unknown_chunkp unknowns, int num_unknowns)
1999-12-10 15:43:02 +00:00
{
png_unknown_chunkp np;
int i;
2000-02-05 05:40:16 +00:00
if (png_ptr == NULL || info_ptr == NULL || num_unknowns == 0)
return;
2002-05-25 16:12:10 +00:00
np = (png_unknown_chunkp)png_malloc_warn(png_ptr,
2008-07-10 14:10:58 +00:00
(png_uint_32)((info_ptr->unknown_chunks_num + num_unknowns) *
png_sizeof(png_unknown_chunk)));
2002-05-25 16:12:10 +00:00
if (np == NULL)
{
2007-05-28 13:45:13 +00:00
png_warning(png_ptr,
"Out of memory while processing unknown chunk.");
2002-05-25 16:12:10 +00:00
return;
}
1999-12-10 15:43:02 +00:00
2000-02-05 05:40:16 +00:00
png_memcpy(np, info_ptr->unknown_chunks,
2004-07-28 13:20:44 +00:00
info_ptr->unknown_chunks_num * png_sizeof(png_unknown_chunk));
1999-12-10 15:43:02 +00:00
png_free(png_ptr, info_ptr->unknown_chunks);
2000-07-17 11:17:09 +00:00
info_ptr->unknown_chunks=NULL;
1999-12-10 15:43:02 +00:00
2000-02-05 05:40:16 +00:00
for (i = 0; i < num_unknowns; i++)
1999-12-10 15:43:02 +00:00
{
2008-04-12 11:59:47 +00:00
png_unknown_chunkp to = np + info_ptr->unknown_chunks_num + i;
png_unknown_chunkp from = unknowns + i;
png_memcpy((png_charp)to->name,
(png_charp)from->name,
png_sizeof(from->name));
to->name[png_sizeof(to->name)-1] = '\0';
to->size = from->size;
/* note our location in the read or write sequence */
to->location = (png_byte)(png_ptr->mode & 0xff);
if (from->size == 0)
to->data=NULL;
else
{
2008-07-10 14:10:58 +00:00
to->data = (png_bytep)png_malloc_warn(png_ptr,
(png_uint_32)from->size);
2008-04-12 11:59:47 +00:00
if (to->data == NULL)
{
png_warning(png_ptr,
2007-05-28 13:45:13 +00:00
"Out of memory while processing unknown chunk.");
2008-07-10 14:10:58 +00:00
to->size = 0;
2008-04-12 11:59:47 +00:00
}
else
png_memcpy(to->data, from->data, from->size);
}
1999-12-10 15:43:02 +00:00
}
info_ptr->unknown_chunks = np;
2000-02-05 05:40:16 +00:00
info_ptr->unknown_chunks_num += num_unknowns;
2000-05-01 14:31:54 +00:00
#ifdef PNG_FREE_ME_SUPPORTED
2000-02-18 19:48:52 +00:00
info_ptr->free_me |= PNG_FREE_UNKN;
2000-05-01 14:31:54 +00:00
#endif
1999-12-10 15:43:02 +00:00
}
2000-05-06 19:09:57 +00:00
void PNGAPI
2000-04-24 04:14:02 +00:00
png_set_unknown_chunk_location(png_structp png_ptr, png_infop info_ptr,
int chunk, int location)
{
2008-07-10 14:10:58 +00:00
if (png_ptr != NULL && info_ptr != NULL && chunk >= 0 && chunk <
2000-04-24 04:14:02 +00:00
(int)info_ptr->unknown_chunks_num)
info_ptr->unknown_chunks[chunk].location = (png_byte)location;
}
1999-12-10 15:43:02 +00:00
#endif
2006-03-09 05:35:59 +00:00
#if defined(PNG_1_0_X) || defined(PNG_1_2_X)
2000-03-21 11:13:06 +00:00
#if defined(PNG_READ_EMPTY_PLTE_SUPPORTED) || \
defined(PNG_WRITE_EMPTY_PLTE_SUPPORTED)
2000-05-06 19:09:57 +00:00
void PNGAPI
1999-09-17 17:27:26 +00:00
png_permit_empty_plte (png_structp png_ptr, int empty_plte_permitted)
{
2000-11-10 18:26:19 +00:00
/* This function is deprecated in favor of png_permit_mng_features()
2006-03-02 13:23:18 +00:00
and will be removed from libpng-1.3.0 */
2008-12-01 14:58:57 +00:00
png_debug(1, "in png_permit_empty_plte, DEPRECATED.");
1999-09-17 17:27:26 +00:00
if (png_ptr == NULL)
return;
2000-11-10 18:26:19 +00:00
png_ptr->mng_features_permitted = (png_byte)
2007-10-04 20:33:53 +00:00
((png_ptr->mng_features_permitted & (~PNG_FLAG_MNG_EMPTY_PLTE)) |
2000-11-10 18:26:19 +00:00
((empty_plte_permitted & PNG_FLAG_MNG_EMPTY_PLTE)));
}
#endif
2006-03-02 13:23:18 +00:00
#endif
2000-11-10 18:26:19 +00:00
#if defined(PNG_MNG_FEATURES_SUPPORTED)
png_uint_32 PNGAPI
png_permit_mng_features (png_structp png_ptr, png_uint_32 mng_features)
{
2008-12-01 14:58:57 +00:00
png_debug(1, "in png_permit_mng_features");
2000-11-10 18:26:19 +00:00
if (png_ptr == NULL)
return (png_uint_32)0;
png_ptr->mng_features_permitted =
(png_byte)(mng_features & PNG_ALL_MNG_FEATURES);
return (png_uint_32)png_ptr->mng_features_permitted;
1999-09-17 17:27:26 +00:00
}
#endif
1999-12-10 15:43:02 +00:00
2000-02-05 05:40:16 +00:00
#if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED)
2000-05-06 19:09:57 +00:00
void PNGAPI
2000-02-05 05:40:16 +00:00
png_set_keep_unknown_chunks(png_structp png_ptr, int keep, png_bytep
chunk_list, int num_chunks)
{
png_bytep new_list, p;
int i, old_num_chunks;
2006-03-10 16:19:04 +00:00
if (png_ptr == NULL)
return;
2000-02-05 05:40:16 +00:00
if (num_chunks == 0)
{
2008-07-10 14:10:58 +00:00
if (keep == PNG_HANDLE_CHUNK_ALWAYS || keep == PNG_HANDLE_CHUNK_IF_SAFE)
2000-02-05 05:40:16 +00:00
png_ptr->flags |= PNG_FLAG_KEEP_UNKNOWN_CHUNKS;
else
png_ptr->flags &= ~PNG_FLAG_KEEP_UNKNOWN_CHUNKS;
1999-12-10 15:43:02 +00:00
2008-07-10 14:10:58 +00:00
if (keep == PNG_HANDLE_CHUNK_ALWAYS)
2000-02-05 05:40:16 +00:00
png_ptr->flags |= PNG_FLAG_KEEP_UNSAFE_CHUNKS;
else
png_ptr->flags &= ~PNG_FLAG_KEEP_UNSAFE_CHUNKS;
return;
}
if (chunk_list == NULL)
return;
2008-07-25 13:38:43 +00:00
old_num_chunks = png_ptr->num_chunk_list;
2001-06-23 13:03:17 +00:00
new_list=(png_bytep)png_malloc(png_ptr,
2008-07-10 14:10:58 +00:00
(png_uint_32)
(5*(num_chunks + old_num_chunks)));
if (png_ptr->chunk_list != NULL)
2000-02-05 05:40:16 +00:00
{
2001-06-23 13:03:17 +00:00
png_memcpy(new_list, png_ptr->chunk_list,
(png_size_t)(5*old_num_chunks));
2000-02-18 19:48:52 +00:00
png_free(png_ptr, png_ptr->chunk_list);
2000-07-17 11:17:09 +00:00
png_ptr->chunk_list=NULL;
2000-02-05 05:40:16 +00:00
}
2008-07-10 14:10:58 +00:00
png_memcpy(new_list + 5*old_num_chunks, chunk_list,
2001-06-23 13:03:17 +00:00
(png_size_t)(5*num_chunks));
2008-07-25 13:38:43 +00:00
for (p = new_list + 5*old_num_chunks + 4, i = 0; i<num_chunks; i++, p += 5)
2000-02-05 05:40:16 +00:00
*p=(png_byte)keep;
2008-07-25 13:38:43 +00:00
png_ptr->num_chunk_list = old_num_chunks + num_chunks;
png_ptr->chunk_list = new_list;
2000-05-01 14:31:54 +00:00
#ifdef PNG_FREE_ME_SUPPORTED
2000-02-18 19:48:52 +00:00
png_ptr->free_me |= PNG_FREE_LIST;
2000-05-01 14:31:54 +00:00
#endif
2000-02-05 05:40:16 +00:00
}
#endif
1999-12-10 15:43:02 +00:00
2000-02-05 05:40:16 +00:00
#if defined(PNG_READ_USER_CHUNKS_SUPPORTED)
2000-05-06 19:09:57 +00:00
void PNGAPI
2000-02-05 05:40:16 +00:00
png_set_read_user_chunk_fn(png_structp png_ptr, png_voidp user_chunk_ptr,
png_user_chunk_ptr read_user_chunk_fn)
{
2008-12-01 14:58:57 +00:00
png_debug(1, "in png_set_read_user_chunk_fn");
2006-03-10 16:19:04 +00:00
if (png_ptr == NULL)
return;
2000-02-05 05:40:16 +00:00
png_ptr->read_user_chunk_fn = read_user_chunk_fn;
png_ptr->user_chunk_ptr = user_chunk_ptr;
}
#endif
1999-12-10 15:43:02 +00:00
2000-02-18 19:48:52 +00:00
#if defined(PNG_INFO_IMAGE_SUPPORTED)
2000-05-06 19:09:57 +00:00
void PNGAPI
2000-02-18 19:48:52 +00:00
png_set_rows(png_structp png_ptr, png_infop info_ptr, png_bytepp row_pointers)
{
2008-12-01 14:58:57 +00:00
png_debug1(1, "in %s storage function", "rows");
2000-05-17 22:39:34 +00:00
2000-02-18 19:48:52 +00:00
if (png_ptr == NULL || info_ptr == NULL)
return;
2008-07-10 14:10:58 +00:00
if (info_ptr->row_pointers && (info_ptr->row_pointers != row_pointers))
2000-04-14 19:20:47 +00:00
png_free_data(png_ptr, info_ptr, PNG_FREE_ROWS, 0);
2000-05-17 22:39:34 +00:00
info_ptr->row_pointers = row_pointers;
2008-07-10 14:10:58 +00:00
if (row_pointers)
2000-05-17 22:39:34 +00:00
info_ptr->valid |= PNG_INFO_IDAT;
2000-02-18 19:48:52 +00:00
}
#endif
2004-07-28 13:20:44 +00:00
#ifdef PNG_WRITE_SUPPORTED
2000-05-06 19:09:57 +00:00
void PNGAPI
2008-07-10 14:10:58 +00:00
png_set_compression_buffer_size(png_structp png_ptr,
png_uint_32 size)
2000-04-24 04:14:02 +00:00
{
2006-03-10 16:19:04 +00:00
if (png_ptr == NULL)
return;
2008-04-14 14:26:03 +00:00
png_free(png_ptr, png_ptr->zbuf);
2000-04-24 04:14:02 +00:00
png_ptr->zbuf_size = (png_size_t)size;
png_ptr->zbuf = (png_bytep)png_malloc(png_ptr, size);
png_ptr->zstream.next_out = png_ptr->zbuf;
png_ptr->zstream.avail_out = (uInt)png_ptr->zbuf_size;
}
2004-07-28 13:20:44 +00:00
#endif
2000-05-17 22:39:34 +00:00
void PNGAPI
png_set_invalid(png_structp png_ptr, png_infop info_ptr, int mask)
{
if (png_ptr && info_ptr)
2007-10-13 17:07:48 +00:00
info_ptr->valid &= ~mask;
2000-05-17 22:39:34 +00:00
}
2001-01-12 21:13:06 +00:00
2001-05-14 14:20:53 +00:00
2002-03-08 07:31:27 +00:00
#ifndef PNG_1_0_X
2006-12-07 04:06:25 +00:00
#ifdef PNG_ASSEMBLER_CODE_SUPPORTED
2007-09-01 20:12:50 +00:00
/* function was added to libpng 1.2.0 and should always exist by default */
2001-05-14 14:20:53 +00:00
void PNGAPI
png_set_asm_flags (png_structp png_ptr, png_uint_32 asm_flags)
{
2007-09-01 20:12:50 +00:00
/* Obsolete as of libpng-1.2.20 and will be removed from libpng-1.4.0 */
if (png_ptr != NULL)
png_ptr->asm_flags = 0;
2008-08-02 17:21:03 +00:00
asm_flags = asm_flags; /* Quiet the compiler */
2006-12-03 12:15:31 +00:00
}
2001-05-14 14:20:53 +00:00
/* this function was added to libpng 1.2.0 */
void PNGAPI
png_set_mmx_thresholds (png_structp png_ptr,
png_byte mmx_bitdepth_threshold,
png_uint_32 mmx_rowbytes_threshold)
{
2007-09-01 20:12:50 +00:00
/* Obsolete as of libpng-1.2.20 and will be removed from libpng-1.4.0 */
2006-03-10 16:19:04 +00:00
if (png_ptr == NULL)
return;
2008-08-02 17:21:03 +00:00
/* Quiet the compiler */
mmx_bitdepth_threshold = mmx_bitdepth_threshold;
mmx_rowbytes_threshold = mmx_rowbytes_threshold;
2006-12-03 12:15:31 +00:00
}
2006-12-07 04:06:25 +00:00
#endif /* ?PNG_ASSEMBLER_CODE_SUPPORTED */
2004-08-04 11:34:52 +00:00
#ifdef PNG_SET_USER_LIMITS_SUPPORTED
/* this function was added to libpng 1.2.6 */
void PNGAPI
png_set_user_limits (png_structp png_ptr, png_uint_32 user_width_max,
png_uint_32 user_height_max)
{
/* Images with dimensions larger than these limits will be
* rejected by png_set_IHDR(). To accept any PNG datastream
* regardless of dimensions, set both limits to 0x7ffffffL.
*/
2008-07-10 14:10:58 +00:00
if (png_ptr == NULL) return;
2004-08-04 11:34:52 +00:00
png_ptr->user_width_max = user_width_max;
png_ptr->user_height_max = user_height_max;
}
#endif /* ?PNG_SET_USER_LIMITS_SUPPORTED */
2002-03-08 07:31:27 +00:00
#endif /* ?PNG_1_0_X */
2006-02-21 04:09:05 +00:00
#endif /* PNG_READ_SUPPORTED || PNG_WRITE_SUPPORTED */