- 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)
在添加指示已运行的过滤器流的属性后,从源对象传递属性。
-
-
-
字段详细信息
-
consumer
protected ImageConsumer consumer
此ImageFilter实例正在过滤数据的特定图像数据流的使用者。 它在构造函数期间未初始化,而是在FilteredImageSource为特定图像数据流创建此对象的唯一实例时调用getFilterInstance()期间。
-
-
方法详细信息
-
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 interfaceImageConsumer
- 参数
-
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)
- 不要覆盖此方法。 这使得该子类使用默认的实现,这是将请求转发到指定
-
-