-
- All Superinterfaces:
- EventListener
public interface IIOWriteProgressListener extends EventListener
An interface used byImageWriter
implementations to notify callers of their image writing methods of progress.
-
-
Method Summary
Methods Modifier and Type Method and Description void
imageComplete(ImageWriter source)
Reports that the image write operation has completed.void
imageProgress(ImageWriter source, float percentageDone)
Reports the approximate degree of completion of the currentwrite
call within the associatedImageWriter
.void
imageStarted(ImageWriter source, int imageIndex)
Reports that an image write operation is beginning.void
thumbnailComplete(ImageWriter source)
Reports that a thumbnail write operation has completed.void
thumbnailProgress(ImageWriter source, float percentageDone)
Reports the approximate degree of completion of the current thumbnail write within the associatedImageWriter
.void
thumbnailStarted(ImageWriter source, int imageIndex, int thumbnailIndex)
Reports that a thumbnail write operation is beginning.void
writeAborted(ImageWriter source)
Reports that a write has been aborted via the writer'sabort
method.
-
-
-
Method Detail
-
imageStarted
void imageStarted(ImageWriter source, int imageIndex)
Reports that an image write operation is beginning. AllImageWriter
implementations are required to call this method exactly once when beginning an image write operation.- Parameters:
source
- theImageWriter
object calling this method.imageIndex
- the index of the image being written within its containing input file or stream.
-
imageProgress
void imageProgress(ImageWriter source, float percentageDone)
Reports the approximate degree of completion of the currentwrite
call within the associatedImageWriter
.The degree of completion is expressed as an index indicating which image is being written, and a percentage varying from
0.0F
to100.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 values0
and100
, 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.- Parameters:
source
- theImageWriter
object calling this method.percentageDone
- the approximate percentage of decoding that has been completed.
-
imageComplete
void imageComplete(ImageWriter source)
Reports that the image write operation has completed. AllImageWriter
implementations are required to call this method exactly once upon completion of each image write operation.- Parameters:
source
- theImageWriter
object calling this method.
-
thumbnailStarted
void thumbnailStarted(ImageWriter source, int imageIndex, int thumbnailIndex)
Reports that a thumbnail write operation is beginning. AllImageWriter
implementations are required to call this method exactly once when beginning a thumbnail write operation.- Parameters:
source
- theImageWrite
object calling this method.imageIndex
- the index of the image being written within its containing input file or stream.thumbnailIndex
- the index of the thumbnail being written.
-
thumbnailProgress
void thumbnailProgress(ImageWriter source, float percentageDone)
Reports the approximate degree of completion of the current thumbnail write within the associatedImageWriter
. The semantics are identical to those ofimageProgress
.- Parameters:
source
- theImageWriter
object calling this method.percentageDone
- the approximate percentage of decoding that has been completed.
-
thumbnailComplete
void thumbnailComplete(ImageWriter source)
Reports that a thumbnail write operation has completed. AllImageWriter
implementations are required to call this method exactly once upon completion of each thumbnail write operation.- Parameters:
source
- theImageWriter
object calling this method.
-
writeAborted
void writeAborted(ImageWriter source)
Reports that a write has been aborted via the writer'sabort
method. No further notifications will be given.- Parameters:
source
- theImageWriter
object calling this method.
-
-
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-javax/imageio/event/IIOWriteProgressListener.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.