DecodeModernImageToPNG

Обработка изображений

Описание

Декодирует поток современного изображения в поток изображения PNG

Сначала выполняется зарегистрированный callback бэкенда; без него нативная библиотека кодеков растрирует изображение, по запросу применит ориентацию EXIF и сохранит встроенный профиль ICC

Синтаксис

Delphi

Function DecodeModernImageToPNG(InStream, OutPNG: TStream;
  ImageFormat: TPDFlibModernImageFormat;
  ApplyOrientation: Boolean= True): Boolean;

Параметры

InStream	Поток с полным современным изображением; позиция сохраняется и восстанавливается
OutPNG	Поток, принимающий байты PNG; с callback бэкенда при успехе сбрасывается в позицию 0 и подгоняется под размер вывода
ImageFormat	Декодируемый формат, результат DetermineModernImageFormat; `mifUnknown` сразу завершается ошибкой
ApplyOrientation	Применяет сохранённую ориентацию, чтобы PNG стоял прямо; включено по умолчанию

Возвращаемые значения

False	Бэкенд не зарегистрирован, а модуль кодеков отсутствует или не имеет нужного кодера, формат неизвестен либо декодирование не удалось
True	OutPNG содержит полное изображение PNG

Примечания

Семейство AddModernImageFromStream оборачивает этот помощник и встраивает PNG в страницу; прямой вызов — способ предварительно конвертировать или просмотреть изображения без экземпляра TPDFlib

См. также

DetermineModernImageFormat, RegisterModernImageDecoderBackend, AddModernImageFromStream, ModernImageCodecAvailable