Interface BufferedImageOp
- All Known Implementing Classes:
AffineTransformOp,ColorConvertOp,ConvolveOp,LookupOp,RescaleOp
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 Also:
-
Method Summary
Modifier and TypeMethodDescriptioncreateCompatibleDestImage(BufferedImage src, ColorModel destCM) Creates a zeroed destination image with the correct size and number of bands.filter(BufferedImage src, BufferedImage dest) Performs a single-input/single-output operation on aBufferedImage.getBounds2D(BufferedImage src) Returns the bounding box of the filtered destination image.getPoint2D(Point2D srcPt, Point2D dstPt) Returns the location of the corresponding destination point given a point in the source image.Returns the rendering hints for this operation.
-
Method Details
-
filter
Performs a single-input/single-output operation on aBufferedImage. 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, aBufferedImagewith an appropriateColorModelis created.An
IllegalArgumentExceptionmay be thrown if the source and/or destination image is incompatible with the types of images $ allowed by the class implementing this filter.- Parameters:
src- TheBufferedImageto be filtereddest- TheBufferedImagein which to store the results$- Returns:
- 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.
-
getBounds2D
Returns the bounding box of the filtered destination image. AnIllegalArgumentExceptionmay be thrown if the source image is incompatible with the types of images allowed by the class implementing this filter.- Parameters:
src- TheBufferedImageto be filtered- Returns:
- The
Rectangle2Drepresenting the destination image's bounding box.
-
createCompatibleDestImage
Creates a zeroed destination image with the correct size and number of bands. AnIllegalArgumentExceptionmay be thrown if the source image is incompatible with the types of images allowed by the class implementing this filter.- Parameters:
src- TheBufferedImageto be filtereddestCM-ColorModelof the destination. If null, theColorModelof the source is used.- Returns:
- The zeroed destination image.
-
getPoint2D
Returns the location of the corresponding destination point given a point in the source image. IfdstPtis specified, it is used to hold the return value.- Parameters:
srcPt- thePoint2Dthat represents the point in the source imagedstPt- ThePoint2Din which to store the result- Returns:
- The
Point2Din the destination image that corresponds to the specified point in the source image.
-
getRenderingHints
RenderingHints getRenderingHints()Returns the rendering hints for this operation.- Returns:
- The
RenderingHintsobject for thisBufferedImageOp. Returns null if no hints have been set.
-