模块 java.desktop

软件包 java.awt.image

Class 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实例正在过滤数据的特定图像数据流的使用者。

Fields declared in interface java.awt.image.ImageConsumer

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

构造方法摘要

构造方法

构造器	描述
ImageFilter()

方法摘要

变量和类型	方法	描述
Object	clone()	克隆此对象。
ImageFilter	getFilterInstance(ImageConsumer ic)	返回ImageFilter对象的唯一实例，该实例将实际执行指定ImageConsumer的过滤。
void	imageComplete(int status)	过滤ImageConsumer接口的imageComplete方法中提供的信息。
void	resendTopDownLeftRight(ImageProducer ip)	响应来自ImageConsumer的TopDownLeftRight（TDLR）有序重发像素数据的 ImageConsumer 。
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方法中提供的信息，该方法接受一个字节数组。
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)

返回ImageFilter对象的唯一实例，该实例将实际执行指定ImageConsumer的过滤。 默认实现只是克隆此对象。

注意：此方法旨在由正在过滤像素的Image的ImageProducer调用。 使用此类从图像中过滤像素的开发人员应避免直接调用此方法，因为该操作可能会干扰过滤操作。

参数

ic - 指定的 ImageConsumer

结果

ImageFilter用于执行指定的 ImageConsumer的过滤。

setDimensions

public void setDimensions(int width,
                          int height)

过滤ImageConsumer接口的setDimensions方法中提供的信息。

注意：此方法旨在由正在过滤像素的Image的ImageProducer调用。 使用此类从图像中过滤像素的开发人员应避免直接调用此方法，因为该操作可能会干扰过滤操作。

Specified by:

setDimensions ，界面 ImageConsumer

参数

width - 源图像的宽度

height - 源图像的高度

另请参见：

ImageConsumer.setDimensions(int, int)

setProperties

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

在添加指示已运行的过滤器流的属性后，从源对象传递属性。

注意：此方法旨在由正在过滤像素的Image的ImageProducer调用。 使用此类从图像中过滤像素的开发人员应避免直接调用此方法，因为该操作可能会干扰过滤操作。

Specified by:

setProperties ，界面 ImageConsumer

参数

props - 源对象的属性

异常

NullPointerException - 如果 props为空

setColorModel

public void setColorModel(ColorModel model)

过滤ImageConsumer接口的setColorModel方法中提供的信息。

注意：此方法旨在由正在过滤像素的Image的ImageProducer调用。 使用此类从图像中过滤像素的开发人员应避免直接调用此方法，因为该操作可能会干扰过滤操作。

Specified by:

setColorModel在界面 ImageConsumer

参数

model - 指定的 ColorModel

另请参见：

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

setHints

public void setHints(int hints)

过滤ImageConsumer接口的setHints方法中提供的信息。

注意：此方法旨在由正在过滤像素的Image的ImageProducer调用。 使用此类从图像中过滤像素的开发人员应避免直接调用此方法，因为该操作可能会干扰过滤操作。

Specified by:

setHints在界面 ImageConsumer

参数

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方法中提供的信息，该方法接受一个字节数组。

注意：此方法旨在由正在过滤像素的Image的ImageProducer调用。 使用此类从图像中过滤像素的开发人员应避免直接调用此方法，因为该操作可能会干扰过滤操作。

Specified by:

setPixels在界面 ImageConsumer

参数

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调用。 使用此类从图像中过滤像素的开发人员应避免直接调用此方法，因为该操作可能会干扰过滤操作。

Specified by:

setPixels in interface ImageConsumer

参数

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调用。 使用此类从图像中过滤像素的开发人员应避免直接调用此方法，因为该操作可能会干扰过滤操作。

Specified by:

imageComplete在界面 ImageConsumer

参数

status - 图像加载的状态

另请参见：

ImageConsumer.imageComplete(int)

resendTopDownLeftRight

public void resendTopDownLeftRight(ImageProducer ip)

响应来自ImageConsumer的TopDownLeftRight（TDLR）有序重新发送像素数据的ImageConsumer 。 当ImageConsumer被此实例馈送ImageFilter请求在TDLR顺序的数据的重发，所述FilteredImageSource调用此方法ImageFilter 。

ImageFilter子类可能会覆盖此方法，具体取决于它是否以及如何以TDLR顺序发送数据。 存在三种可能性：

• 不要覆盖此方法。 这使得该子类使用默认的实现，这是将请求转发到指定ImageProducer使用此过滤器的请求ImageConsumer 。 如果过滤器可以确定如果其上游生成器对象以TDLR顺序发送它们将以TDLR顺序转发像素，则此行为是适当的。
• 覆盖方法以简单地发送数据。 如果过滤器可以自己处理请求，这是合适的 - 例如，如果生成的像素已保存在某种缓冲区中。
• 覆盖该方法不执行任何操作。 如果过滤器无法以TDLR顺序生成过滤数据，则这是合适的。

参数

ip - 为此过滤器实例提供的ImageProducer - 如果需要，还应该转发请求的ImageProducer

异常

NullPointerException - 如果 ip为空

另请参见：

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

clone

public Object clone()

克隆此对象。

重写：

clone ，类 Object

结果

这个实例的克隆。

另请参见：

Cloneable