AddModernImageFromFile

影像處理、現代影像 codec

描述

透過設定的行程內解碼器，加入 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

有損與無損的來源編碼都接受，動畫或多影像容器則匯入其主要影像

當 codec 程式庫不在預設搜尋路徑上時，請在首次可用性檢查或解碼之前呼叫 SetModernImageCodecLibrary

保留 16 位元影像時，未鎖定文件會透過一般相容性閘自動提升至 PDF 1.5