public IIOImage(RenderedImage image,
    List thumbnails,
    IIOMetadata metadata) 
{
                                                                   
        if (image == null) {
            throw new IllegalArgumentException("image == null!");
        }
        this.image = image;
        this.raster = null;
        this.thumbnails = thumbnails;
        this.metadata = metadata;
}

Constructs an IIOImage containing a RenderedImage, and thumbnails and metadata associated with it.

All parameters are stored by reference.

The thumbnails argument must either be null or contain only BufferedImage objects.

Parameters:

image - a RenderedImage.

thumbnails - a List of BufferedImages, or null.

metadata - an IIOMetadata object, or null.

Throws:

IllegalArgumentException - if image is null.

exception: IllegalArgumentException - if image is null.

 public IIOImage(Raster raster,
    List thumbnails,
    IIOMetadata metadata) 
{
        if (raster == null) {
            throw new IllegalArgumentException("raster == null!");
        }
        this.raster = raster;
        this.image = null;
        this.thumbnails = thumbnails;
        this.metadata = metadata;
}

Constructs an IIOImage containing a Raster, and thumbnails and metadata associated with it.

All parameters are stored by reference.

Parameters:

raster - a Raster.

thumbnails - a List of BufferedImages, or null.

metadata - an IIOMetadata object, or null.

Throws:

IllegalArgumentException - if raster is null.

exception: IllegalArgumentException - if raster is null.

 public IIOMetadata getMetadata() 
{
        return metadata;
}

Returns a reference to the current IIOMetadata object, or null is none is set.

 public int getNumThumbnails() 
{
        return thumbnails == null ? 0 : thumbnails.size();
}

Returns the number of thumbnails stored in this IIOImage.

 public Raster getRaster() 
{
        synchronized(this) {
            return raster;
        }
}

Returns the currently set Raster, or null if only a RenderedImage is available.

 public RenderedImage getRenderedImage() 
{
        synchronized(this) {
            return image;
        }
}

Returns the currently set RenderedImage, or null if only a Raster is available.

 public BufferedImage getThumbnail(int index) 
{
        if (thumbnails == null) {
            throw new IndexOutOfBoundsException("No thumbnails available!");
        }
        return (BufferedImage)thumbnails.get(index);
}

Returns a thumbnail associated with the main image.

 public List getThumbnails() 
{
        return thumbnails;
}

Returns the current List of thumbnail BufferedImages, or null if none is set. A live reference is returned.

 public boolean hasRaster() 
{
        synchronized(this) {
            return (raster != null);
        }
}

Returns true if this IIOImage stores a Raster rather than a RenderedImage.

 public  void setMetadata(IIOMetadata metadata) 
{
        this.metadata = metadata;
}

Sets the IIOMetadata to a new object, or null.

 public  void setRaster(Raster raster) 
{
        synchronized(this) {
            if (raster == null) {
                throw new IllegalArgumentException("raster == null!");
            }
            this.raster = raster;
            this.image = null;
        }
}

Sets the current Raster. The value is stored by reference. Any existing RenderedImage is discarded.

 public  void setRenderedImage(RenderedImage image) 
{
        synchronized(this) {
            if (image == null) {
                throw new IllegalArgumentException("image == null!");
            }
            this.image = image;
            this.raster = null;
        }
}

Sets the current RenderedImage. The value is stored by reference. Any existing Raster is discarded.

 public  void setThumbnails(List thumbnails) 
{
        this.thumbnails = thumbnails;
}

Sets the list of thumbnails to a new List of BufferedImages, or to null. The reference to the previous List is discarded.

The thumbnails argument must either be null or contain only BufferedImage objects.