java.awt.image

接口
异常
所有已知实现类:
AffineTransformOp, ColorConvertOp, ConvolveOp, LookupOp, RescaleOp

public interface BufferedImageOp

此接口描述对 BufferedImage 对象所执行的单输入/单输出操作。它由 AffineTransformOpConvolveOpColorConvertOpRescaleOpLookupOp 实现。这些对象可以传入到一个 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,则创建一个具有合适 ColorModelBufferedImage

如果源图像和/或目标图像与实现此过滤器的类所允许的图像类型不兼容,则可能抛出 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()
返回针对此操作所呈现的提示。

返回:
针对此 BufferedImageOpRenderingHints 对象。如果没有设置提示,则返回 null。