Many common image I/O operations may be performed using the static
methods of the
This package contains the basic classes and interfaces for describing
the contents of image files, including metadata and thumbnails
IIOImage); for controlling the image reading process
ImageTypeSpecifier) and image writing process
performing transcoding between formats (
and for reporting errors (
All implementations of javax.imageio provide the following standard image format plug-ins:
|JPEG||yes||yes||none||JPEG metadata format|
|PNG||yes||yes||none||PNG metadata format|
|BMP||yes||yes||none||BMP metadata format|
|WBMP||yes||yes||none||WBMP metadata format|
|GIF||yes||yes||GIF plug-in notes||GIF metadata format|
plug-ins for the
Graphics Interchange Format (GIF) image format.
These are the "standard" GIF plug-ins, meaning those that are included in the
JRE, as distinct from those included in standard extensions, or 3rd party
plug-ins. The following notes and metadata specification apply to the
By default the GIF writer plug-in creates version "89a" images. This can be changed to "87a" by explicitly setting the version in the stream metadata (see GIF Stream Metadata Format Specification).
The GIF writer plug-in supports the creation of animated GIF images through
the standard sequence writing methods defined in the
A global color table is written to the output stream if one of the following conditions is met:
In the first case the global color table in the stream metadata is used, in the second the local color table in the image metadata is used, and in the third a global color table is created from the ColorModel or SampleModel of the (first) image.
A local color table is written to the output stream only if image metadata containing a LocalColorTable element is supplied to the writer, or no image metadata is supplied to the writer and the local color table which would be generated from the image itself is not equal to the global color table.
A Graphic Control Extension block is written to the output stream only if image metadata containing a GraphicControlExtension element is supplied to the writer, or no image metadata is supplied and the local color table generated from the image requires a transparent index. Application, Plain Text, and Comment Extension blocks are written only if they are supplied to the writer via image metadata.
The writing of interlaced images can be controlled by the progressive
mode of the provided
If progressive mode is
MODE_DISABLED then a non-interlaced image will be written. If
progressive mode is
MODE_DEFAULT then an interlaced image will
be written. If progressive mode is
the metadata setting is used (if it is provided, otherwise an interlaced
image will be written).
The GIF image writer plug-in supports setting output stream metadata from metadata supplied to the writer in either the native GIF stream metadata format javax_imageio_gif_stream_1.0 or the standard metadata format javax_imageio_1.0, and setting output image metadata from metadata supplied to the writer in either the native GIF image metadata format javax_imageio_gif_image_1.0 or the standard metadata format javax_imageio_1.0. The mapping of standard metadata format to the GIF native stream and image metadata formats is given in the tables here .
|IIOParamController||An interface to be implemented by objects that can determine the
settings of an
|ImageTranscoder||An interface providing metadata transcoding capability.|
|IIOImage||A simple container class to aggregate an image, a set of thumbnail (preview) images, and an object representing metadata associated with the image.|
|IIOParam||A superclass of all classes describing how streams should be decoded or encoded.|
|ImageIO||A class containing static convenience methods for locating
|ImageReader||An abstract superclass for parsing and decoding of images.|
|ImageReadParam||A class describing how a stream is to be decoded.|
|ImageTypeSpecifier||A class that allows the format of an image (in particular, its
|ImageWriteParam||A class describing how a stream is to be encoded.|
|ImageWriter||An abstract superclass for encoding and writing images.|
|IIOException||An exception class used for signaling run-time failure of reading and writing operations.|