java.awt.image
類別 LookupOp

java.lang.Object
  java.awt.image.LookupOp

所有已實作的介面：

BufferedImageOp, RasterOp

public class LookupOp
extends Object
implements BufferedImageOp, RasterOp

此類別實作從源到目標的尋找操作。LookupTable 物件可能包含單個陣列或多個陣列，遵循如下限制。

對 Raster，對 band 執行尋找操作。尋找陣列的數目可能為一，此時對所有 band 應用同一個陣列，否則尋找陣列的數目必須等於 Source Raster 的 band 數。

對於 BufferedImage，對顏色和 alpha 份量執行尋找操作。尋找陣列的數目可能為一，此時對所有顏色（但沒有 alpha）份量應用同一個陣列。否則尋找陣列的數目可能等於 Source 的顏色份量數，此時如果存在 alpha 份量，則不執行此份量的尋找。如果這兩種情況都不適用，則尋找陣列的數目必須等於 Source 顏色份量數加上 alpha 份量數，此時對所有顏色和 alpha 份量執行尋找。這就允許多 band BufferedImage 的非一致縮放。

對於尋找操作，處理具有預乘 alpha 資料的 BufferedImage 源的方式與處理沒有預乘的圖像的方式相同。也就是說，無論是否預乘了資料，尋找都是對 BufferedImage 源的原始資料的每個 band 執行。如果需要進行到目標 ColorModel 的顏色轉換，則此步驟將考慮源和目標的預乘狀態。

不能使用具有 IndexColorModel 的圖像。

如果在建構子中指定了 RenderingHints 物件，則在需要顏色轉換時可以使用顏色呈現提示和抖動提示。

此類別允許 Source 與 Destination 相同。

另請參見：

LookupTable, RenderingHints.KEY_COLOR_RENDERING, RenderingHints.KEY_DITHERING

建構子摘要

LookupOp(LookupTable lookup, RenderingHints hints)
在給定尋找表和 RenderingHints 物件（可能為 null）的情況下，建構一個 LookupOp 物件。

方法摘要

BufferedImage	createCompatibleDestImage(BufferedImage src, ColorModel destCM) 創建一幅具有正確大小和 band 數的、經過檢查的目標圖像。
WritableRaster	createCompatibleDestRaster(Raster src) 在給定源 Raster 的情況下，創建一幅具有正確大小和 band 數的、經過檢查的目標 Raster。
BufferedImage	filter(BufferedImage src, BufferedImage dst) 對 BufferedImage 執行尋找操作。
WritableRaster	filter(Raster src, WritableRaster dst) 在 Raster 上執行尋找操作。
Rectangle2D	getBounds2D(BufferedImage src) 返回過濾後的目標圖像的邊界框。
Rectangle2D	getBounds2D(Raster src) 返回過濾後目標 Raster 的邊界框。
Point2D	getPoint2D(Point2D srcPt, Point2D dstPt) 在給定源圖像中某個點的情況下，返回目標點的位置。
RenderingHints	getRenderingHints() 返回此操作的呈現提示。
LookupTable	getTable() 返回 LookupTable。

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

建構子詳細資訊

LookupOp

public LookupOp(LookupTable lookup,
                RenderingHints hints)

在給定尋找表和 RenderingHints 物件（可能為 null）的情況下，建構一個 LookupOp 物件。

參數：

lookup - 指定的 LookupTable

hints - 指定的 RenderingHints，或者為 null

方法詳細資訊

getTable

public final LookupTable getTable()

返回 LookupTable。

返回：

此 LookupOp 的 LookupTable。

filter

public final BufferedImage filter(BufferedImage src,
                                  BufferedImage dst)

對 BufferedImage 執行尋找操作。如果源圖像的顏色模型與目標圖像的不同，則在目標圖像中轉換像素。如果目標圖像為 null，則創建一個具有合適的 ColorModel 的 BufferedImage。如果 LookupTable 中的陣列數不符合上面類別註釋所宣告的限制，如果源圖像有一個 IndexColorModel，則拋出 IllegalArgumentException。

指定者：

介面 BufferedImageOp 中的 filter

參數：

src - 要過濾的 BufferedImage

dst - 存儲過濾操作結果的 BufferedImage

返回：

過濾後的 BufferedImage。

拋出：

IllegalArgumentException - 如果 LookupTable 中的陣列數不符合上面類別註釋所宣告的限制，或者源圖像有一個 IndexColorModel。

filter

public final WritableRaster filter(Raster src,
                                   WritableRaster dst)

在 Raster 上執行尋找操作。如果目標 Raster 為 null，則創建一個新的 Raster。如果源 Raster 和目標 Raster 的 band 數不同，或者 LookupTable 中的陣列數不符合上面類別註釋所宣告的限制，則可能拋出 IllegalArgumentException。

指定者：

介面 RasterOp 中的 filter

參數：

src - 要過濾的源 Raster

dst - 用於已過濾 src 的目標 WritableRaster

返回：

過濾後的 WritableRaster。

拋出：

IllegalArgumentException - 如果源和目標 raster 的 band 數不同，或者 LookupTable 中的陣列數不符合上面類別註釋所宣告的限制。

getBounds2D

public final Rectangle2D getBounds2D(BufferedImage src)

返回過濾後的目標圖像的邊界框。因為這不是一個幾何操作，所以不會改變邊界框。

指定者：

介面 BufferedImageOp 中的 getBounds2D

參數：

src - 要過濾的 BufferedImage

返回：

過濾後的目標圖像的邊界。

getBounds2D

public final Rectangle2D getBounds2D(Raster src)

返回過濾後目標 Raster 的邊界框。因為這不是一個幾何操作，所以不會改變邊界框。

指定者：

介面 RasterOp 中的 getBounds2D

參數：

src - 要過濾的 Raster

返回：

過濾後的目標 Raster 的邊界。

createCompatibleDestImage

public BufferedImage createCompatibleDestImage(BufferedImage src,
                                               ColorModel destCM)

創建一幅具有正確大小和 band 數的、經過檢查的目標圖像。如果 destCM 為 null，則將使用適當的 ColorModel。

指定者：

介面 BufferedImageOp 中的 createCompatibleDestImage

參數：

src - 過濾操作的源圖像。

destCM - 目標的 ColorModel，可以為 null。

返回：

過濾後的目標 BufferedImage。

createCompatibleDestRaster

public WritableRaster createCompatibleDestRaster(Raster src)

在給定源 Raster 的情況下，創建一幅具有正確大小和 band 數的、經過檢查的目標 Raster。

指定者：

介面 RasterOp 中的 createCompatibleDestRaster

參數：

src - 要轉換的 Raster

返回：

經過檢查的目標 Raster。

getPoint2D

public final Point2D getPoint2D(Point2D srcPt,
                                Point2D dstPt)

在給定源圖像中某個點的情況下，返回目標點的位置。如果 dstPt 不為 null，則使用它來保存返回值。因為這不是一個幾何操作，所以 srcPt 將等於 dstPt。

指定者：

介面 BufferedImageOp 中的 getPoint2D

指定者：

介面 RasterOp 中的 getPoint2D

參數：

srcPt - 表示源圖像中某個點的 Point2D

dstPt - 表示目標圖像中位置的 Point2D

返回：

與源圖像中指定點相對應的目標圖像中的 Point2D。

getRenderingHints

public final RenderingHints getRenderingHints()

返回此操作的呈現提示。

指定者：

介面 BufferedImageOp 中的 getRenderingHints

指定者：

介面 RasterOp 中的 getRenderingHints

返回：

與此操作相關聯的 RenderingHints 物件。