DecodeModernImageToPNG

影像處理

描述

把現代影像串流解碼成 PNG 影像串流

已註冊的後端回呼會先執行；沒有後端時由原生 codec 程式庫繪製影像，依需求套用 EXIF 方向，並保留內嵌的 ICC 描述檔

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

InStream	持有完整現代影像的串流；串流位置會被保存並還原
OutPNG	接收 PNG 位元組的串流；使用後端回呼時，成功後會重設到位置 0 並把大小調成輸出的尺寸
ImageFormat	要解碼的格式，來自 DetermineModernImageFormat；`mifUnknown` 會立即失敗
ApplyOrientation	套用儲存的方向讓 PNG 擺正，預設開啟

False	未註冊後端且 codec 模組缺席或缺少對應 coder、格式不明，或解碼失敗
True	OutPNG 持有完整的 PNG 影像

AddModernImageFromStream 家族把這個輔助函式包起來並將 PNG 嵌入頁面；想在没有 TPDFlib 實例的情況下預先轉換或檢查影像，就直接呼叫它