ImageReader.java   [plain text]

/* ImageReader.java -- Decodes raster images.
   Copyright (C) 2004  Free Software Foundation, Inc.

This file is part of GNU Classpath.

GNU Classpath 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, or (at your option)
any later version.

GNU Classpath 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.

You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING.  If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.

Linking this library statically or dynamically with other modules is
making a combined work based on this library.  Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.

As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module.  An independent module is a module which is not derived from
or based on this library.  If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so.  If you do not wish to do so, delete this
exception statement from your version. */


package javax.imageio;

import java.awt.image.BufferedImage;
import java.awt.image.Raster;
import java.io.IOException;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
import java.util.Locale;

import javax.imageio.event.IIOReadProgressListener;
import javax.imageio.event.IIOReadUpdateListener;
import javax.imageio.event.IIOReadWarningListener;
import javax.imageio.metadata.IIOMetadata;
import javax.imageio.spi.ImageReaderSpi;
import javax.imageio.stream.ImageInputStream;

public abstract class ImageReader
{
  private boolean aborted;
  
  protected Locale[] availableLocales;
  protected boolean ignoreMetadata;
  protected Object input;
  protected Locale locale;
  protected int minIndex;
  protected ImageReaderSpi originatingProvider;
  protected List progressListeners = new ArrayList();
  protected boolean seekForwardOnly;
  protected List updateListeners = new ArrayList();
  protected List warningListeners = new ArrayList();
  protected List warningLocales = new ArrayList();

  protected ImageReader(ImageReaderSpi originatingProvider)
  {
    this.originatingProvider = originatingProvider;
  }

  public void abort()
  {
    aborted = true;
  }

  protected boolean abortRequested()
  {
    return aborted;
  }

  public void addIIOReadProgressListener(IIOReadProgressListener listener)
  {
    if (listener == null)
      return;
    
    progressListeners.add(listener);    
  }

  public void addIIOReadUpdateListener(IIOReadUpdateListener listener)
  {
    if (listener == null)
      return;
    
    updateListeners.add(listener);    
  }
  
  public void addIIOReadWarningListener(IIOReadWarningListener listener)
  {
    if (listener == null)
      return;
    
    warningListeners.add(listener);    
  }

  public boolean canReadRaster()
  {
    return false;
  }

  protected void clearAbortRequest()
  {
    aborted = false;
  }
  
  public void dispose()
  {
    // The default implementation does nothing.
  }
  
  public float getAspectRatio(int imageIndex)
    throws IOException
  {
    return (float) (getWidth(imageIndex) / getHeight(imageIndex));
  }

  public Locale[] getAvailableLocales()
  {
    if (availableLocales == null)
      return null;
    
    return (Locale[]) availableLocales.clone();
  }

  public ImageReadParam getDefaultReadParam()
  {
    return new ImageReadParam();
  }

  public String getFormatName()
    throws IOException
  {
    return originatingProvider.getFormatNames()[0];
  }

  public abstract int getHeight(int imageIndex)
    throws IOException;

  public abstract IIOMetadata getImageMetadata(int imageIndex)
    throws IOException;

  public abstract Iterator getImageTypes(int imageIndex)
    throws IOException;

  public void setInput(Object input,
                       boolean seekForwardOnly,
                       boolean ignoreMetadata)
  {
    Class[] okClasses = originatingProvider.getInputTypes();
    if (okClasses == null)
      {
        if (!(input instanceof ImageInputStream))
          throw new IllegalArgumentException();
      }
    else
      {
        boolean classOk = false;
        for (int i = 0; i < okClasses.length; ++i)
          if (okClasses[i].isInstance(input))
            classOk = true;
        if (!classOk)
          throw new IllegalArgumentException();
      }

    this.input = input;
    this.seekForwardOnly = seekForwardOnly;
    this.ignoreMetadata = ignoreMetadata;
    this.minIndex = 0;
  }

  public void setInput(Object in, boolean seekForwardOnly)
  {
    setInput(in, seekForwardOnly, false);
  }

  public void setInput(Object in)
  {
    setInput(in, false, false);
  }

  public Object getInput()
  {
    return input;
  }

  public Locale getLocale()
  {
    return locale;
  }

  public abstract int getNumImages(boolean allowSearch)
    throws IOException;

  public int getNumThumbnails(int imageIndex)
    throws IOException
  {
    return 0;
  }

  public ImageReaderSpi getOriginatingProvider()
  {
    return originatingProvider;
  }

  public abstract IIOMetadata getStreamMetadata()
    throws IOException;

  public int getThumbnailHeight(int imageIndex, int thumbnailIndex)
    throws IOException
  {
    return readThumbnail(imageIndex, thumbnailIndex).getHeight();
  }

  public int getThumbnailWidth(int imageIndex, int thumbnailIndex)
    throws IOException
  {
    return readThumbnail(imageIndex, thumbnailIndex).getWidth();
  }

  public int getTileGridXOffset(int imageIndex)
    throws IOException
  {
    return 0;
  }

  public int getTileGridYOffset(int imageIndex)
    throws IOException
  {
    return 0;
  }

  public int getTileHeight(int imageIndex)
    throws IOException
  {
    return getHeight(imageIndex);
  }

  public int getTileWidth(int imageIndex)
    throws IOException
  {
    return getWidth(imageIndex);
  }

  public abstract int getWidth(int imageIndex)
    throws IOException;

  public boolean hasThumbnails(int imageIndex)
    throws IOException
  {
    return getNumThumbnails(imageIndex) > 0;
  }

  public boolean isIgnoringMetadata()
  {
    return ignoreMetadata;
  }

  public boolean isImageTiled(int imageIndex)
    throws IOException
  {
    return false;
  }

  public boolean isRandomAccessEasy(int imageIndex)
    throws IOException
  {
    return false;
  }

  public boolean isSeekForwardOnly()
  {
    return seekForwardOnly;
  }

  protected void processImageComplete()
  {
    Iterator it = progressListeners.iterator();

    while (it.hasNext())
      {
	IIOReadProgressListener listener = (IIOReadProgressListener) it.next();
	listener.imageComplete (this);
      }
  }

  protected void processImageProgress(float percentageDone)
  {
    Iterator it = progressListeners.iterator();

    while (it.hasNext())
      {
	IIOReadProgressListener listener = (IIOReadProgressListener) it.next();
	listener.imageProgress(this, percentageDone);
      }
  }

  protected void processImageStarted(int imageIndex)
  {
    Iterator it = progressListeners.iterator();

    while (it.hasNext())
      {
	IIOReadProgressListener listener = (IIOReadProgressListener) it.next();
	listener.imageStarted(this, imageIndex);
      }
  }

  protected void processImageUpdate(BufferedImage image, int minX, int minY,
				    int width, int height, int periodX,
				    int periodY, int[] bands)
  {
    Iterator it = updateListeners.iterator();

    while (it.hasNext())
      {
	IIOReadUpdateListener listener = (IIOReadUpdateListener) it.next();
	listener.imageUpdate(this, image, minX, minY, width, height, periodX,
			     periodY, bands);
      }
  }

  protected void processPassComplete(BufferedImage image)
  {
    Iterator it = updateListeners.iterator();

    while (it.hasNext())
      {
	IIOReadUpdateListener listener = (IIOReadUpdateListener) it.next();
	listener.passComplete(this, image);
      }
  }

  protected void processPassStarted(BufferedImage image, int pass, int minPass,
				    int maxPass, int minX, int minY,
				    int periodX, int periodY, int[] bands)
  {
    Iterator it = updateListeners.iterator();

    while (it.hasNext())
      {
	IIOReadUpdateListener listener = (IIOReadUpdateListener) it.next();
	listener.passStarted(this, image, pass, minPass, maxPass, minX, minY,
			     periodX, periodY, bands);
      }
  }

  protected void processReadAborted()
  {
    Iterator it = progressListeners.iterator();

    while (it.hasNext())
      {
	IIOReadProgressListener listener = (IIOReadProgressListener) it.next();
	listener.readAborted(this);
      }
  }

  protected void processSequenceComplete()
  {
    Iterator it = progressListeners.iterator();

    while (it.hasNext())
      {
	IIOReadProgressListener listener = (IIOReadProgressListener) it.next();
	listener.sequenceComplete(this);
      }
  }

  protected void processSequenceStarted(int minIndex)
  {
    Iterator it = progressListeners.iterator();

    while (it.hasNext())
      {
	IIOReadProgressListener listener = (IIOReadProgressListener) it.next();
	listener.sequenceStarted(this, minIndex);
      }
  }

  protected void processThumbnailComplete()
  {
    Iterator it = progressListeners.iterator();

    while (it.hasNext())
      {
	IIOReadProgressListener listener = (IIOReadProgressListener) it.next();
	listener.thumbnailComplete(this);
      }
  }

  protected void processThumbnailPassComplete(BufferedImage thumbnail)
  {
    Iterator it = updateListeners.iterator();

    while (it.hasNext())
      {
	IIOReadUpdateListener listener = (IIOReadUpdateListener) it.next();
	listener.thumbnailPassComplete(this, thumbnail);
      }
  }

  protected void processThumbnailPassStarted(BufferedImage thumbnail, int pass,
					     int minPass, int maxPass, int minX,
					     int minY, int periodX, int periodY,
					     int[] bands)
  {
    Iterator it = updateListeners.iterator();

    while (it.hasNext())
      {
	IIOReadUpdateListener listener = (IIOReadUpdateListener) it.next();
	listener.thumbnailPassStarted(this, thumbnail, pass, minPass, maxPass,
				      minX, minY, periodX, periodY, bands);
      }
  }
  
  protected void processThumbnailProgress(float percentageDone)
  {
    Iterator it = progressListeners.iterator();

    while (it.hasNext())
      {
	IIOReadProgressListener listener = (IIOReadProgressListener) it.next();
	listener.thumbnailProgress(this, percentageDone);
      }
  }

  protected void processThumbnailStarted(int imageIndex, int thumbnailIndex)
  {
    Iterator it = progressListeners.iterator();

    while (it.hasNext())
      {
	IIOReadProgressListener listener = (IIOReadProgressListener) it.next();
	listener.thumbnailStarted(this, imageIndex, thumbnailIndex);
      }
  }

  protected void processThumbnailUpdate(BufferedImage image, int minX, int minY,
					int width, int height, int periodX,
					int periodY, int[] bands)
  {
    Iterator it = updateListeners.iterator();

    while (it.hasNext())
      {
	IIOReadUpdateListener listener = (IIOReadUpdateListener) it.next();
	listener.thumbnailUpdate(this, image, minX, minY, width, height,
				 periodX, periodY, bands);
      }
  }

  protected void processWarningOccurred(String warning)
  {
    Iterator it = warningListeners.iterator();

    while (it.hasNext())
      {
	IIOReadWarningListener listener = (IIOReadWarningListener) it.next();
	listener.warningOccurred(this, warning);
      }
  }

  public abstract BufferedImage read(int imageIndex, ImageReadParam param)
    throws IOException;

  public boolean readerSupportsThumbnails()
  {
    return false;
  }

  public Raster readRaster(int imageIndex, ImageReadParam param)
    throws IOException
  {
    throw new UnsupportedOperationException();
  }

  public BufferedImage readThumbnail(int imageIndex, int thumbnailIndex)
    throws IOException
  {
    throw new UnsupportedOperationException();
  }

  public void removeAllIIOReadProgressListeners()
  {
    progressListeners.clear();
  }

  public void removeAllIIOReadUpdateListeners()
  {
    updateListeners.clear();
  }

  public void removeAllIIOReadWarningListeners()
  {
    warningListeners.clear();
  }
  
  public void removeIIOReadProgressListener(IIOReadProgressListener listener) 
  {
    if (listener == null)
      return;
 
    progressListeners.remove(listener);
  }
  
  public void removeIIOReadUpdateListener(IIOReadUpdateListener listener) 
  {
    if (listener == null)
      return;
    
    updateListeners.remove(listener);
  }
  
  public void removeIIOReadWarningListener(IIOReadWarningListener listener)
  {
    if (listener == null)
      return;
    
    warningListeners.remove(listener);
  }
  
  public void setLocale(Locale locale)
  {
    if (locale != null)
      {
	// Check if its a valid locale.
	boolean found = false;

	if (availableLocales != null)
	  for (int i = availableLocales.length - 1; i >= 0; --i)
	    if (availableLocales[i].equals(locale))
	      found = true;

	if (! found)
	  throw new IllegalArgumentException("looale not available");
      }

    this.locale = locale;
  }
}