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 实例时预转换或检查图像的途径