Packages  This Package  Prev  Next  Index  

public  interface  java.awt.image.ImageConsumer
{
          // status value for the imageComplete method
        public final static int IMAGEABORTED;	§2.10.1
        public final static int IMAGEERROR;	§2.10.2
        public final static int SINGLEFRAMEDONE;	§2.10.3
        public final static int STATICIMAGEDONE;	§2.10.4

          // hints used by the setHints method
        public final static int COMPLETESCANLINES;	§2.10.5
        public final static int RANDOMPIXELORDER;	§2.10.6
        public final static int SINGLEFRAME;	§2.10.7
        public final static int SINGLEPASS;	§2.10.8
        public final static int TOPDOWNLEFTRIGHT;	§2.10.9

          // Methods
        public abstract void imageComplete(int  status);	§2.10.10
        public abstract void setColorModel(ColorModel  model);	§2.10.11
        public abstract void	§2.10.12
             setDimensions(int  width, int  height);
        public abstract void setHints(int  hintflags);	§2.10.13
        public abstract void 	§2.10.14
             setPixels(int  x, int  y, int  w, int  h,
                            ColorModel  model, byte  pixels[],
                            int  off, int  scansize);
        public abstract void	§2.10.15
             setPixels(int  x, int  y, int  w, int  h,
                            ColorModel  model, int  pixels[],
                            int  off, int  scansize);
        public abstract void setProperties(Hashtable  props); §2.10.16
}

When a consumer is added to an image producer, the producer delivers all the data about the image using the method calls defined in this interface.

Argument to the imageComplete method (II-§2.10.10) indicating that the image creation process was deliberately aborted.

Argument to the imageComplete method (II-§2.10.10) indicating that an error was encountered while producing the image.

Argument to the imageComplete method (II-§2.10.10) indicating that one frame of the image is complete but there are more frames to be delivered.

Argument to the imageComplete method (II-§2.10.10) indicating that the image is complete and there are no more pixels or frames to be delivered.

Flag in the setHints method (II-§2.10.13) indicating that the pixels will be delivered in (multiples of) complete scanlines at a time..

Flag in the setHints method (II-§2.10.13) indicating that the pixels will be delivered in a random order.

The image consumer should not use any optimizations that depend on the order of pixel delivery. If the image producer doesn't call the setHints method, the image consumer should assume that the bits are being delivered in a random order..

Flag in the setHints method (II-§2.10.13) indicating that the image contains a single static image. The pixels will be defined in calls to the setPixels methods; the image producer then calls the imageComplete method (II-§2.10.10) with the STATICIMAGEDONE flag (II-§2.10.4) after which no more image data is delivered.

Examples of image types that do not meet these criteria include the output of a video feed, or the representation of a 3D rendering being manipulated by the user. The end of each frame of those types of images is indicated by the image producer calling the imageComplete method (II-§2.10.10) with the SINGLEFRAMEDONE flag (II-§2.10.4).

Flag in the setHints method (II-§2.10.13) indicating that each pixel will be delivered only once.

An image type that does not meet this criterion is a progressive JPEG image which defines pixels in multple passes, each more refined than the previous.

Flag in the setHints method (II-§2.10.13) indicating that the pixels will be delivered in a top-down, left-to-right order.

The image producer calls the imageComplete method when one of the following conditions has occurred:

• it has delivered all the pixels that the source image contains,

• a single frame of a multi-frame animation has been completed,
• an error in loading or producing the image has occurred.
• the image production was explicitly aborted by the application.

The image consumer should remove itself from the list of consumers registered with the image producer (II-§2.12.3), unless it is interested in subsequent frames.

The status is one of the following values:

ImageConsumer.IMAGEERROR (II-§2.10.2)
ImageConsumer.SINGLEFRAMEDONE (II-§2.10.7)
ImageConsumer.STATICIMAGEDONE (II-§2.10.4)
ImageConsumer.IMAGEABORTED (II-§2.10.1)

Parameters:

status - the status of the image

The image producer calls the setColorModel method to specify the color model (II-§2.1) for the majority of the subsequent setPixels method calls.

Each set of pixels delivered using the setPixels method includes its own color model, so the image consumer should not assume that the model argument is the color model argument in every subsequent setPixels method call.

A notable case where multiple ColorModel objects may be seen is a filtered image where for each set of pixels that it filters, the filter determines whether the pixels can be sent on untouched, using the original ColorModel, or should be modified (filtered) and passed on using a ColorModel more convenient for the filtering process.

Parameters:

model - a color map used in subsequent setPixel calls

The image producer calls the setDimensions of the image consumer to indicate the width and height of the image.

Parameters:

width - the width of the image

height - the height of the image

The image producer calls the setHints method of the image consumer to indicate the order in which the bits will be delivered.

The image producer is allowed to deliver the pixels in any order, but the image consumer may be able to scale or convert the pixels more efficiently or with higher quality if it knows some information about how the pixels will be presented.

The image producer should call the setHints method before any calls to the image consumer's setPixels method.

The hintflags agument is a bit mask of hints about the manner in which the pixels are delivered.

The possible hint flags are:

COMPLETESCANLINES (II-§2.10.5)
RANDOMPIXELORDER (II-§2.10.5)
SINGLEFRAME (II-§2.10.5)
SINGLEPASS (II-§2.10.5)
TOPDOWNLEFTRIGHT (II-§2.10.5)

Parameters:

hints - hints about the order in which the bits will be delivered

The image producer calls the setPixels method of the image consumer one or more times to deliver the pixels of the image. Each call specifies the location and size of the rectangle of source pixels contained in the array of pixels.

The specified color model object should be used to convert the pixels into their corresponding color and alpha components. The pixel at coordinate is stored in the pixel array at index

The pixels delivered using this method are all stored as bytes.

Parameters:

x - left coordinate of rectangle

y - top coordinte of rectangle

w - width of rectangle

h - height of rectangle

model - color model for bits

pixels - array of bits

off - offset for first element

scansize - number of elements per row

The image producer calls the setPixels method of the image consumer one or more times to deliver the pixels of the image. Each call specifies the location and size of the rectangle of source pixels that are contained in the array of pixels.

The specified color model object should be used to convert the pixels into their corresponding color and alpha components. The pixel at coordinate is stored in the pixel array at index

The pixels delivered using this method are all stored as integers.

Parameters:

x - left coordinate of rectangle

y - top coordinte of rectangle

w - width of rectangle

h - height of rectangle

model - color model for bits

pixels - array of bits

off - offset for first element

The image producer calls the setProperties method of the image consumer to indicate additional properties of the image.

All keys to the hash table are strings. The corresponding values depend on the string.

Parameters:

props - a hashtable of properties

See Also:

getProperty in class Image (II-§1.24.6).

Packages  This Package  Prev  Next  Index