-
- All Superinterfaces:
- EventListener
public interface IIOReadUpdateListener extends EventListener
An interface used byImageReaderimplementations to notify callers of their image and thumbnail reading methods of pixel updates.
-
-
Method Summary
Methods Modifier and Type Method and Description voidimageUpdate(ImageReader source, BufferedImage theImage, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)Reports that a given region of the image has been updated.voidpassComplete(ImageReader source, BufferedImage theImage)Reports that the current read operation has completed a progressive pass.voidpassStarted(ImageReader source, BufferedImage theImage, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)Reports that the current read operation is about to begin a progressive pass.voidthumbnailPassComplete(ImageReader source, BufferedImage theThumbnail)Reports that the current thumbnail read operation has completed a progressive pass.voidthumbnailPassStarted(ImageReader source, BufferedImage theThumbnail, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)Reports that the current thumbnail read operation is about to begin a progressive pass.voidthumbnailUpdate(ImageReader source, BufferedImage theThumbnail, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)Reports that a given region of a thumbnail image has been updated.
-
-
-
Method Detail
-
passStarted
void passStarted(ImageReader source, BufferedImage theImage, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)
Reports that the current read operation is about to begin a progressive pass. Readers of formats that support progressive encoding should use this to notify clients when each pass is completed when reading a progressively encoded image.An estimate of the area that will be updated by the pass is indicated by the
minX,minY,width, andheightparameters. If the pass is interlaced, that is, it only updates selected rows or columns, theperiodXandperiodYparameters will indicate the degree of subsampling. The set of bands that may be affected is indicated by the value ofbands.- Parameters:
source- theImageReaderobject calling this method.theImage- theBufferedImagebeing updated.pass- the numer of the pass that is about to begin, starting with 0.minPass- the index of the first pass that will be decoded.maxPass- the index of the last pass that will be decoded.minX- the X coordinate of the leftmost updated column of pixels.minY- the Y coordinate of the uppermost updated row of pixels.periodX- the horizontal spacing between updated pixels; a value of 1 means no gaps.periodY- the vertical spacing between updated pixels; a value of 1 means no gaps.bands- an array ofints indicating the the set bands that may be updated.
-
imageUpdate
void imageUpdate(ImageReader source, BufferedImage theImage, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)
Reports that a given region of the image has been updated. The application might choose to redisplay the specified area, for example, in order to provide a progressive display effect, or perform other incremental processing.Note that different image format readers may produce decoded pixels in a variety of different orders. Many readers will produce pixels in a simple top-to-bottom, left-to-right-order, but others may use multiple passes of interlacing, tiling, etc. The sequence of updates may even differ from call to call depending on network speeds, for example. A call to this method does not guarantee that all the specified pixels have actually been updated, only that some activity has taken place within some subregion of the one specified.
The particular
ImageReaderimplementation may choose how often to provide updates. Each update specifies that a given region of the image has been updated since the last update. A region is described by its spatial bounding box (minX,minY,width, andheight); X and Y subsampling factors (periodXandperiodY); and a set of updated bands (bands). For example, the update:minX = 10 minY = 20 width = 3 height = 4 periodX = 2 periodY = 3 bands = { 1, 3 }would indicate that bands 1 and 3 of the following pixels were updated:(10, 20) (12, 20) (14, 20) (10, 23) (12, 23) (14, 23) (10, 26) (12, 26) (14, 26) (10, 29) (12, 29) (14, 29)
- Parameters:
source- theImageReaderobject calling this method.theImage- theBufferedImagebeing updated.minX- the X coordinate of the leftmost updated column of pixels.minY- the Y coordinate of the uppermost updated row of pixels.width- the number of updated pixels horizontally.height- the number of updated pixels vertically.periodX- the horizontal spacing between updated pixels; a value of 1 means no gaps.periodY- the vertical spacing between updated pixels; a value of 1 means no gaps.bands- an array ofints indicating which bands are being updated.
-
passComplete
void passComplete(ImageReader source, BufferedImage theImage)
Reports that the current read operation has completed a progressive pass. Readers of formats that support progressive encoding should use this to notify clients when each pass is completed when reading a progressively encoded image.- Parameters:
source- theImageReaderobject calling this method.theImage- theBufferedImagebeing updated.- See Also:
ImageReadParam.setSourceProgressivePasses(int, int)
-
thumbnailPassStarted
void thumbnailPassStarted(ImageReader source, BufferedImage theThumbnail, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)
Reports that the current thumbnail read operation is about to begin a progressive pass. Readers of formats that support progressive encoding should use this to notify clients when each pass is completed when reading a progressively encoded thumbnail image.- Parameters:
source- theImageReaderobject calling this method.theThumbnail- theBufferedImagethumbnail being updated.pass- the numer of the pass that is about to begin, starting with 0.minPass- the index of the first pass that will be decoded.maxPass- the index of the last pass that will be decoded.minX- the X coordinate of the leftmost updated column of pixels.minY- the Y coordinate of the uppermost updated row of pixels.periodX- the horizontal spacing between updated pixels; a value of 1 means no gaps.periodY- the vertical spacing between updated pixels; a value of 1 means no gaps.bands- an array ofints indicating the the set bands that may be updated.- See Also:
passStarted(javax.imageio.ImageReader, java.awt.image.BufferedImage, int, int, int, int, int, int, int, int[])
-
thumbnailUpdate
void thumbnailUpdate(ImageReader source, BufferedImage theThumbnail, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)
Reports that a given region of a thumbnail image has been updated. The application might choose to redisplay the specified area, for example, in order to provide a progressive display effect, or perform other incremental processing.- Parameters:
source- theImageReaderobject calling this method.theThumbnail- theBufferedImagethumbnail being updated.minX- the X coordinate of the leftmost updated column of pixels.minY- the Y coordinate of the uppermost updated row of pixels.width- the number of updated pixels horizontally.height- the number of updated pixels vertically.periodX- the horizontal spacing between updated pixels; a value of 1 means no gaps.periodY- the vertical spacing between updated pixels; a value of 1 means no gaps.bands- an array ofints indicating which bands are being updated.- See Also:
imageUpdate(javax.imageio.ImageReader, java.awt.image.BufferedImage, int, int, int, int, int, int, int[])
-
thumbnailPassComplete
void thumbnailPassComplete(ImageReader source, BufferedImage theThumbnail)
Reports that the current thumbnail read operation has completed a progressive pass. Readers of formats that support progressive encoding should use this to notify clients when each pass is completed when reading a progressively encoded thumbnail image.- Parameters:
source- theImageReaderobject calling this method.theThumbnail- theBufferedImagethumbnail being updated.- See Also:
passComplete(javax.imageio.ImageReader, java.awt.image.BufferedImage)
-
-
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/iioreadupdatelistener.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 van 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.