//------------------------------------------------------------------------
//  PNG Image Handling
//------------------------------------------------------------------------
// 
//  Copyright (c) 2003-2005  The EDGE Team.
// 
//  This program is free software; you can redistribute it and/or
//  modify it under the terms of the GNU General Public License
//  as published by the Free Software Foundation; either version 2
//  of the License, or (at your option) any later version.
//
//  This program is distributed in the hope that it will be useful,
//  but WITHOUT ANY WARRANTY; without even the implied warranty of
//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
//  GNU General Public License for more details.
//
//------------------------------------------------------------------------

#ifndef __EPI_IMAGE_PNG_H__
#define __EPI_IMAGE_PNG_H__

#include "epi.h"
#include "basicimage.h"
#include "files.h"

#include <stdio.h>

namespace epi
{

namespace PNG
{
	const int DEF_COMPRESS = 4;

	/* ------ Functions ------------------------------------- */

	basicimage_c *Load(file_c *f, bool invert = false, bool round_pow2 = false);
	// loads the given PNG image.  Returns 0 if something went wrong.
	// The image will be RGB or RGBA (never paletted).  The size of
	// image (width and height) are rounded to the next highest
	// power-of-two when round_pow2 is set.
	// FIXME: throw exception on failure

	bool GetInfo(file_c *f, int *width, int *height, bool *solid);
	// reads the principle information from the PNG header.
	// (should be much faster than loading the whole image).
	// Returns false if something went wrong.
	// Note: size returned here is the real size, and may be different
	// from the image returned by Load() which rounds to power-of-two.
	// FIXME: throw exception on failure

	bool Save(const basicimage_c& image, FILE *fp, int compress = DEF_COMPRESS);
	// saves the image (in PNG format) to the given file.  The compression
	// level should be between 1 (Z_BEST_SPEED) and 9 (Z_BEST_COMPRESSION).
	// Returns false if failed to save (e.g. file already exists).
	// FIXME: throw exception on failure & use file_c instead of FILE*
}

};  // namespace epi

#endif  /* __EPI_IMAGE_PNG_H__ */