Интерфейс ImageTranscoder

Любой образ может быть транскодирован (записан в формате, отличном от исходного) просто путем выполнения операции чтения, за которой следует операция записи. Однако в этом процессе возможна потеря данных из-за различий в форматах.

В общем случае лучшие результаты будут достигнуты, когда для каждого формата можно создать объекты метаданных, которые будут содержать как можно больше информации об изображении и связанных с ним метаданных, понятных конкретному ImageWriter, используемому для кодирования.

Можно использовать ImageTranscoder для преобразования IIOMetadata объектов, предоставляемых ImageReader (представляющих метаданные для каждого потока и каждого изображения), в соответствующие объекты, подходящие для кодирования конкретным ImageWriter. В случае, когда методы этого интерфейса вызываются непосредственно на ImageWriter, результат будет пригоден для этого записывателя.

Внутренние детали преобразования объекта IIOMetadata в формат, специфичный для записывателя, будут варьироваться в зависимости от контекста операции. Как правило, ImageWriter будет проверять входящий объект, чтобы определить, реализует ли он дополнительные интерфейсы, с которыми записыватель знаком. Это может быть, например, если объект был получен путем операции чтения из плагина-читателя, написанного тем же поставщиком, что и записыватель. В этом случае записыватель может получить доступ к входящему объекту с помощью специфичных для плагина интерфейсов. В этом случае повторное кодирование может быть близким к безпотери, если формат файла изображения остается неизменным. Если формат меняется, записыватель всё равно может попытаться сохранить как можно больше информации.

Если входящий объект не реализует какие-либо дополнительные интерфейсы, известные записывателю, записыватель не имеет выбора, кроме как получить доступ к нему через стандартные IIOMetadata интерфейсы, такие как представление дерева, предоставляемое IIOMetadata.getAsTree. В этом случае, вероятно, произойдёт значительная потеря информации.

Независимый ImageTranscoder по сути выполняет ту же роль, что и плагин-записыватель в вышеприведённых примерах. Он должен быть знаком с частными интерфейсами, используемыми как плагином-читателем, так и плагином-записывателем, и вручную создать объект, который будет пригоден для использования записывателем. Полученные объекты метаданных могут быть использованы записывателем напрямую.

Независимые реализации ImageTranscoder не предоставляются в рамках стандартного API. Вместо этого, целью этого интерфейса является предоставление способа создания и обнаружения реализаций приложениями по мере необходимости.