public interface BufferedImageOp
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.
Modifier and Type | Method and Description |
---|---|
BufferedImage |
createCompatibleDestImage(BufferedImage src,
ColorModel destCM)
Creates a zeroed destination image with the correct size and number of
bands.
|
BufferedImage |
filter(BufferedImage src,
BufferedImage dest)
Performs a single-input/single-output operation on a
BufferedImage . |
Rectangle2D |
getBounds2D(BufferedImage src)
Returns the bounding box of the filtered destination image.
|
Point2D |
getPoint2D(Point2D srcPt,
Point2D dstPt)
Returns the location of the corresponding destination point given a
point in the source image.
|
RenderingHints |
getRenderingHints()
Returns the rendering hints for this operation.
|
BufferedImage filter(BufferedImage src, BufferedImage dest)
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.
src
- The BufferedImage
to be filtereddest
- The BufferedImage
in which to store the results$BufferedImage
.IllegalArgumentException
- If the source and/or destination
image is not compatible with the types of images allowed by the class
implementing this filter.Rectangle2D getBounds2D(BufferedImage src)
IllegalArgumentException
may be thrown if the source
image is incompatible with the types of images allowed
by the class implementing this filter.src
- The BufferedImage
to be filteredRectangle2D
representing the destination
image's bounding box.BufferedImage createCompatibleDestImage(BufferedImage src, ColorModel destCM)
IllegalArgumentException
may be thrown if the source
image is incompatible with the types of images allowed
by the class implementing this filter.src
- The BufferedImage
to be filtereddestCM
- ColorModel
of the destination. If null,
the ColorModel
of the source is used.Point2D getPoint2D(Point2D srcPt, Point2D dstPt)
dstPt
is specified, it
is used to hold the return value.srcPt
- the Point2D
that represents the point in
the source imagedstPt
- The Point2D
in which to store the resultPoint2D
in the destination image that
corresponds to the specified point in the source image.RenderingHints getRenderingHints()
RenderingHints
object for this
BufferedImageOp
. Returns
null if no hints have been set. Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.