jj2000.disp

Class BlkImgDataSrcImageProducer

java.lang.Object

jj2000.disp.BlkImgDataSrcImageProducer

All Implemented Interfaces:

ImageProducer

public class BlkImgDataSrcImageProducer
extends Object
implements ImageProducer

This class provides an ImageProducer for the BlkImgDataSrc interface. It will request data from the BlkImgDataSrc source and deliver it to the registered image consumers. The data is requested line by line, starting at the top of each tile. The tiles are requested in raster-scan order.

The image data is not rescaled to fit the available dynamic range (not even the alpha values for RGBA data).

BlkImgDataSrc sources with 1, 3 and 4 components are supported. If 1, it is assumed to be gray-level data. If 3 it is assumed to be RGB data, in that order. If 4 it is assumed to be RGBA data (RGB plus alpha plane), in that order. All components must have the same size.

See Also:

ImageProducer, BlkImgDataSrc

Constructor Summary

Constructors

Constructor and Description
BlkImgDataSrcImageProducer(BlkImgDataSrc src) Creates an image producer which uses 'src' as the source of image data.

Method Summary

Methods

Modifier and Type	Method and Description
void	addConsumer(ImageConsumer ic) Registers an image consumer with this image producer.
static Image	createImage(BlkImgDataSrc src) Returns an Image object given an BlkImgDataSrc source.
static Image	createImage(BlkImgDataSrc src, Component c) Returns an Image object given an BlkImgDataSrc source.
boolean	isConsumer(ImageConsumer ic) This method determines if the given image consumer, 'ic', is registered with this image producer.
void	removeConsumer(ImageConsumer ic) Removes the given image consumer 'ic' from the list of consumers registered with this producer.
void	requestTopDownLeftRightResend(ImageConsumer ic) Starts the delivery of pixel data in the top-down letf-right order to the image consumer 'ic'.
void	startProduction(ImageConsumer ic) Registers the given ImageConsumer object as a consumer and starts an immediate reconstruction of the image data which will then be delivered to this consumer and any other consumer which may have already been registered with the producer.

Methods inherited from class java.lang.Object

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

Constructor Detail

BlkImgDataSrcImageProducer

public BlkImgDataSrcImageProducer(BlkImgDataSrc src)

Creates an image producer which uses 'src' as the source of image data. If 'once' is true then the image is produced only once.

Parameters:

src - The source of image data.

once - If the image is to be produced only once or not.

Method Detail

createImage

public static Image createImage(BlkImgDataSrc src)

Returns an Image object given an BlkImgDataSrc source. It will use a new J2KImageProducer object as the underlying image producer.

This method uses the JVM default Toolkit, which might not be what it is desired.

Parameters:

src - The source of image data.

Returns:

An image which has a J2KImageProducer object as the underlying image producer.

createImage

public static Image createImage(BlkImgDataSrc src,
                Component c)

Returns an Image object given an BlkImgDataSrc source. It will use a new J2KImageProducer object as the underlying image producer.

This method uses the component's toolkit. The toolkit of a component may change if it is moved from one frame to another one, since it is the frame that controls which toolkit is used.

Parameters:

src - The source of image data.

c - The component to use to generate the 'Image' object from the 'ImageProducer'.

Returns:

An image which has a J2KImageProducer object as the underlying image producer.

addConsumer

public final void addConsumer(ImageConsumer ic)

Registers an image consumer with this image producer. The delivery of image data does not start immediately. It will only start after the next call to the startProduction() method.

Specified by:

addConsumer in interface ImageProducer

Parameters:

ic - The image consumer to which image data has to be delivered.

See Also:

startProduction(java.awt.image.ImageConsumer)

isConsumer

public boolean isConsumer(ImageConsumer ic)

This method determines if the given image consumer, 'ic', is registered with this image producer.

Specified by:

isConsumer in interface ImageProducer

Parameters:

ic - The image consumer to test.

Returns:

True if 'ic' is registered with this image producer, false otherwise.

removeConsumer

public void removeConsumer(ImageConsumer ic)

Removes the given image consumer 'ic' from the list of consumers registered with this producer. This image producer will stop sending pixel data to 'ic' as soon as it is feasible. The method call is ignored if 'ic' has not been registered with this image producer.

Specified by:

removeConsumer in interface ImageProducer

Parameters:

ic - The image consumer to be removed

startProduction

public void startProduction(ImageConsumer ic)

Registers the given ImageConsumer object as a consumer and starts an immediate reconstruction of the image data which will then be delivered to this consumer and any other consumer which may have already been registered with the producer.

Delivery is performed in "parallel" to all the registered image consumers. By "parallel" it is meant that each line of the image is delivered to all consumers before delivering the next line.

If the data returned by the BlkImgDataSrc source happens to be progressive (see BlkImgDataSrc and DataBlk) then the abort condition is sent to the image consumers and no further data is delivered.

Once all the data is sent to a consumer this one is automatically removed from the list of registered ones, unless an abort happens.

To start the BlkImgDataSrc is set to tile (0,0), and the tiles are produced in raster sacn order. Once the last tile is produced, setTile(0,0) is called again, which signals that we are done with the current tile, which might free up resources.

Specified by:

startProduction in interface ImageProducer

Parameters:

ic - The image consumer to register

requestTopDownLeftRightResend

public void requestTopDownLeftRightResend(ImageConsumer ic)

Starts the delivery of pixel data in the top-down letf-right order to the image consumer 'ic'. The TOPDOWNLEFTRIGHT hint is set in the image consumer on delivery.

Currently this call is ignored (which is perfectly legal according to the ImageProducer interface specification).

Specified by:

requestTopDownLeftRightResend in interface ImageProducer

Parameters:

ic - The image consumer to which the data is sent in top-down, left-right order.