Пакет javax.imageio

Основной пакет API ввода-вывода Изображения Java.

См.: Описание

Интерфейсная Сводка

Интерфейс	Описание
IIOParamController	Интерфейс, который будет реализован объектами, которые могут определить настройки IIOParam объект, или поднимая GUI, чтобы получить значения от пользователя, или другими средствами.
ImageTranscoder	Интерфейс, обеспечивающий возможность транскодирования метаданных.

Сводка класса

Класс	Описание
IIOImage	Простой контейнерный класс, чтобы агрегировать изображение, ряд миниатюры (предварительный просмотр) изображения, и метаданные представления объекта, связанные с изображением.
IIOParam	Суперкласс всех классов, описывающих, как потоки должны декодироваться или закодированы.
ImageIO	Класс, содержащий статические методы удобства для того, чтобы расположиться ImageReaders и ImageWriters, и выполнение простого кодирования и декодирование.
ImageReader	Абстрактный суперкласс для парсинга и декодирования изображений.
ImageReadParam	Класс, описывающий, как должен декодироваться поток.
ImageTypeSpecifier	Класс, который позволяет формат изображения (в частности SampleModel и ColorModel) быть определенным удобным способом.
ImageWriteParam	Класс, описывающий, как должен быть закодирован поток.
ImageWriter	Абстрактный суперкласс для кодирования и записи изображений.

Сводка исключения

Исключение	Описание
IIOException	Класс исключений используется для того, чтобы сигнализировать отказ времени выполнения чтения и записи операций.

Пакет javax.imageio Описание

Основной пакет API ввода-вывода Изображения Java.

Много общих операций ввода-вывода изображения могут быть выполнены, используя статические методы ImageIO класс.

Этот пакет содержит основные классы и интерфейсы для того, чтобы описать содержание файлов образа, включая метаданные и миниатюры (IIOImage); для того, чтобы управлять процессом считывания изображения (ImageReader, ImageReadParam, и ImageTypeSpecifier) и запись изображения (ImageWriter и ImageWriteParam); для того, чтобы выполнить транскодирование между форматами (ImageTranscoder), и для того, чтобы сообщить об ошибках (IIOException).

Все реализации javax.imageio обеспечивают следующие стандартные плагины формата изображения:

	Чтение	Запись	Примечания	Метаданные
JPEG	да	да	ни один	Формат метаданных JPEG
PNG	да	да	ни один	Формат метаданных PNG
BMP	да	да	ни один	Формат метаданных BMP
WBMP	да	да	ни один	Формат метаданных WBMP
ДЖИФ	да	да	Примечания плагина ДЖИФА	Формат метаданных ДЖИФА

Стандартные Сменные Примечания

Стандартный плагин для формата изображения ДЖИФА

ImageIO обеспечивает ImageReader и ImageWriter плагины для Формата обмена графическими данными (ДЖИФ) формат изображения. Они - "стандарт" плагины ДЖИФА, означая тех, которые включаются в JRE, в отличие от включенных в стандартные расширения, или 3-ьи плагины стороны. Следующие примечания и спецификация метаданных применяются к стандартным плагинам.

Запись изображений ДЖИФА

Плагин писателя изображения ДЖИФА гарантирует запись без потерь для изображений, которые удовлетворяют следующие требования:

• число полос 1;
• число битов на выборку не больше чем 8;
• размер компонента цвета не больше чем 8;

По умолчанию плагин писателя ДЖИФА создает изображения версии "89a". Это может быть изменено на "87a", явно устанавливая версию в потоковых метаданных (см. Спецификацию Формата Метаданных ДЖИФА Стрима).

Плагин писателя ДЖИФА поддерживает создание анимированных изображений ДЖИФА через стандартные методы записи последовательности, определенные в ImageWriter класс.

Глобальная таблица цветов пишется потоку вывода, если одно из следующих условий встречается:

• потоковые метаданные, содержащие элемент GlobalColorTable, предоставляются;
• последовательность пишется, и метаданные изображения, содержащие элемент LocalColorTable, предоставляются для первого изображения в последовательности;
• метаданные изображения не предоставляются или не содержат элемент LocalColorTable.

В первом случае глобальная таблица цветов в потоковых метаданных используется во втором, локальная таблица цветов в метаданных изображения используется, и в третьем глобальная таблица цветов создается из ColorModel или SampleModel (первого) изображения.

Локальная таблица цветов пишется потоку вывода, только если метаданные изображения, содержащие элемент LocalColorTable, предоставляются писателю, или никакие метаданные изображения не предоставляются писателю и локальной таблице цветов, которая была бы сгенерирована от самого изображения, не равно глобальной таблице цветов.

Графический блок Расширения Управления пишется потоку вывода, только если метаданные изображения, содержащие элемент GraphicControlExtension, предоставляются писателю, или никакие метаданные изображения не предоставляются, и локальная таблица цветов, сгенерированная от изображения, требует прозрачного индекса. Приложение, Простой текст, и блоки Расширения Комментария пишутся, только если они предоставляются писателю через метаданные изображения.

Записью чересстрочных изображений может управлять прогрессивный режим обеспеченного ImageWriteParam экземпляр. Если прогрессивный режим MODE_DISABLED тогда нечередуемое изображение будет записано. Если прогрессивный режим MODE_DEFAULT тогда чересстрочное изображение будет записано. Если прогрессивный режим MODE_COPY_FROM_METADATA, тогда установка метаданных используется (если она будет обеспечена, иначе то чересстрочное изображение будет записано).

Плагин писателя изображения ДЖИФА поддерживает метаданные потока вывода установки от метаданных, предоставленных писателю или в собственном потоковом формате javax_imageio_gif_stream_1.0 метаданных ДЖИФА или в стандартном формате javax_imageio_1.0 метаданных, и установке выходных метаданных изображения от метаданных, предоставленных писателю или в собственном формате javax_imageio_gif_image_1.0 метаданных изображения ДЖИФА или стандартном формате javax_imageio_1.0 метаданных. Отображение стандартного формата метаданных ДЖИФУ собственный поток и форматы метаданных изображения дается в таблицах здесь.

С тех пор:

1.4