FileDocCategorySizeDatePackage
BufferedImageOp.javaAPI DocJava SE 5 API4590Fri Aug 26 14:56:52 BST 2005java.awt.image

BufferedImageOp

public interface BufferedImageOp
This interface describes single-input/single-output operations performed on BufferedImage objects. It is implemented by AffineTransformOp, ConvolveOp, ColorConvertOp, RescaleOp, and LookupOp. These objects can be passed into a BufferedImageFilter to operate on a BufferedImage in the ImageProducer-ImageFilter-ImageConsumer paradigm.

Classes that implement this interface must specify whether or not they allow in-place filtering-- filter operations where the source object is equal to the destination object.

This interface cannot be used to describe more sophisticated operations such as those that take multiple sources. Note that this restriction also means that the values of the destination pixels prior to the operation are not used as input to the filter operation.

see
BufferedImage
see
BufferedImageFilter
see
AffineTransformOp
see
BandCombineOp
see
ColorConvertOp
see
ConvolveOp
see
LookupOp
see
RescaleOp
version
10 Feb 1997

Fields Summary
Constructors Summary
Methods Summary
public java.awt.image.BufferedImagecreateCompatibleDestImage(java.awt.image.BufferedImage src, java.awt.image.ColorModel destCM)
Creates a zeroed destination image with the correct size and number of bands. An IllegalArgumentException may be thrown if the source image is incompatible with the types of images allowed by the class implementing this filter.

param
src The BufferedImage to be filtered
param
destCM ColorModel of the destination. If null, the ColorModel of the source is used.
return
The zeroed destination image.

public java.awt.image.BufferedImagefilter(java.awt.image.BufferedImage src, java.awt.image.BufferedImage dest)
Performs a single-input/single-output operation on a BufferedImage. If the color models for the two images do not match, a color conversion into the destination color model is performed. If the destination image is null, a BufferedImage with an appropriate ColorModel is created.

An IllegalArgumentException may be thrown if the source and/or destination image is incompatible with the types of images $ allowed by the class implementing this filter.

param
src The BufferedImage to be filtered
param
dest The BufferedImage in which to store the results$
return
The filtered BufferedImage.
throws
IllegalArgumentException If the source and/or destination image is not compatible with the types of images allowed by the class implementing this filter.

public java.awt.geom.Rectangle2DgetBounds2D(java.awt.image.BufferedImage src)
Returns the bounding box of the filtered destination image. An IllegalArgumentException may be thrown if the source image is incompatible with the types of images allowed by the class implementing this filter.

param
src The BufferedImage to be filtered
return
The Rectangle2D representing the destination image's bounding box.

public java.awt.geom.Point2DgetPoint2D(java.awt.geom.Point2D srcPt, java.awt.geom.Point2D dstPt)
Returns the location of the corresponding destination point given a point in the source image. If dstPt is specified, it is used to hold the return value.

param
srcPt the Point2D that represents the point in the source image
param
dstPt The Point2D in which to store the result
return
The Point2D in the destination image that corresponds to the specified point in the source image.

public java.awt.RenderingHintsgetRenderingHints()
Returns the rendering hints for this operation.

return
The RenderingHints object for this BufferedImageOp