Класс ImageReadParam

Изображение, закодированное как часть файла или потока, можно представить как расширяющееся в нескольких измерениях: пространственные измерения ширины и высоты, количество полос и количество проходов прогрессивного декодирования. Этот класс позволяет выбрать непрерывную (гипер)прямоугольную подобласть изображения во всех этих измерениях для декодирования. Кроме того, пространственные измерения могут быть неравномерно субдискретизированы. Наконец, преобразования цвета и формата могут быть заданы путем управления 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 (например, размер рендеринга источника является необязательным, но субдискретизация должна поддерживаться).