Java Platform 1.2

java.awt.image
Class ImageFilter

java.lang.Object
  |
  +--java.awt.image.ImageFilter
Direct Known Subclasses:
BufferedImageFilter, CropImageFilter, ReplicateScaleFilter, RGBImageFilter

public class ImageFilter
extends Object
implements ImageConsumer, Cloneable

This class implements a filter for the set of interface methods that are used to deliver data from an ImageProducer to an ImageConsumer. It is meant to be used in conjunction with a FilteredImageSource object to produce filtered versions of existing images. It is a base class that provides the calls needed to implement a "Null filter" which has no effect on the data being passed through. Filters should subclass this class and override the methods which deal with the data that needs to be filtered and modify it as necessary.

See Also:
FilteredImageSource, ImageConsumer

Field Summary
protected  ImageConsumer consumer
          The consumer of the particular image data stream for which this instance of the ImageFilter is filtering data.
 
Constructor Summary
ImageFilter()
           
 
Method Summary
 Object clone()
          Clones this object.
 ImageFilter getFilterInstance(ImageConsumer ic)
          Returns a unique instance of an ImageFilter object which will actually perform the filtering for the specified ImageConsumer.
 void imageComplete(int status)
          Filters the information provided in the imageComplete method of the ImageConsumer interface.
 void resendTopDownLeftRight(ImageProducer ip)
          Responds to a request for a TopDownLeftRight (TDLR) ordered resend of the pixel data from an ImageConsumer.
 void setColorModel(ColorModel model)
          Filter the information provided in the setColorModel method of the ImageConsumer interface.
 void setDimensions(int width, int height)
          Filters the information provided in the setDimensions method of the ImageConsumer interface.
 void setHints(int hints)
          Filters the information provided in the setHints method of the ImageConsumer interface.
 void setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize)
          Filters the information provided in the setPixels method of the ImageConsumer interface which takes an array of bytes.
 void setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize)
          Filters the information provided in the setPixels method of the ImageConsumer interface which takes an array of integers.
 void setProperties(Hashtable props)
          Passes the properties from the source object along after adding a property indicating the stream of filters it has been run through.
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

consumer

protected ImageConsumer consumer
The consumer of the particular image data stream for which this instance of the ImageFilter is filtering data. It is not initialized during the constructor, but rather during the getFilterInstance() method call when the FilteredImageSource is creating a unique instance of this object for a particular image data stream.
See Also:
getFilterInstance(java.awt.image.ImageConsumer), ImageConsumer
Constructor Detail

ImageFilter

public ImageFilter()
Method Detail

getFilterInstance

public ImageFilter getFilterInstance(ImageConsumer ic)
Returns a unique instance of an ImageFilter object which will actually perform the filtering for the specified ImageConsumer. The default implementation just clones this object.

setDimensions

public void setDimensions(int width,
                          int height)
Filters the information provided in the setDimensions method of the ImageConsumer interface.
Specified by:
setDimensions in interface ImageConsumer
See Also:
ImageConsumer.setDimensions(int, int)

setProperties

public void setProperties(Hashtable props)
Passes the properties from the source object along after adding a property indicating the stream of filters it has been run through.
Specified by:
setProperties in interface ImageConsumer

setColorModel

public void setColorModel(ColorModel model)
Filter the information provided in the setColorModel method of the ImageConsumer interface.
Specified by:
setColorModel in interface ImageConsumer
See Also:
ImageConsumer.setColorModel(java.awt.image.ColorModel)

setHints

public void setHints(int hints)
Filters the information provided in the setHints method of the ImageConsumer interface.
Specified by:
setHints in interface ImageConsumer
See Also:
ImageConsumer.setHints(int)

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      ColorModel model,
                      byte[] pixels,
                      int off,
                      int scansize)
Filters the information provided in the setPixels method of the ImageConsumer interface which takes an array of bytes.
Specified by:
setPixels in interface ImageConsumer
See Also:
ImageConsumer.setPixels(int, int, int, int, java.awt.image.ColorModel, byte[], int, int)

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      ColorModel model,
                      int[] pixels,
                      int off,
                      int scansize)
Filters the information provided in the setPixels method of the ImageConsumer interface which takes an array of integers.
Specified by:
setPixels in interface ImageConsumer
See Also:
ImageConsumer.setPixels(int, int, int, int, java.awt.image.ColorModel, byte[], int, int)

imageComplete

public void imageComplete(int status)
Filters the information provided in the imageComplete method of the ImageConsumer interface.
Specified by:
imageComplete in interface ImageConsumer
See Also:
ImageConsumer.imageComplete(int)

resendTopDownLeftRight

public void resendTopDownLeftRight(ImageProducer ip)
Responds to a request for a TopDownLeftRight (TDLR) ordered resend of the pixel data from an ImageConsumer. The ImageFilter can respond to this request in one of three ways.
  1. If the filter can determine that it will forward the pixels in TDLR order if its upstream producer object sends them in TDLR order, then the request is automatically forwarded by default to the indicated ImageProducer using this filter as the requesting ImageConsumer, so no override is necessary.
  2. If the filter can resend the pixels in the right order on its own (presumably because the generated pixels have been saved in some sort of buffer), then it can override this method and simply resend the pixels in TDLR order as specified in the ImageProducer API.
  3. If the filter simply returns from this method then the request will be ignored and no resend will occur.
Parameters:
ip - The ImageProducer that is feeding this instance of the filter - also the ImageProducer that the request should be forwarded to if necessary.
See Also:
ImageProducer.requestTopDownLeftRightResend(java.awt.image.ImageConsumer)

clone

public Object clone()
Clones this object.
Overrides:
clone in class Object

Java Platform 1.2

Submit a bug or feature Version 1.2 of Java Platform API Specification
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.