java.awt.image
類別 ImageFilter

java.lang.Object
  java.awt.image.ImageFilter

所有已實作的介面：

ImageConsumer, Cloneable

直接已知子類別：

BufferedImageFilter, CropImageFilter, ReplicateScaleFilter, RGBImageFilter

public class ImageFilter
extends Object
implements ImageConsumer, Cloneable

此類別為用於從 ImageProducer 向 ImageConsumer 傳遞資料的介面方法集合實作了一個過濾器。它應該與 FilteredImageSource 物件結合使用，以產生現有圖像的過濾版本。它是一個基礎類別，提供的方法並沒有實際實作過濾功能，因此對通過的資料並沒有任何作用，是一個「空過濾器」。過濾器應該創建此類別的子類別，並且覆寫那些處理需要過濾資料的方法並根據需要修改方法。

另請參見：

FilteredImageSource, ImageConsumer

欄位摘要

protected ImageConsumer

consumer 特定圖像資料串流的使用者，而此 ImageFilter 實例也是為這個使用者來過濾資料的。

從介面 java.awt.image.ImageConsumer 繼承的欄位

COMPLETESCANLINES, IMAGEABORTED, IMAGEERROR, RANDOMPIXELORDER, SINGLEFRAME, SINGLEFRAMEDONE, SINGLEPASS, STATICIMAGEDONE, TOPDOWNLEFTRIGHT

建構子摘要

ImageFilter()

方法摘要

Object	clone() 複製此物件。
ImageFilter	getFilterInstance(ImageConsumer ic) 返回為指定 ImageConsumer 實際執行過濾的 ImageFilter 物件的惟一實例。
void	imageComplete(int status) 過濾 ImageConsumer 介面的 imageComplete 方法中所提供的資訊。
void	resendTopDownLeftRight(ImageProducer ip) 回應來自 ImageConsumer 的一個按 TopDownLeftRight (TDLR) 順序將像素資料重新發送的請求。
void	setColorModel(ColorModel model) 過濾 ImageConsumer 介面的 setColorModel 方法中所提供的資訊。
void	setDimensions(int width, int height) 過濾 ImageConsumer 介面的 setDimensions 方法中所提供的資訊。
void	setHints(int hints) 過濾 ImageConsumer 介面的 setHints 方法中所提供的資訊。
void	setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize) 過濾由 ImageConsumer 介面的 setPixels 方法所提供的資訊，該方法以 byte 陣列為參數。
void	setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize) 過濾由 ImageConsumer 介面的 setPixels 方法所提供的資訊，該方法以整數陣列為參數。
void	setProperties(Hashtable<?,?> props) 添加一個屬性，來指示已通過的過濾器串流，並在這之後從源物件傳遞這些屬性。

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

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

欄位詳細資訊

consumer

protected ImageConsumer consumer

特定圖像資料串流的使用者，而此 ImageFilter 實例也是為這個使用者來過濾資料的。它不是在建構子中進行初始化的，而是當 FilteredImageSource 正在為特定圖像資料串流創建此物件的惟一實例時，在 getFilterInstance() 方法調用期間進行初始化。

另請參見：

getFilterInstance(java.awt.image.ImageConsumer), ImageConsumer

建構子詳細資訊

ImageFilter

public ImageFilter()

方法詳細資訊

getFilterInstance

public ImageFilter getFilterInstance(ImageConsumer ic)

返回為指定 ImageConsumer 實際執行過濾的 ImageFilter 物件的惟一實例。預設的實作只是複製此物件。

註：此方法由其像素正在被過濾的 Image 的 ImageProducer 調用。使用此類別過濾圖像像素的開發人員應該避免直接調用此方法，因為該調用操作可能影響過濾操作。

參數：

ic - 指定的 ImageConsumer

返回：

用於為指定 ImageConsumer 執行過濾的 ImageFilter。

setDimensions

public void setDimensions(int width,
                          int height)

過濾 ImageConsumer 介面的 setDimensions 方法中所提供的資訊。

註：此方法由其像素正在被過濾的 Image 的 ImageProducer 調用。使用此類別過濾圖像像素的開發人員應該避免直接調用此方法，因為該調用操作可能影響過濾操作。

指定者：

介面 ImageConsumer 中的 setDimensions

參數：

width - 源圖像的寬度

height - 源圖像的高度

另請參見：

ImageConsumer.setDimensions(int, int)

setProperties

public void setProperties(Hashtable<?,?> props)

添加一個屬性，來指示已通過的過濾器串流，並在這之後從源物件傳遞這些屬性。

註：此方法由其像素正在被過濾的 Image 的 ImageProducer 調用。使用此類別過濾圖像像素的開發人員應該避免直接調用此方法，因為該調用操作可能影響過濾操作。

指定者：

介面 ImageConsumer 中的 setProperties

參數：

props - 來自源物件的屬性

拋出：

NullPointerException - 如果 props 為 null

setColorModel

public void setColorModel(ColorModel model)

過濾 ImageConsumer 介面的 setColorModel 方法中所提供的資訊。

註：此方法由其像素正在被過濾的 Image 的 ImageProducer 調用。使用此類別過濾圖像像素的開發人員應該避免直接調用此方法，因為該調用操作可能影響過濾操作。

指定者：

介面 ImageConsumer 中的 setColorModel

參數：

model - 指定的 ColorModel

另請參見：

ImageConsumer.setColorModel(java.awt.image.ColorModel)

setHints

public void setHints(int hints)

過濾 ImageConsumer 介面的 setHints 方法中所提供的資訊。

註：此方法由其像素正在被過濾的 Image 的 ImageProducer 調用。使用此類別過濾圖像像素的開發人員應該避免直接調用此方法，因為該調用操作可能影響過濾操作。

指定者：

介面 ImageConsumer 中的 setHints

參數：

hints - ImageConsumer 用於處理像素的提示集合

另請參見：

ImageConsumer.setHints(int)

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      ColorModel model,
                      byte[] pixels,
                      int off,
                      int scansize)

過濾由 ImageConsumer 介面的 setPixels 方法所提供的資訊，該方法以 byte 陣列為參數。

註：此方法由其像素正在被過濾的 Image 的 ImageProducer 調用。使用此類別過濾圖像像素的開發人員應該避免直接調用此方法，因為該調用操作可能影響過濾操作。

指定者：

介面 ImageConsumer 中的 setPixels

參數：

x - 要設置的像素區域左上角的 X 坐標

y - 要設置的像素區域左上角的 Y 坐標

w - 像素區域的寬度

h - 像素區域的高度

model - 指定的 ColorModel

pixels - 像素陣列

off - pixels 陣列中的偏移量

scansize - pixels 陣列中一行像素到下一行的距離

另請參見：

ImageConsumer.setPixels(int, int, int, int, java.awt.image.ColorModel, byte[], int, int)

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      ColorModel model,
                      int[] pixels,
                      int off,
                      int scansize)

過濾由 ImageConsumer 介面的 setPixels 方法所提供的資訊，該方法以整數陣列為參數。

註：此方法由其像素正在被過濾的 Image 的 ImageProducer 調用。使用此類別過濾圖像像素的開發人員應該避免直接調用此方法，因為該調用操作可能影響過濾操作。

指定者：

介面 ImageConsumer 中的 setPixels

參數：

x - 要設置的像素區域左上角的 X 坐標

y - 要設置的像素區域左上角的 Y 坐標

w - 像素區域的寬度

h - 像素區域的高度

model - 指定的 ColorModel

pixels - 像素陣列

off - pixels 陣列中的偏移量

scansize - pixels 陣列中一行像素到下一行的距離

另請參見：

ImageConsumer.setPixels(int, int, int, int, java.awt.image.ColorModel, byte[], int, int)

imageComplete

public void imageComplete(int status)

過濾 ImageConsumer 介面的 imageComplete 方法中所提供的資訊。

註：此方法由其像素正在被過濾的 Image 的 ImageProducer 調用。使用此類別過濾圖像像素的開發人員應該避免直接調用此方法，因為該調用操作可能影響過濾操作。

指定者：

介面 ImageConsumer 中的 imageComplete

參數：

status - 圖像載入的狀態

另請參見：

ImageConsumer.imageComplete(int)

resendTopDownLeftRight

public void resendTopDownLeftRight(ImageProducer ip)

回應來自 ImageConsumer 的一個按 TopDownLeftRight (TDLR) 順序將像素資料重新發送的請求。當由此 ImageFilter 的某個實例所送入資料的 ImageConsumer 請求按 TDLR 順序重新發送資料時，FilteredImageSource 就調用 ImageFilter 的此方法。

ImageFilter 子類別不一定覆寫此方法，這取決於它是否可以以及如何以 TDLR 順序發送資料。有三種可能的回應方式：

• 不覆寫此方法。這使得該子類別使用預設的實作，即將這一請求轉發到指定的 ImageProducer，而這一 ImageProducer 把這一過濾器當作請求的 ImageConsumer。如果過濾器可以確定其上游生產者物件以 TDLR 順序發送像素，那麼它也將以 TDLR 順序轉發像素，那麼該行為是合適的。
• 覆寫該方法，只是簡單地發送資料。如果過濾器可以自行處理請求（例如，如果產生的像素已經保存在某類別緩衝區中），則此行為是合適的。
• 覆寫此方法，不執行任何操作。如果過濾器無法以 TDLR 順序產生過濾資料，則此行為是合適的。

參數：

ip - 為此過濾器實例送入資料的 ImageProducer，必要時也可是應該將請求轉發到的 ImageProducer

拋出：

NullPointerException - 如果 ip 為 null

另請參見：

ImageProducer.requestTopDownLeftRightResend(java.awt.image.ImageConsumer)

clone

public Object clone()

複製此物件。

覆寫：

類別 Object 中的 clone

返回：

此實例的一個副本。

另請參見：

Cloneable