This method should return true if further updates are needed or false if the required information has been acquired. The image which was being tracked is passed in using the img argument. Various constants are combined to form the infoflags argument which indicates what information about the image is now available. The interpretation of the x, y, width, and height arguments depends on the contents of the infoflags argument.
The infoflags argument should be the bitwise inclusive OR of the following flags: WIDTH, HEIGHT, PROPERTIES, SOMEBITS, FRAMEBITS, ALLBITS, ERROR, ABORT.
@param img the image being observed.
@param infoflags the bitwise inclusive OR of the followingflags: WIDTH, HEIGHT, PROPERTIES, SOMEBITS, FRAMEBITS, ALLBITS, ERROR, ABORT.
@param x the x coordinate.
@param y the y coordinate.
@param width the width.
@param height the height.
@return false if the infoflags indicate that theimage is completely loaded; true otherwise.
@see #WIDTH
@see #HEIGHT
@see #PROPERTIES
@see #SOMEBITS
@see #FRAMEBITS
@see #ALLBITS
@see #ERROR
@see #ABORT
@see Image#getWidth
@see Image#getHeight
@see ae.java.awt.Graphics#drawImage
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 ImageReader implementation 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, and height); X and Y subsampling factors (periodX and periodY); 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)@param source the
ImageReader object calling this method.
@param theImage the BufferedImage being updated.
@param minX the X coordinate of the leftmost updated columnof pixels.
@param minY the Y coordinate of the uppermost updated rowof pixels.
@param width the number of updated pixels horizontally.
@param height the number of updated pixels vertically.
@param periodX the horizontal spacing between updated pixels;a value of 1 means no gaps.
@param periodY the vertical spacing between updated pixels;a value of 1 means no gaps.
@param bands an array of ints indicating whichbands are being updated.
This method should return true if further updates are needed or false if the required information has been acquired. The image which was being tracked is passed in using the img argument. Various constants are combined to form the infoflags argument which indicates what information about the image is now available. The interpretation of the x, y, width, and height arguments depends on the contents of the infoflags argument.
The infoflags argument should be the bitwise inclusive OR of the following flags: WIDTH, HEIGHT, PROPERTIES, SOMEBITS, FRAMEBITS, ALLBITS, ERROR, ABORT.
@param img the image being observed.
@param infoflags the bitwise inclusive OR of the following flags: WIDTH, HEIGHT, PROPERTIES, SOMEBITS, FRAMEBITS, ALLBITS, ERROR, ABORT.
@param x the x coordinate.
@param y the y coordinate.
@param width the width.
@param height the height.
@return false if the infoflags indicate that theimage is completely loaded; true otherwise.
@see #WIDTH
@see #HEIGHT
@see #PROPERTIES
@see #SOMEBITS
@see #FRAMEBITS
@see #ALLBITS
@see #ERROR
@see #ABORT
@see Image#getWidth
@see Image#getHeight
@see java.awt.Graphics#drawImage
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 ImageReader implementation 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, and height); X and Y subsampling factors (periodX and periodY); 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)@param source the
ImageReader object calling this method.
@param theImage the BufferedImage being updated.
@param minX the X coordinate of the leftmost updated columnof pixels.
@param minY the Y coordinate of the uppermost updated rowof pixels.
@param width the number of updated pixels horizontally.
@param height the number of updated pixels vertically.
@param periodX the horizontal spacing between updated pixels;a value of 1 means no gaps.
@param periodY the vertical spacing between updated pixels;a value of 1 means no gaps.
@param bands an array of ints indicating whichbands are being updated.
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |