Clones this object.

  Filters an IndexColorModel object by running each entry in its color tables through the filterRGB function that RGBImageFilter subclasses must provide.

  Filters an IndexColorModel object by running each entry in its
color tables through the filterRGB function that RGBImageFilter
subclasses must provide. Uses coordinates of -1 to indicate that
a color table entry is being filtered rather than an actual
pixel value.
Returns: a new IndexColorModel representing the filtered colors
Parameters:
- icm - the IndexColorModel object to be filtered
Throws:
- NullPointerException - if icm is null

  Filters a buffer of pixels in the default RGB ColorModel by passing them one by one through the filterRGB method.

  Filters a buffer of pixels in the default RGB ColorModel by passing
them one by one through the filterRGB method.
Parameters:
- x - the X coordinate of the upper-left corner of the region of pixels
- y - the Y coordinate of the upper-left corner of the region of pixels
- w - the width of the region of pixels
- h - the height of the region of pixels
- pixels - the array of pixels
- off - the offset into the pixels array
- scansize - the distance from one row of pixels to the next in the array
See Also: ColorModel.getRGBdefault(), RGBImageFilter.filterRGB(int, int, int),

  Returns a unique instance of an ImageFilter object which will actually perform the filtering for the specified ImageConsumer.

  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.
Returns: an ImageFilter used to perform the filtering for the specified ImageConsumer.
Parameters:
- ic - the specified ImageConsumer

  Filters the information provided in the imageComplete method of the ImageConsumer interface.

  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.
See Also: ImageConsumer.imageComplete(int),

  Responds to a request for a TopDownLeftRight (TDLR) ordered resend of the pixel data from an ImageConsumer.

  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.

Parameters:
- ip - the ImageProducer that is feeding this instance of the filter - also the ImageProducer that the request should be forwarded to if necessary
Throws:
- NullPointerException - if ip is null
See Also: ImageProducer.requestTopDownLeftRightResend(java.awt.image.ImageConsumer),

  If the ColorModel is an IndexColorModel and the subclass has set the canFilterIndexColorModel flag to true, we substitute a filtered version of the color model here and wherever that original ColorModel object appears in the setPixels methods.

  If the ColorModel is an IndexColorModel and the subclass has set the canFilterIndexColorModel flag to true, we substitute a filtered version of the color model here and wherever that original ColorModel object appears in the setPixels methods. If the ColorModel is not an IndexColorModel or is null, this method overrides the default ColorModel used by the ImageProducer and specifies the default RGB ColorModel instead.

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.
See Also: ImageConsumer, ColorModel.getRGBdefault(),

  Filters the information provided in the setDimensions method of the ImageConsumer interface.

  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.
See Also: ImageConsumer.setDimensions(int, int),

  Filters the information provided in the setHints method of the ImageConsumer interface.

  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.
See Also: ImageConsumer.setHints(int),

  If the ColorModel object is the same one that has already been converted, then simply passes the pixels through with the converted ColorModel.

  If the ColorModel object is the same one that has already been converted, then simply passes the pixels through with the converted ColorModel. Otherwise converts the buffer of byte pixels to the default RGB ColorModel and passes the converted buffer to the filterRGBPixels method to be converted one by one.

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.
See Also: ColorModel.getRGBdefault(), RGBImageFilter.filterRGBPixels(int, int, int, int, int[], int, int),

  If the ColorModel object is the same one that has already been converted, then simply passes the pixels through with the converted ColorModel, otherwise converts the buffer of integer pixels to the default RGB ColorModel and passes the converted buffer to the filterRGBPixels method to be converted one by one.

  If the ColorModel object is the same one that has already been converted, then simply passes the pixels through with the converted ColorModel, otherwise converts the buffer of integer pixels to the default RGB ColorModel and passes the converted buffer to the filterRGBPixels method to be converted one by one. Converts a buffer of integer pixels to the default RGB ColorModel and passes the converted buffer to the filterRGBPixels method.

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.
See Also: ColorModel.getRGBdefault(), RGBImageFilter.filterRGBPixels(int, int, int, int, int[], int, int),

  Passes the properties from the source object along after adding a property indicating the stream of filters it has been run through.

  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.
Parameters:
- props - the properties from the source object
Throws:
- NullPointerException - if props is null

  Registers two ColorModel objects for substitution.

  Registers two ColorModel objects for substitution. If the oldcm
is encountered during any of the setPixels methods, the newcm
is substituted and the pixels passed through
untouched (but with the new ColorModel object).
Parameters:
- oldcm - the ColorModel object to be replaced on the fly
- newcm - the ColorModel object to replace oldcm on the fly