java.awt.image
接口 BufferedImageOp

所有已知实现类：

AffineTransformOp, ColorConvertOp, ConvolveOp, LookupOp, RescaleOp

public interface BufferedImageOp

此接口描述对 BufferedImage 对象所执行的单输入/单输出操作。它由 AffineTransformOp、ConvolveOp、ColorConvertOp、RescaleOp 和 LookupOp 实现。这些对象可以传入到一个 BufferedImageFilter，以便对 ImageProducer-ImageFilter-ImageConsumer 范例中的 BufferedImage 进行操作。

实现此接口的类必须指定它们是否允许进行适当的过滤，在此过滤操作中源对象等于目标对象。

无法使用此接口描述更复杂的操作，比如那些针对多个源对象的操作。注意，此限制还意味着，在进行该操作之前目标像素的值不用作过滤操作的输入。

另请参见：

BufferedImage, BufferedImageFilter, AffineTransformOp, BandCombineOp, ColorConvertOp, ConvolveOp, LookupOp, RescaleOp

方法摘要

BufferedImage	createCompatibleDestImage(BufferedImage src, ColorModel destCM) 创建一个具有正确大小和 band 数的经过检查的目标图像。
BufferedImage	filter(BufferedImage src, BufferedImage dest) 对 BufferedImage 执行单输入/单输出操作。
Rectangle2D	getBounds2D(BufferedImage src) 返回已过滤目标图像的边界框。
Point2D	getPoint2D(Point2D srcPt, Point2D dstPt) 返回与源图像中给定点对应的目标点的位置。
RenderingHints	getRenderingHints() 返回针对此操作所呈现的提示。

方法详细信息

filter

BufferedImage filter(BufferedImage src,
                     BufferedImage dest)

对 BufferedImage 执行单输入/单输出操作。如果两个图像的颜色模型不匹配，则将颜色模型转换成目标颜色模型。如果目标图像为 null，则创建一个具有合适 ColorModel 的 BufferedImage。

如果源图像和/或目标图像与实现此过滤器的类所允许的图像类型不兼容，则可能抛出 IllegalArgumentException。

参数：

src - 要过滤的 BufferedImage

dest - 用于存储 results$ 的 BufferedImage

返回：

过滤后的 BufferedImage。

抛出：

IllegalArgumentException - 如果源图像和/或目标图像与实现此过滤器的类所允许的图像类型不兼容。

getBounds2D

Rectangle2D getBounds2D(BufferedImage src)

返回已过滤目标图像的边界框。如果源图像与实现此过滤器的类所允许的图像类型不兼容，则可能抛出 IllegalArgumentException。

参数：

src - 要过滤的 BufferedImage

返回：

表示目标图像边界框的 Rectangle2D。

createCompatibleDestImage

BufferedImage createCompatibleDestImage(BufferedImage src,
                                        ColorModel destCM)

创建一个具有正确大小和 band 数的经过检查的目标图像。如果源图像与实现此过滤器的类所允许的图像类型不兼容，则可能抛出 IllegalArgumentException。

参数：

src - 要过滤的 BufferedImage

destCM - 目标 ColorModel。如果目标 ColorModel 为 null，则使用源 ColorModel。

返回：

经过检查的目标图像。

getPoint2D

Point2D getPoint2D(Point2D srcPt,
                   Point2D dstPt)

返回与源图像中给定点对应的目标点的位置。如果指定了 dstPt，则使用它保存返回值。

参数：

srcPt - 表示源图像中点的 Point2D

dstPt - 用于存储结果的 Point2D

返回：

与源图像中指定点对应的目标图像中的 Point2D。

getRenderingHints

RenderingHints getRenderingHints()

返回针对此操作所呈现的提示。

返回：

针对此 BufferedImageOp 的 RenderingHints 对象。如果没有设置提示，则返回 null。