java.awt.image

Class ImageFilter

Implemented Interfaces:
Cloneable, ImageConsumer
Known Direct Subclasses:
BufferedImageFilter, CropImageFilter, ReplicateScaleFilter, RGBImageFilter

public class ImageFilter
extends Object
implements ImageConsumer, Cloneable

The ImageFilter class is a base class which can be extended to provide different types of filters for an image. By default this class does nothing to an image passing through it.

Field Summary

protected ImageConsumer
consumer
The consumer this filter is filtering an image data stream for.

Fields inherited from interface java.awt.image.ImageConsumer

COMPLETESCANLINES, IMAGEABORTED, IMAGEERROR, RANDOMPIXELORDER, SINGLEFRAME, SINGLEFRAMEDONE, SINGLEPASS, STATICIMAGEDONE, TOPDOWNLEFTRIGHT

Method Summary

Object
clone()
By default, returns a shallow copy of the object created by Object.clone()
ImageFilter
getFilterInstance(ImageConsumer ic)
This is the only method which can set the ImageConsumer for this filter.
void
imageComplete(int status)
The ImageProducer calls this method to indicate a single frame or the entire image is complete.
void
resendTopDownLeftRight(ImageProducer ip)
The ImageConsumer can use this method to request the pixels be delivered in top-down, left-right order.
void
setColorModel(ColorModel model)
Override this method to process calls to this method from the ImageProducer.
void
setDimensions(int width, int height)
An ImageProducer indicates the size of the image being produced using this method.
void
setHints(int flags)
The ImageProducer should call this method with a bit mask of hints from any of RANDOMPIXELORDER, TOPDOWNLEFTRIGHT, COMPLETESCANLINES, SINGLEPASS, SINGLEFRAME from the ImageConsumer interface.
void
setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int offset, int scansize)
This function delivers a rectangle of pixels where any pixel(m,n) is stored in the array as a byte at index (n * scansize + m + offset).
void
setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int offset, int scansize)
This function delivers a rectangle of pixels where any pixel(m,n) is stored in the array as an int at index (n * scansize + m + offset).
void
setProperties(Hashtable props)
An ImageProducer can set a list of properties associated with this image by using this method.

Methods inherited from class java.lang.Object

clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

consumer

protected ImageConsumer consumer
The consumer this filter is filtering an image data stream for. It is initialized in the method getFilterInstance.

Method Details

clone

public Object clone()
By default, returns a shallow copy of the object created by Object.clone()
Overrides:
clone in interface Object
See Also:
()

getFilterInstance

public ImageFilter getFilterInstance(ImageConsumer ic)
This is the only method which can set the ImageConsumer for this filter. By default a clone of this filter with the appropriate consumer set is returned.
See Also:
()

imageComplete

public void imageComplete(int status)
The ImageProducer calls this method to indicate a single frame or the entire image is complete. The method is also used to indicate an error in loading or producing the image.
Specified by:
imageComplete in interface ImageConsumer

resendTopDownLeftRight

public void resendTopDownLeftRight(ImageProducer ip)
The ImageConsumer can use this method to request the pixels be delivered in top-down, left-right order.
The filter can respond in three different ways.
  • The default behavior is to forward the request to the ImageProducer using the method requestTopDownLeftRightResend and using the filter as the consumer.
  • The filter has the pixels and can retransmit them in the top-down, left-right order.
  • The filter can do nothing when this method is called.

setColorModel

public void setColorModel(ColorModel model)
Override this method to process calls to this method from the ImageProducer. By default the setColorModel method of the consumer is called with the specified model.
Specified by:
setColorModel in interface ImageConsumer
Parameters:
model - the color model to be used most often by setPixels
See Also:
ColorModel

setDimensions

public void setDimensions(int width,
                          int height)
An ImageProducer indicates the size of the image being produced using this method. A filter can override this method to intercept these calls from the producer in order to change either the width or the height before in turn calling the consumer's setDimensions method.
Specified by:
setDimensions in interface ImageConsumer
Parameters:
width - the width of the image
height - the height of the image

setHints

public void setHints(int flags)
The ImageProducer should call this method with a bit mask of hints from any of RANDOMPIXELORDER, TOPDOWNLEFTRIGHT, COMPLETESCANLINES, SINGLEPASS, SINGLEFRAME from the ImageConsumer interface.
Specified by:
setHints in interface ImageConsumer
Parameters:
flags - a bit mask of hints
See Also:
ImageConsumer

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      ColorModel model,
                      byte[] pixels,
                      int offset,
                      int scansize)
This function delivers a rectangle of pixels where any pixel(m,n) is stored in the array as a byte at index (n * scansize + m + offset).
Specified by:
setPixels in interface ImageConsumer
Parameters:
x - the x coordinate of the rectangle
y - the y coordinate of the rectangle
w - the width of the rectangle
h - the height of the rectangle
model - the ColorModel used to translate the pixels
pixels - the array of pixel values
offset - the index of the first pixels in the pixels array
scansize - the width to use in extracting pixels from the pixels array

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      ColorModel model,
                      int[] pixels,
                      int offset,
                      int scansize)
This function delivers a rectangle of pixels where any pixel(m,n) is stored in the array as an int at index (n * scansize + m + offset).
Specified by:
setPixels in interface ImageConsumer
Parameters:
x - the x coordinate of the rectangle
y - the y coordinate of the rectangle
w - the width of the rectangle
h - the height of the rectangle
model - the ColorModel used to translate the pixels
pixels - the array of pixel values
offset - the index of the first pixels in the pixels array
scansize - the width to use in extracting pixels from the pixels array

setProperties

public void setProperties(Hashtable props)
An ImageProducer can set a list of properties associated with this image by using this method.
Specified by:
setProperties in interface ImageConsumer
Parameters:
props - the list of properties associated with this image

ImageFilter.java -- Java class for filtering images Copyright (C) 1999 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 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.