FileDocCategorySizeDatePackage
IIOWriteProgressListener.javaAPI DocJava SE 5 API4690Fri Aug 26 14:57:30 BST 2005javax.imageio.event

IIOWriteProgressListener

public interface IIOWriteProgressListener implements EventListener
An interface used by ImageWriter implementations to notify callers of their image writing methods of progress.
see
javax.imageio.ImageWriter#write
version
0.5

Fields Summary
Constructors Summary
Methods Summary
public voidimageComplete(javax.imageio.ImageWriter source)
Reports that the image write operation has completed. All ImageWriter implementations are required to call this method exactly once upon completion of each image write operation.

param
source the ImageWriter object calling this method.

public voidimageProgress(javax.imageio.ImageWriter source, float percentageDone)
Reports the approximate degree of completion of the current write call within the associated ImageWriter.

The degree of completion is expressed as an index indicating which image is being written, and a percentage varying from 0.0F to 100.0F indicating how much of the current image has been output. The percentage should ideally be calculated in terms of the remaining time to completion, but it is usually more practical to use a more well-defined metric such as pixels decoded or portion of input stream consumed. In any case, a sequence of calls to this method during a given read operation should supply a monotonically increasing sequence of percentage values. It is not necessary to supply the exact values 0 and 100, as these may be inferred by the callee from other methods.

Each particular ImageWriter implementation may call this method at whatever frequency it desires. A rule of thumb is to call it around each 5 percent mark.

param
source the ImageWriter object calling this method.
param
percentageDone the approximate percentage of decoding that has been completed.

public voidimageStarted(javax.imageio.ImageWriter source, int imageIndex)
Reports that an image write operation is beginning. All ImageWriter implementations are required to call this method exactly once when beginning an image write operation.

param
source the ImageWriter object calling this method.
param
imageIndex the index of the image being written within its containing input file or stream.

public voidthumbnailComplete(javax.imageio.ImageWriter source)
Reports that a thumbnail write operation has completed. All ImageWriter implementations are required to call this method exactly once upon completion of each thumbnail write operation.

param
source the ImageWriter object calling this method.

public voidthumbnailProgress(javax.imageio.ImageWriter source, float percentageDone)
Reports the approximate degree of completion of the current thumbnail write within the associated ImageWriter. The semantics are identical to those of imageProgress.

param
source the ImageWriter object calling this method.
param
percentageDone the approximate percentage of decoding that has been completed.

public voidthumbnailStarted(javax.imageio.ImageWriter source, int imageIndex, int thumbnailIndex)
Reports that a thumbnail write operation is beginning. All ImageWriter implementations are required to call this method exactly once when beginning a thumbnail write operation.

param
source the ImageWrite object calling this method.
param
imageIndex the index of the image being written within its containing input file or stream.
param
thumbnailIndex the index of the thumbnail being written.

public voidwriteAborted(javax.imageio.ImageWriter source)
Reports that a write has been aborted via the writer's abort method. No further notifications will be given.

param
source the ImageWriter object calling this method.