ImageFilterpublic 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. |
| Fields Summary |
|---|
| protected ImageConsumer | consumerThe 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. |
| Methods Summary |
|---|
| public java.lang.Object | clone()Clones this object.
try {
return super.clone();
} catch (CloneNotSupportedException e) {
// this shouldn't happen, since we are Cloneable
throw new InternalError();
}
| | public java.awt.image.ImageFilter | getFilterInstance(java.awt.image.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.
Note: This method is intended to be called by the ImageProducer
of the Image whose pixels are being filtered. Developers using
this class to filter pixels from an image should avoid calling
this method directly since that operation could interfere
with the filtering operation.
ImageFilter instance = (ImageFilter) clone();
instance.consumer = ic;
return instance;
| | public void | imageComplete(int status)Filters the information provided in the imageComplete method of
the ImageConsumer interface.
Note: This method is intended to be called by the ImageProducer
of the Image whose pixels are being filtered. Developers using
this class to filter pixels from an image should avoid calling
this method directly since that operation could interfere
with the filtering operation.
consumer.imageComplete(status);
| | public void | resendTopDownLeftRight(java.awt.image.ImageProducer ip)Responds to a request for a TopDownLeftRight (TDLR) ordered resend
of the pixel data from an ImageConsumer.
When an ImageConsumer being fed
by an instance of this ImageFilter
requests a resend of the data in TDLR order,
the FilteredImageSource
invokes this method of the ImageFilter.
An ImageFilter subclass might override this method or not,
depending on if and how it can send data in TDLR order.
Three possibilities exist:
-
Do not override this method.
This makes the subclass use the default implementation,
which is to
forward the request
to the indicated
ImageProducer
using this filter as the requesting ImageConsumer.
This behavior
is appropriate if the filter can determine
that it will forward the pixels
in TDLR order if its upstream producer object
sends them in TDLR order.
-
Override the method to simply send the data.
This is appropriate if the filter can handle the request itself —
for example,
if the generated pixels have been saved in some sort of buffer.
-
Override the method to do nothing.
This is appropriate
if the filter cannot produce filtered data in TDLR order.
ip.requestTopDownLeftRightResend(this);
| | public void | setColorModel(java.awt.image.ColorModel model)Filter the information provided in the setColorModel method
of the ImageConsumer interface.
Note: This method is intended to be called by the ImageProducer
of the Image whose pixels are being filtered. Developers using
this class to filter pixels from an image should avoid calling
this method directly since that operation could interfere
with the filtering operation.
consumer.setColorModel(model);
| | public void | setDimensions(int width, int height)Filters the information provided in the setDimensions method
of the ImageConsumer interface.
Note: This method is intended to be called by the ImageProducer
of the Image whose pixels are being filtered. Developers using
this class to filter pixels from an image should avoid calling
this method directly since that operation could interfere
with the filtering operation.
consumer.setDimensions(width, height);
| | public void | setHints(int hints)Filters the information provided in the setHints method
of the ImageConsumer interface.
Note: This method is intended to be called by the ImageProducer
of the Image whose pixels are being filtered. Developers using
this class to filter pixels from an image should avoid calling
this method directly since that operation could interfere
with the filtering operation.
consumer.setHints(hints);
| | public void | setPixels(int x, int y, int w, int h, java.awt.image.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.
Note: This method is intended to be called by the ImageProducer
of the Image whose pixels are being filtered. Developers using
this class to filter pixels from an image should avoid calling
this method directly since that operation could interfere
with the filtering operation.
consumer.setPixels(x, y, w, h, model, pixels, off, scansize);
| | public void | setPixels(int x, int y, int w, int h, java.awt.image.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.
Note: This method is intended to be called by the ImageProducer
of the Image whose pixels are being filtered. Developers using
this class to filter pixels from an image should avoid calling
this method directly since that operation could interfere
with the filtering operation.
consumer.setPixels(x, y, w, h, model, pixels, off, scansize);
| | public void | setProperties(java.util.Hashtable props)Passes the properties from the source object along after adding a
property indicating the stream of filters it has been run through.
Note: This method is intended to be called by the ImageProducer
of the Image whose pixels are being filtered. Developers using
this class to filter pixels from an image should avoid calling
this method directly since that operation could interfere
with the filtering operation.
Hashtable<Object,Object> p = (Hashtable<Object,Object>)props.clone();
Object o = p.get("filters");
if (o == null) {
p.put("filters", toString());
} else if (o instanceof String) {
p.put("filters", ((String) o)+toString());
}
consumer.setProperties(p);
|
|
