AddModernImageFromFile
图像处理、现代图像编解码器
说明
通过已配置的进程内解码器,从 AVIF、HEIF、HEIC 或 JPEG XL 文件添加主图像
解码器应用编码方向,并通过 PNG 桥接传送解码后的采样,使 Alpha、ICC 色彩配置文件及每分量最多 16 位均可进入 PDF 图像路径
语法
Function TPDFlib.AddModernImageFromFile(
Const FileName: WideString;
Options: Integer= 8): Integer;
参数
| FileName | AVIF、HEIF、HEIC 或 JPEG XL 文件的路径 |
|---|---|
| Options | 兼容 PNG 的导入模式,其中默认值 8 会保留图像数据、alpha、ICC 和高位深度样本 |
返回值
返回新的 ImageID;文件、格式、解码器或解码图像无效时返回 0
备注
同时接受有损和无损源编码,动画或多图像容器会导入其主图像
当编解码器库不在默认搜索路径中时,请在首次可用性检查或解码之前调用 SetModernImageCodecLibrary
保留的 16 位图像会通过常规兼容性门自动将未锁定文档提升至 PDF 1.5
另请参阅
AddModernImageFromStream、AddModernImageFromString、ModernImageCodecAvailable