/*
 * opngreduc.h - libpng extension: lossless image reductions.
 *
 * Copyright (C) 2003-2008 Cosmin Truta.
 * This software is distributed under the same licensing and warranty terms
 * as libpng.
 *
 * This code is functional, although it is still work in progress.
 * Upon completion, it will be submitted for incorporation into libpng.
 */


/*****************************************************************************
 * To be added to pngconf.h
 *****************************************************************************/

#ifndef OPNG_NO_IMAGE_REDUCTIONS
#  define OPNG_IMAGE_REDUCTIONS_SUPPORTED
#  define PNG_INFO_IMAGE_SUPPORTED
#  if !defined(PNG_bKGD_SUPPORTED) || !defined(PNG_hIST_SUPPORTED) || \
      !defined(PNG_sBIT_SUPPORTED) || !defined(PNG_tRNS_SUPPORTED)
__error__ "OPNG_IMAGE_REDUCTIONS_SUPPORTED requires support for bKGD, hIST, sBIT and tRNS"
#  endif
#endif

/*
 * OPNG_ASSERT
 * Vanilla version, based on assert().
 */
#ifndef OPNG_ASSERT
#define DEBUG
#if (!defined(PNG_DEBUG) || !PNG_DEBUG) && !defined(DEBUG)
#define NDEBUG
#endif
#include <assert.h>
#define OPNG_ASSERT(cond) assert(cond)
#define OPNG_ASSERT_MSG(cond, msg) assert(cond)
#endif
/*
 * FIXME: avoid the modification of NDEBUG.
 * TODO: add a specialized version for MS Visual C++, based on <crtdbg.h>.
 */


/*****************************************************************************
 * To be added to png.h
 *****************************************************************************/

#ifdef PNG_INFO_IMAGE_SUPPORTED

/*
 * Indicate whether the image information is valid, i.e.
 * all the required critical information is present in the png structures.
 */
extern PNG_EXPORT(int,opng_validate_image)
   PNGARG((png_structp png_ptr, png_infop info_ptr));

#endif /* PNG_INFO_IMAGE_SUPPORTED */

#ifdef OPNG_IMAGE_REDUCTIONS_SUPPORTED

/*
 * Reduce the image (bit depth + color type + palette) without
 * losing any information.  The image data must be present
 * (e.g. after calling png_set_rows(), or after loading IDAT).
 */
extern PNG_EXPORT(png_uint_32,opng_reduce_image)
   PNGARG((png_structp png_ptr, png_infop info_ptr, png_uint_32 reductions));

/*
 * PNG reduction flags.
 */
#define OPNG_REDUCE_NONE             0x0000
#define OPNG_REDUCE_16_TO_8          0x0001
#define OPNG_REDUCE_8_TO_4_2_1       0x0002
#define OPNG_REDUCE_RGB_TO_GRAY      0x0004  /* also RGBA to GA */
#define OPNG_REDUCE_STRIP_ALPHA      0x0008  /* create tRNS if needed */
#define OPNG_REDUCE_RGB_TO_PALETTE   0x0010  /* also RGBA to palette/tRNS */
#define OPNG_REDUCE_PALETTE_TO_RGB   0x0020  /* useful, but not implemented */
#define OPNG_REDUCE_GRAY_TO_PALETTE  0x0040  /* also GA to palette/tRNS */
#define OPNG_REDUCE_PALETTE_TO_GRAY  0x0080  /* also palette/tRNS to GA */
#define OPNG_REDUCE_PALETTE          0x0100  /* remove all sterile entries
                                                from PLTE and tRNS */
#define OPNG_REDUCE_PALETTE_FAST     0x0200  /* remove trailing sterile entries
                                                from PLTE and tRNS */
#define OPNG_REDUCE_ANCILLARY        0x1000

#define OPNG_REDUCE_BIT_DEPTH  \
   (OPNG_REDUCE_16_TO_8 | OPNG_REDUCE_8_TO_4_2_1)

#define OPNG_REDUCE_COLOR_TYPE  \
   (OPNG_REDUCE_RGB_TO_GRAY | OPNG_REDUCE_STRIP_ALPHA | \
    OPNG_REDUCE_RGB_TO_PALETTE | OPNG_REDUCE_PALETTE_TO_RGB | \
    OPNG_REDUCE_GRAY_TO_PALETTE | OPNG_REDUCE_PALETTE_TO_GRAY)

#define OPNG_REDUCE_PALETTE_ALL  \
   (OPNG_REDUCE_PALETTE | OPNG_REDUCE_PALETTE_FAST)

#define OPNG_REDUCE_ALL  \
   (OPNG_REDUCE_BIT_DEPTH | OPNG_REDUCE_COLOR_TYPE | \
    OPNG_REDUCE_PALETTE_ALL | OPNG_REDUCE_ANCILLARY)

#endif /* OPNG_IMAGE_REDUCTIONS_SUPPORTED */