/*
 * Java-Gnome Bindings Library
 *
 * Copyright 1998-2004 the Java-Gnome Team, all rights reserved.
 *
 * The Java-Gnome bindings library is free software distributed under
 * the terms of the GNU Library General Public License version 2.
 */

package org.gnu.gtk;

import org.gnu.gdk.Bitmap;
import org.gnu.gdk.Pixbuf;
import org.gnu.gdk.PixbufAnimation;
import org.gnu.gdk.Pixmap;
import org.gnu.glib.Handle;
import org.gnu.glib.Type;

/**
 * The Image widget displays an image.  Various kinds of objects can be
 * displayed as an image; most typically you would create a
 * {@link org.gnu.gdk.Pixbuf} from a file and then display that.  
 * <p>
 * If the file isn't loaded successfully, the image will contain a
 * "broken image" icon similar to that used in many web browsers.
 */
public class Image extends Misc {

	/**
	 * Construct a new image passing the filename of an image.
	 * 
	 * @param filename The filename for the image to load.
	 */
	public Image(String filename) {
		super(gtk_image_new_from_file(filename));
	}

	/**
	 * Create an Image widget displaying a <i>image</i> and a <i>mask</i>.
	 * A org.gnu.gdk.Image is a client-side image buffer in the pixel format
	 * of the current display.
	 * 
	 * @param image The org.gnu.gdk.Image to use for this object creation.
	 * @param mask The org.gnu.gdk.Mask to apply to the image.
	 */
	public Image(org.gnu.gdk.Image image, Bitmap mask) {
		super(gtk_image_new_from_image(image.getHandle(), mask.getHandle()));
	}

	/**
	 * Creates an Image from a {@link org.gnu.gdk.Pixbuf}.
	 * 
	 * @param pixbuf The Pixbuf to use for the Image creation.
	 */
	public Image(Pixbuf pixbuf) {
		super(gtk_image_new_from_pixbuf(pixbuf.getHandle()));
	}

	/**
	 * Create an Image from a {@link org.gnu.gdk.Pixmap}.
	 * 
	 * @param pixmap The Pixmap to use for the Image creation.
	 * @param mask The mask to apply to the created Image.
	 */
	public Image(Pixmap pixmap, Bitmap mask) {
		super(gtk_image_new_from_pixmap(pixmap.getHandle(), mask.getHandle()));
	}

	/**
	 * Creates an Image displaying the given PixbufAnimation.
	 * 
	 * @param animation The PixbufAnimation to use for this object creation.
	 */
	public Image(PixbufAnimation animation) {
		super(gtk_image_new_from_animation(animation.getHandle()));
	}
	
	/**
	 * Create an Image
	 */
	public Image(String iconName, IconSize size) {
	    super(gtk_image_new_from_icon_name(iconName, size.getValue()));
	}

	/**
	 * Construct an Image from a handle to a native resource.
	 */
	public Image(Handle handle) {
		super(handle);
	}
	
	/**
	 * Creates an Image displaying an IconSet.
	 * 
	 * @param iconSet The IconSet to use for the Image.
	 * @param size The IconSize to use for the Image.
	 */
	public Image(IconSet iconSet, IconSize size) {
		super(gtk_image_new_from_icon_set(iconSet.getHandle(), size.getValue()));
	}

	/**
	 * Create an Image displaying a Stock icon.
	 * 
	 * @param stockId The id of the Stock icon to display.
	 * @param size The size of the icon.
	 */
	public Image(GtkStockItem stockId, IconSize size) {
		super(gtk_image_new_from_stock(stockId.getString(), size.getValue()));
	}
	
	/**
	 * Constructs a new Image. This will be displayed as a "no image" icon until
	 * an image is set using one of the set* methods.
	 */
	public Image(){
		super(gtk_image_new());
	}
	
	/**
	 * Gets the type of representation being used by the Image to store
	 * image data.
	 */
	public ImageType getStorageType() {
		return ImageType.intern(gtk_image_get_storage_type(getHandle()));
	}

	/**
	 * Retrieve the runtime type used by the GLib library.
	 */
	public static Type getType() {
		return new Type(gtk_image_get_type());
	}

	/**
	 * Sets the image to the given {@link org.gnu.gdk.Pixmap}.
	 * 
	 * @param pixmap The Pixmap to use for the Image.
	 * @param mask The mask to apply to the Image.
	 */
	public void set(Pixmap pixmap, Bitmap mask) {
		gtk_image_set_from_pixmap(getHandle(), pixmap.getHandle(), mask.getHandle());
	}
	
	/**
	 * Sets the image widget to displaying a <i>image</i> and a <i>mask</i>.
	 * A org.gnu.gdk.Image is a client-side image buffer in the pixel format
	 * of the current display.
	 * 
	 * @param image The org.gnu.gdk.Image to use for this object.
	 * @param mask The org.gnu.gdk.Mask to apply to the image.
	 */
	public void set(org.gnu.gdk.Image image, Bitmap mask) {
		Image.gtk_image_set_from_image(getHandle(), image.getHandle(), mask.getHandle());
	}

	/**
	 * Sets the Image from a {@link org.gnu.gdk.Pixbuf}.
	 * 
	 * @param pixbuf The Pixbuf to use for the Image.
	 */
	public void set(Pixbuf pixbuf) {
		Image.gtk_image_set_from_pixbuf(getHandle(), pixbuf.getHandle());
	}
	/**
	 * Sets to image to the given PixbufAnimation.
	 * 
	 * @param animation The PixbufAnimation to use for this object.
	 */
	public void set(PixbufAnimation animation) {
		Image.gtk_image_set_from_animation(getHandle(), animation.getHandle());
	}
	
	public void set(String iconName, IconSize size) {
	    gtk_image_set_from_icon_name(getHandle(), iconName, size.getValue());
	}
	
	/**
	 * Sets the image to displayian IconSet.
	 * 
	 * @param iconSet The IconSet to use for the Image.
	 * @param size The IconSize to use for the Image.
	 */
	public void set(IconSet iconSet, IconSize size) {
		Image.gtk_image_set_from_icon_set(getHandle(), iconSet.getHandle(), size.getValue());
	}

	/**
	 * Set the image to a Stock icon.
	 * 
	 * @param stockId The id of the Stock icon to display.
	 * @param size The size of the icon.
	 */
	public void set(GtkStockItem stockId, IconSize size) {
		Image.gtk_image_set_from_stock(getHandle(), stockId.getString(), size.getValue());
	}

	/**
	 * Sets the image from a file
	 * 
	 * @param filename The filename for the image to load.
	 */
	public void set(String filename) {
		Image.gtk_image_set_from_file(getHandle(), filename);
	}
	
	public void setPixelSize(int pixelSize) {
	    gtk_image_set_pixel_size(getHandle(), pixelSize);
	}
	
	public int getPixelSize() {
	    return gtk_image_get_pixel_size(getHandle());
	}
	
	public String getIconName() {
	    String name = new String();
	    int[] size = new int[1];
	    gtk_image_get_icon_name(getHandle(), name, size);
	    return name;
	}


	native static final protected int gtk_image_get_type();
	native static final protected Handle gtk_image_new();
	native static final protected Handle gtk_image_new_from_pixmap(Handle pixmap, Handle mask);
	native static final protected Handle gtk_image_new_from_image(Handle image, Handle mask);
	native static final protected Handle gtk_image_new_from_file(String filename);
	native static final protected Handle gtk_image_new_from_pixbuf(Handle pixbuf);
	native static final protected Handle gtk_image_new_from_stock(String stockId, int size);
	native static final protected Handle gtk_image_new_from_icon_set(Handle iconSet, int size);
	native static final protected Handle gtk_image_new_from_animation(Handle animation);
	native static final protected Handle gtk_image_new_from_icon_name(String iconName, int size);
	native static final protected void gtk_image_set_from_pixmap(Handle image, Handle pixmap, Handle mask);
	native static final protected void gtk_image_set_from_image(Handle image, Handle gdkImage, Handle mask);
	native static final protected void gtk_image_set_from_file(Handle image, String filename);
	native static final protected void gtk_image_set_from_pixbuf(Handle image, Handle pixbuf);
	native static final protected void gtk_image_set_from_stock(Handle image, String stockId, int size);
	native static final protected void gtk_image_set_from_icon_set(Handle image, Handle iconSet, int size);
	native static final protected void gtk_image_set_from_animation(Handle image, Handle animation);
	native static final protected void gtk_image_set_from_icon_name(Handle image, String iconName, int size);
	native static final protected void gtk_image_set_pixel_size(Handle image, int pixelSize);
	native static final protected int gtk_image_get_storage_type(Handle image);
	native static final protected void gtk_image_get_pixmap(Handle image, Handle pixmap, Handle mask);
	native static final protected void gtk_image_get_image(Handle image, Handle gdkImage, Handle mask);
	native static final protected Handle gtk_image_get_pixbuf(Handle image);
	native static final protected void gtk_image_get_stock(Handle image, String[] stockId, int[] size);
	native static final protected void gtk_image_get_icon_set(Handle image, Handle iconSet, int[] size);
	native static final protected Handle gtk_image_get_animation(Handle image);
	native static final protected void gtk_image_get_icon_name(Handle image, String iconName, int[] size);
	native static final protected int gtk_image_get_pixel_size(Handle image);

    /* Deprecated functions.
    native static final private void gtk_image_set(Handle image, Handle val, Handle mask);
    native static final private void gtk_image_get(Handle image, Handle val, Handle mask);
    */
}