-
- All Superinterfaces:
- EventListener
public interface IIOReadProgressListener extends EventListener
An interface used byImageReader
implementations to notify callers of their image and thumbnail reading methods of progress.This interface receives general indications of decoding progress (via the
imageProgress
andthumbnailProgress
methods), and events indicating when an entire image has been updated (via theimageStarted
,imageComplete
,thumbnailStarted
andthumbnailComplete
methods). Applications that wish to be informed of pixel updates as they happen (for example, during progressive decoding), should provide anIIOReadUpdateListener
.
-
-
Method Summary
Methods Modifier and Type Method and Description void
imageComplete(ImageReader source)
Reports that the current image read operation has completed.void
imageProgress(ImageReader source, float percentageDone)
Reports the approximate degree of completion of the currentread
call of the associatedImageReader
.void
imageStarted(ImageReader source, int imageIndex)
Reports that an image read operation is beginning.void
readAborted(ImageReader source)
Reports that a read has been aborted via the reader'sabort
method.void
sequenceComplete(ImageReader source)
Reports that a sequence of read operationshas completed.void
sequenceStarted(ImageReader source, int minIndex)
Reports that a sequence of read operations is beginning.void
thumbnailComplete(ImageReader source)
Reports that a thumbnail read operation has completed.void
thumbnailProgress(ImageReader source, float percentageDone)
Reports the approximate degree of completion of the currentgetThumbnail
call within the associatedImageReader
.void
thumbnailStarted(ImageReader source, int imageIndex, int thumbnailIndex)
Reports that a thumbnail read operation is beginning.
-
-
-
Method Detail
-
sequenceStarted
void sequenceStarted(ImageReader source, int minIndex)
Reports that a sequence of read operations is beginning.ImageReader
implementations are required to call this method exactly once from theirreadAll(Iterator)
method.- Parameters:
source
- theImageReader
object calling this method.minIndex
- the index of the first image to be read.
-
sequenceComplete
void sequenceComplete(ImageReader source)
Reports that a sequence of read operationshas completed.ImageReader
implementations are required to call this method exactly once from theirreadAll(Iterator)
method.- Parameters:
source
- theImageReader
object calling this method.
-
imageStarted
void imageStarted(ImageReader source, int imageIndex)
Reports that an image read operation is beginning. AllImageReader
implementations are required to call this method exactly once when beginning an image read operation.- Parameters:
source
- theImageReader
object calling this method.imageIndex
- the index of the image being read within its containing input file or stream.
-
imageProgress
void imageProgress(ImageReader source, float percentageDone)
Reports the approximate degree of completion of the currentread
call of the associatedImageReader
.The degree of completion is expressed as a percentage varying from
0.0F
to100.0F
. 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
ImageReader
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
- theImageReader
object calling this method.percentageDone
- the approximate percentage of decoding that has been completed.
-
imageComplete
void imageComplete(ImageReader source)
Reports that the current image read operation has completed. AllImageReader
implementations are required to call this method exactly once upon completion of each image read operation.- Parameters:
source
- theImageReader
object calling this method.
-
thumbnailStarted
void thumbnailStarted(ImageReader source, int imageIndex, int thumbnailIndex)
Reports that a thumbnail read operation is beginning. AllImageReader
implementations are required to call this method exactly once when beginning a thumbnail read operation.- Parameters:
source
- theImageReader
object calling this method.imageIndex
- the index of the image being read within its containing input file or stream.thumbnailIndex
- the index of the thumbnail being read.
-
thumbnailProgress
void thumbnailProgress(ImageReader source, float percentageDone)
Reports the approximate degree of completion of the currentgetThumbnail
call within the associatedImageReader
. The semantics are identical to those ofimageProgress
.- Parameters:
source
- theImageReader
object calling this method.percentageDone
- the approximate percentage of decoding that has been completed.
-
thumbnailComplete
void thumbnailComplete(ImageReader source)
Reports that a thumbnail read operation has completed. AllImageReader
implementations are required to call this method exactly once upon completion of each thumbnail read operation.- Parameters:
source
- theImageReader
object calling this method.
-
readAborted
void readAborted(ImageReader source)
Reports that a read has been aborted via the reader'sabort
method. No further notifications will be given.- Parameters:
source
- theImageReader
object calling this method.
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-javax/imageio/event/IIOReadProgressListener.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.