/*
 * This file is part of gtkD.
 *
 * gtkD is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License
 * as published by the Free Software Foundation; either version 3
 * of the License, or (at your option) any later version, with
 * some exceptions, please read the COPYING file.
 *
 * gtkD 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 Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with gtkD; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA
 */

// generated automatically - do not change
// find conversion definition on APILookup.txt
// implement new conversion functionalities on the wrap.utils pakage


module gdkpixbuf.Pixdata;

private import gdkpixbuf.Pixbuf;
private import glib.ErrorG;
private import glib.GException;
private import glib.Str;
private import glib.StringG;
private import gtkc.gdkpixbuf;
public  import gtkc.gdkpixbuftypes;


/**
 * A #GdkPixdata contains pixbuf information in a form suitable for
 * serialization and streaming.
 */
public class Pixdata
{
	/** the main Gtk struct */
	protected GdkPixdata* gdkPixdata;
	protected bool ownedRef;

	/** Get the main Gtk struct */
	public GdkPixdata* getPixdataStruct(bool transferOwnership = false)
	{
		if (transferOwnership)
			ownedRef = false;
		return gdkPixdata;
	}

	/** the main Gtk struct as a void* */
	protected void* getStruct()
	{
		return cast(void*)gdkPixdata;
	}

	/**
	 * Sets our main struct and passes it to the parent class.
	 */
	public this (GdkPixdata* gdkPixdata, bool ownedRef = false)
	{
		this.gdkPixdata = gdkPixdata;
		this.ownedRef = ownedRef;
	}


	/**
	 * Deserializes (reconstruct) a #GdkPixdata structure from a byte stream.
	 * The byte stream consists of a straightforward writeout of the
	 * #GdkPixdata fields in network byte order, plus the @pixel_data
	 * bytes the structure points to.
	 * The @pixdata contents are reconstructed byte by byte and are checked
	 * for validity. This function may fail with %GDK_PIXBUF_ERROR_CORRUPT_IMAGE
	 * or %GDK_PIXBUF_ERROR_UNKNOWN_TYPE.
	 *
	 * Deprecated: Use #GResource instead.
	 *
	 * Params:
	 *     streamLength = length of the stream used for deserialization.
	 *     stream = stream of bytes containing a
	 *         serialized #GdkPixdata structure.
	 *
	 * Returns: Upon successful deserialization %TRUE is returned,
	 *     %FALSE otherwise.
	 *
	 * Throws: GException on failure.
	 */
	public bool deserialize(ubyte[] stream)
	{
		GError* err = null;
		
		auto p = gdk_pixdata_deserialize(gdkPixdata, cast(uint)stream.length, stream.ptr, &err) != 0;
		
		if (err !is null)
		{
			throw new GException( new ErrorG(err) );
		}
		
		return p;
	}

	/**
	 * Converts a #GdkPixbuf to a #GdkPixdata. If @use_rle is %TRUE, the
	 * pixel data is run-length encoded into newly-allocated memory and a
	 * pointer to that memory is returned.
	 *
	 * Deprecated: Use #GResource instead.
	 *
	 * Params:
	 *     pixbuf = the data to fill @pixdata with.
	 *     useRle = whether to use run-length encoding for the pixel data.
	 *
	 * Returns: If @use_rle is %TRUE, a pointer to the
	 *     newly-allocated memory for the run-length encoded pixel data,
	 *     otherwise %NULL.
	 */
	public void* fromPixbuf(Pixbuf pixbuf, bool useRle)
	{
		return gdk_pixdata_from_pixbuf(gdkPixdata, (pixbuf is null) ? null : pixbuf.getPixbufStruct(), useRle);
	}

	/**
	 * Serializes a #GdkPixdata structure into a byte stream.
	 * The byte stream consists of a straightforward writeout of the
	 * #GdkPixdata fields in network byte order, plus the @pixel_data
	 * bytes the structure points to.
	 *
	 * Deprecated: Use #GResource instead.
	 *
	 * Returns: A
	 *     newly-allocated string containing the serialized #GdkPixdata
	 *     structure.
	 */
	public ubyte[] serialize()
	{
		uint streamLengthP;
		
		auto p = gdk_pixdata_serialize(gdkPixdata, &streamLengthP);
		
		return p[0 .. streamLengthP];
	}

	/**
	 * Generates C source code suitable for compiling images directly
	 * into programs.
	 *
	 * gdk-pixbuf ships with a program called
	 * [gdk-pixbuf-csource][gdk-pixbuf-csource], which offers a command
	 * line interface to this function.
	 *
	 * Deprecated: Use #GResource instead.
	 *
	 * Params:
	 *     name = used for naming generated data structures or macros.
	 *     dumpType = a #GdkPixdataDumpType determining the kind of C
	 *         source to be generated.
	 *
	 * Returns: a newly-allocated string containing the C source form
	 *     of @pixdata.
	 */
	public StringG toCsource(string name, GdkPixdataDumpType dumpType)
	{
		auto p = gdk_pixdata_to_csource(gdkPixdata, Str.toStringz(name), dumpType);
		
		if(p is null)
		{
			return null;
		}
		
		return new StringG(cast(GString*) p, true);
	}
}