Класс ImageReadParam

public class ImageReadParam
extends IIOParam

Класс, описывающий, как следует декодировать поток. Экземпляры этого класса или его подклассов используются для предоставления предписывающей «инструкции» экземплярам ImageReader.

Изображение, закодированное в файле или потоке, можно представить как расширяющееся в нескольких измерениях: пространственные измерения ширины и высоты, количество каналов и количество проходов по прогрессивному декодированию. Этот класс позволяет выбрать непрерывную (гипер)прямоугольную подобласть изображения во всех этих измерениях для декодирования. Кроме того, пространственные измерения могут быть неравномерно подвыборочны. Наконец, преобразования цвета и формата могут быть заданы путём управления ColorModel и SampleModel изображения назначения, либо путём предоставления BufferedImage или путём использования ImageTypeSpecifier.

Объект ImageReadParam используется для задания того, как изображение или набор изображений будут преобразованы при вводе из потока в контексте фреймворка Java Image I/O. Плагин для конкретного формата изображения вернёт экземпляры ImageReadParam из метода getDefaultReadParam его реализации ImageReader.

Состояние, поддерживаемое экземпляром ImageReadParam, не зависит от конкретного декодируемого изображения. При фактическом декодировании значения, установленные в параметре чтения, объединяются с фактическими свойствами изображения, декодируемого из потока, и назначением BufferedImage, которое получит декодированные пиксельные данные. Например, область источника, установленная с помощью setSourceRegion, сначала будет пересечена с фактической допустимой областью источника. Результат будет преобразован на основе значения, возвращённого getDestinationOffset, и полученный прямоугольник будет пересечён с фактической допустимой областью назначения, чтобы получить область назначения, которая будет записана.

Параметры, задаваемые объектом ImageReadParam, применяются к изображению следующим образом. Во-первых, если размер рендеринга был задан setSourceRenderSize, всё декодированное изображение рендерится с размером, заданным getSourceRenderSize. В противном случае изображение имеет свой естественный размер, заданный ImageReader.getWidth и ImageReader.getHeight.

Затем изображение обрезается по области источника, указанной getSourceXOffset, getSourceYOffset, getSourceWidth и getSourceHeight.

Полученная область затем подвыбирается в соответствии с коэффициентами, заданными в IIOParam.setSourceSubsampling. Первый пиксел, количество пикселей в строке и количество строк зависят от настроек подвыборки. Вызовите минимальные координаты X и Y полученного прямоугольника (minX, minY), его ширину w и высоту h.

Этот прямоугольник смещается на (getDestinationOffset().x, getDestinationOffset().y) и обрезается по границам назначения. Если изображение назначения не задано, назначение определяется как имеющее ширину getDestinationOffset().x + w и высоту getDestinationOffset().y + h, так что все пиксели области источника могут быть записаны в назначение.

Пиксели, которые попадают, после подвыборки, в изображение назначения и которые записываются в одном из проходов по прогрессивному декодированию, указанном getSourceMinProgressivePass и getSourceNumProgressivePasses, передаются на следующий этап.

Наконец, образцы источника каждого пикселя отображаются в каналы назначения в соответствии с алгоритмом, описанным в комментарии к setDestinationBands.

Плагины-писатели могут расширить функциональность ImageReadParam путём предоставления подкласса, который реализует дополнительные, специфичные для плагина интерфейсы. Плагин должен документировать доступные интерфейсы и способ их использования. Читатели проигнорируют любые расширенные возможности подкласса ImageReadParam, о которых они не знают. Кроме того, они могут проигнорировать любые необязательные функции, которые обычно отключаются при создании собственных экземпляров ImageReadParam через getDefaultReadParam.

Обратите внимание, что если для возможности нет метода запроса, она должна поддерживаться всеми реализациями ImageReader (например, размер рендеринга источника является необязательным, но подвыборка должна поддерживаться).