SetModernImageCodecLibrary
影像處理、設定、原生 codec
描述
設定 modern image 解碼所使用的原生 MagickWand 程式庫檔案或目錄
語法
Function TPDFlib.SetModernImageCodecLibrary(
Const FileNameOrDirectory: WideString): Integer;參數
| FileNameOrDirectory | 原生程式庫的完整路徑，或包含該程式庫與其相依項的目錄 |
|---|
傳回值
| 1 | 路徑在 codec 模組載入前被接受 |
|---|---|
| 0 | 已載入 codec 模組，其路徑在處理程序生命週期內不可變更 |
備註
請在呼叫 ModernImageCodecAvailable 或匯入 modern image 之前先設定路徑，因為兩者都可能載入模組 若引數是包含
modules\coders 的可攜式程式庫目錄，載入器會為該處理程序補上未設定的 MAGICK_HOME、MAGICK_CONFIGURE_PATH 與 MAGICK_CODER_MODULE_PATH 值
未明確設定路徑時，載入器會依序檢查
PDFLIB_MODERN_IMAGE_CODEC
RegisterModernImageDecoderBackend、執行檔所在目錄與各平台程式庫名稱
應用程式也可以改從 PDFlibModernImage 呼叫
PDFlibModernImage 單元函式
PDFlibModernImage 單元把上述方法背後的 codec 管線以獨立函式公開，供直接驅動解碼器的應用程式使用：
DetermineModernImageFormat | 窺探串流標頭並回報 mifAVIF、mifHEIF、mifJPEGXL 或 mifUnknown |
|---|---|
ModernImageFormatName | 傳回人類可讀的格式名稱（AVIF、HEIF、JPEG XL 或 Unknown） |
SetModernImageCodecLibraryPath | 本方法的單元層級版本；處理程序已載入 codec 模組後回傳 False |
RegisterModernImageDecoderBackend | 安裝 TPDFlibModernImageDecodeCallback，接收輸入串流、格式與 ApplyOrientation 旗標，並須寫出完整定向的 PNG 串流；其優先於原生 codec 模組 |
ClearModernImageDecoderBackend | 移除已註冊的回呼（等同註冊 nil） |
ModernImageCodecAvailable | 嘗試一次性載入 codec 模組並回報原生解碼是否可用；同名之 TPDFlib 方法封裝了這項檢查 |
DecodeModernImageToPNG | 透過已註冊的回呼解碼單張影像，沒有回呼時改走原生 codec 模組；ApplyOrientation 預設 True |