接口 java.awt.image.ImageConsumer

public interface ImageConsumer

这是一个对通过 ImageProducer 接口的图像数据感兴趣的对象的接口。当将一个消费者添加到图像生产者中时，生产者使用定义在该接口中的方法调用来传送所有图像数据。

参见：

ImageProducer

变量索引

COMPLETESCANLINES

像素以每次传送(多行)完整扫描行的方式传送。

IMAGEABORTED

图像的创建进程被故意中断。

IMAGEERROR

生成图像时发生错误。

RANDOMPIXELORDER

像素以随机次序传送。

SINGLEFRAME

图像包含一个单个静态图像。

SINGLEFRAMEDONE

图像的一个帧已完成传送，但还有更多的帧要发送。

SINGLEPASS

像素将只被发送一次。

STATICIMAGEDONE

图像已完成传送，没有更多的像素或帧需要传送。

TOPDOWNLEFTRIGHT

像素将以从上到下，从左到右的次序传送。

方法索引

imageComplete(int)

当发生下列情况时，imageComplete 方法被调用：ImageProducer 完成源图像包含的所有像素的传送；多帧动画的一帧已完成传送；装入或产生图像时产生错误。

setColorModel(ColorModel)

ColorModel 对象适用于大多数使用 setPixels 方法调用进行报告的像素。

setDimensions(int, int)

使用 setDimensions 方法调用来报告源图像的尺寸。

setHints(int)

ImageProducer 可以任何次序传送像素，但 ImageConsumer 知道更多有关如何向上，向前传送像素的信息，它可将像素缩放或转换为更有效的，或质量更高的目标 ColorModel。

setPixels(int, int, int, int, ColorModel, byte[], int, int)

使用 setPixels 方法的一个或多个调用传送图像的像素。

setPixels(int, int, int, int, ColorModel, int[], int, int)

使用 setPixels 方法的一个或多个调用传送图像的像素。

setProperties(Hashtable)

设置与该图像相关的特性的可扩展列表。

变量

 public static final int RANDOMPIXELORDER

像素将以随机次序传送。该变量通知 ImageConsumer 不要使用任何取决于像素传送次序的优化措施，这是在缺少任何一个 setHints 方法的调用情况下的缺省假设。

参见：

setHints

 public static final int TOPDOWNLEFTRIGHT

像素将以从上到下，从左到右的次序传送。

参见：

setHints

 public static final int COMPLETESCANLINES

像素以每次传送(多行)完整扫描行的方式传送。

参见：

setHints

 public static final int SINGLEPASS

像素将只被传送一次。每个像素将只出现在任意一个 setPixels 方法的一个调用中。一个可逐步实现传送的 JPEG 图像是一个不符合该标准的图像格式的例子，它定义了可多次传送的像素，并且它的每次传送都比上次更细化。

参见：

setHints

 public static final int SINGLEFRAME

图像包含一个单个静态图像。像素将在 setPixels 方法调用中被定义，其后在没有更多图像数据要传送时，将使用 STATICIMAGEDONE 标志调用 imageComplete 方法。不符合这些标准的图像类型的例子有：视频传入的输出，或用户操纵的 3D 描绘的表示。通过使用 SINGLEFRAMEDONE 标志调用 imageComplete，来表示这种类型的图像的每一帧的结束。

参见：

setHints, imageComplete

 public static final int IMAGEERROR

生成图像时产生错误。

参见：

imageComplete

 public static final int SINGLEFRAMEDONE

图像的一个帧已完成传送，但还有更多的帧要发送。

参见：

imageComplete

 public static final int STATICIMAGEDONE

图像已完成传送，没有更多的像素或帧需要发送。

参见：

imageComplete

 public static final int IMAGEABORTED

图像的创建进程被故意中断。

参见：

imageComplete

方法

 public abstract void setDimensions(int width,
                                    int height)

使用 setDimensions 方法调用报告源图像的尺寸。

 public abstract void setProperties(Hashtable props)

设置与该图像相关的特性的可扩展列表。

 public abstract void setColorModel(ColorModel model)

ColorModel 对象用于使用 setPixels 方法调用进行报告的大多数像素。注意：每个使用 setPixels 方法传送的像素集合包含其本身的 ColorModel 对象，因此不应生成该模型是用于传送像素值的唯一模型的假设。应注意以下情况：此时对于这个过滤器过滤的每个像素集，可以看到的多 ColorModel 对象是一个已过滤的图像。过滤器确定了像素是否可使用初始的 ColorModel 无接触地发送，或过滤过程是否应使用更方便的 ColorModel 来修改 ( 过滤 ) 并传送像素。

参见：

ColorModel

 public abstract void setHints(int hintflags)

ImageProducer 可以以任何次序传送像素，但若 ImageConsumer 知道更多有关如何向上，向前传送像素的信息， 它可将像素缩放或转换为更有效的，或质量更高的目标 ColorModel。 setHints 方法应在任何使用该像素传送方式掩码的 setPixels 方法调用前调用。若 ImageProducer 不遵循提示的指南，那结果就是未定义的。

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

使用 setPixels 方法的一个或多个调用传送图像的像素。每个调用指明了包含在像素数组中的源像素矩形的位置和大小。可用指定的 ColorModel 对象将像素转换为它的相应的颜色和初始透明成分。像素 (m,n) 保存在像素数组中，其下标为 (n * scansize + m + off)。使用该方法传送的像素都以字节方式保存。

参见：

ColorModel

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

使用 setPixels 方法的一个或多个调用传送图像的像素。每个调用指明了包含在像素数组中的源像素矩形的位置和大小。可用指定的 ColorModel 对象将像素转换为它的相应的颜色和初始透明成分。像素 (m,n) 保存在像素数组中，其下标为 (n * scansize + m + off)。使用该方法传送的像素都以整数方式保存。

参见：

ColorModel

 public abstract void imageComplete(int status)

当发生下列情况时，imageComplete 方法被调用：ImageProducer 完成源图像包含的所有像素的传送；多帧动画的一帧已完成传送；装入或产生图像时产生错误。除非 ImageConsumer 对连续的帧感兴趣，否则它应从本次使用 ImageProducer 进行注册的消费者列表中删除它本身。

参见：

removeConsumer