public class BufferedImageFilter extends ImageFilter implements Cloneable
The BufferedImageFilter
class subclasses an ImageFilter
to provide a simple means of using a single-source/single-destination image operator (BufferedImageOp
) to filter a BufferedImage
in the Image Producer/Consumer/Observer paradigm. Examples of these image operators are: ConvolveOp
, AffineTransformOp
and LookupOp
.
ImageFilter
, BufferedImage
, BufferedImageOp
consumer
COMPLETESCANLINES, IMAGEABORTED, IMAGEERROR, RANDOMPIXELORDER, SINGLEFRAME, SINGLEFRAMEDONE, SINGLEPASS, STATICIMAGEDONE, TOPDOWNLEFTRIGHT
public BufferedImageFilter(BufferedImageOp op)
Constructs a BufferedImageFilter
with the specified single-source/single-destination operator.
op
- the specified BufferedImageOp
to use to filter a BufferedImage
NullPointerException
- if op is nullpublic BufferedImageOp getBufferedImageOp()
Returns the BufferedImageOp
.
BufferedImageFilter
.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 retrieve pixels from an image should avoid calling this method directly since that operation could result in problems with retrieving the requested pixels.
setDimensions
in interface ImageConsumer
setDimensions
in class ImageFilter
width
- the width to which to set the width of this BufferedImageFilter
height
- the height to which to set the height of this BufferedImageFilter
ImageConsumer.setDimensions(int, int)
public void setColorModel(ColorModel model)
Filters the information provided in the setColorModel
method of the ImageConsumer
interface.
If model
is null
, this method clears the current ColorModel
of this BufferedImageFilter
.
Note: This method is intended to be called by the ImageProducer
of the Image
whose pixels are being filtered. Developers using this class to retrieve pixels from an image should avoid calling this method directly since that operation could result in problems with retrieving the requested pixels.
setColorModel
in interface ImageConsumer
setColorModel
in class ImageFilter
model
- the ColorModel
to which to set the ColorModel
of this BufferedImageFilter
ImageConsumer.setColorModel(java.awt.image.ColorModel)
public void setPixels(int x, int y, int w, int h, 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 retrieve pixels from an image should avoid calling this method directly since that operation could result in problems with retrieving the requested pixels.
setPixels
in interface ImageConsumer
setPixels
in class ImageFilter
x
- the X coordinate of the upper-left corner of the area of pixels to be sety
- the Y coordinate of the upper-left corner of the area of pixels to be setw
- the width of the area of pixelsh
- the height of the area of pixelsmodel
- the specified ColorModel
pixels
- the array of pixelsoff
- the offset into the pixels
arrayscansize
- the distance from one row of pixels to the next in the pixels
arrayIllegalArgumentException
- if width or height are less than zero.ImageConsumer.setPixels(int, int, int, int, ColorModel, byte[],
int, int)
public void setPixels(int x, int y, int w, int h, 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 retrieve pixels from an image should avoid calling this method directly since that operation could result in problems with retrieving the requested pixels.
setPixels
in interface ImageConsumer
setPixels
in class ImageFilter
x
- the X coordinate of the upper-left corner of the area of pixels to be sety
- the Y coordinate of the upper-left corner of the area of pixels to be setw
- the width of the area of pixelsh
- the height of the area of pixelsmodel
- the specified ColorModel
pixels
- the array of pixelsoff
- the offset into the pixels
arrayscansize
- the distance from one row of pixels to the next in the pixels
arrayIllegalArgumentException
- if width or height are less than zero.ImageConsumer.setPixels(int, int, int, int, ColorModel, int[],
int, int)
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 retrieve pixels from an image should avoid calling this method directly since that operation could result in problems with retrieving the requested pixels.
imageComplete
in interface ImageConsumer
imageComplete
in class ImageFilter
status
- the status of image loadingImagingOpException
- if there was a problem calling the filter method of the BufferedImageOp
associated with this instance.ImageConsumer.imageComplete(int)
© 1993–2017, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.