Returns an
Iterator
containing all the images,
thumbnails, and metadata, starting at the index given by
getMinIndex
, from the input source in the form of
IIOImage
objects.
Returns an
Iterator
containing all the images,
thumbnails, and metadata, starting at the index given by
getMinIndex
, from the input source in the form of
IIOImage
objects. An
Iterator
containing
ImageReadParam
objects is supplied; one
element is consumed for each image read from the input source
until no more images are available. If the read param
Iterator
runs out of elements, but there are still
more images available from the input source, default read
params are used for the remaining images.
If params
is null
, a default read
param will be used for all images.
The actual BufferedImage
referenced by the
returned IIOImage
will be chosen using the
algorithm defined by the getDestination
method.
Any registered IIOReadProgressListener
objects
will be notified by calling their sequenceStarted
method once. Then, for each image decoded, there will be a
call to imageStarted
, followed by calls to
imageProgress
as the read progresses, and finally
to imageComplete
. The
sequenceComplete
method will be called after the
last image has been decoded.
IIOReadUpdateListener
objects may be updated at
other times during the read as pixels are decoded. Finally,
IIOReadWarningListener
objects will receive
notification of any non-fatal warnings that occur during
decoding.
The set of source bands to be read and destination bands to
be written is determined by calling getSourceBands
and getDestinationBands
on the supplied
ImageReadParam
. If the lengths of the arrays
returned by these methods differ, the set of source bands
contains an index larger that the largest available source
index, or the set of destination bands contains an index larger
than the largest legal destination index, an
IllegalArgumentException
is thrown.
Thumbnails will be returned in their entirety regardless of the
region settings.
If any of the supplied ImageReadParam
s contain
optional setting values not supported by this reader (e.g.
source render size or any format-specific settings), they will
be ignored.
Returns:
an Iterator
representing the
contents of the input source as IIOImage
s.
Parameters:
- params - an Iterator
containing
ImageReadParam
objects.
Throws:
- IllegalStateException - if the input source has not been
set.
- IllegalArgumentException - if any
non-null
element of params
is not an
ImageReadParam
.
- IllegalArgumentException - if the set of source and
destination bands specified by
param.getSourceBands
and
param.getDestinationBands
differ in length or
include indices that are out of bounds.
- IllegalArgumentException - if a resulting image would
have a width or height less than 1.
- IOException - if an error occurs during reading.
See Also:
ImageReadParam
,
IIOImage
,