AddModernImageFromFile

图像处理、现代图像编解码器

说明

通过已配置的进程内解码器,从 AVIF、HEIF、HEIC 或 JPEG XL 文件添加主图像

解码器应用编码方向,并通过 PNG 桥接传送解码后的采样,使 Alpha、ICC 色彩配置文件及每分量最多 16 位均可进入 PDF 图像路径

语法

Function TPDFlib.AddModernImageFromFile(
  Const FileName: WideString;
  Options: Integer= 8): Integer;

参数

FileNameAVIF、HEIF、HEIC 或 JPEG XL 文件的路径
Options兼容 PNG 的导入模式,其中默认值 8 会保留图像数据、alpha、ICC 和高位深度样本

返回值

返回新的 ImageID;文件、格式、解码器或解码图像无效时返回 0

备注

同时接受有损和无损源编码,动画或多图像容器会导入其主图像

当编解码器库不在默认搜索路径中时,请在首次可用性检查或解码之前调用 SetModernImageCodecLibrary

保留的 16 位图像会通过常规兼容性门自动将未锁定文档提升至 PDF 1.5

另请参阅

AddModernImageFromStream、AddModernImageFromString、ModernImageCodecAvailable