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。