SetModernImageCodecLibrary
画像処理、構成、ネイティブコーデック
説明
最新画像デコードで使用するネイティブ MagickWand ライブラリのファイルまたはディレクトリを設定します
構文
Function TPDFlib.SetModernImageCodecLibrary(
Const FileNameOrDirectory: WideString): Integer;
パラメータ
| FileNameOrDirectory | ネイティブライブラリの完全パス、またはライブラリと依存関係を含むディレクトリ |
|---|
戻り値
| 1 | コーデックモジュールが読み込まれる前にパスを受け付けました |
|---|---|
| 0 | コーデックモジュールはすでに読み込まれており、そのパスはプロセスの存続期間中変更できません |
備考
いずれの操作でもモジュールが読み込まれる可能性があるため、ModernImageCodecAvailable の呼び出しまたはモダン画像のインポート前にパスを構成する
引数が modules\coders を含む移植可能なライブラリディレクトリの場合、ローダーはそのプロセスで未設定の MAGICK_HOME、MAGICK_CONFIGURE_PATH、MAGICK_CODER_MODULE_PATH の値を設定します
明示的なパスが設定されていない場合、ローダーは PDFLIB_MODERN_IMAGE_CODEC、実行可能ファイルのディレクトリ、プラットフォームのライブラリ名を確認します
アプリケーションは、RegisterModernImageDecoderBackend を PDFlibModernImage から呼び出すこともできます。デコーダコールバックは完全に方向補正された PNG ストリームを返します
PDFlibModernImage ユニットの関数
PDFlibModernImage ユニットは、上記メソッドの背後にあるコーデック処理を、デコーダーを直接扱うアプリケーション向けのスタンドアロン関数として公開します
DetermineModernImageFormat | ストリームのヘッダーを判別し、mifAVIF、mifHEIF、mifJPEGXL、mifUnknown のいずれかを報告します |
|---|---|
ModernImageFormatName | 人間が読める形式名 (AVIF、HEIF、JPEG XL、Unknown) を返します |
SetModernImageCodecLibraryPath | このメソッドのユニットレベル版です。プロセスでコーデックモジュールがすでに読み込まれた後は False を返します |
RegisterModernImageDecoderBackend | 入力ストリーム、形式、ApplyOrientation フラグを受け取り、完全に方向補正された PNG ストリームを書き出す TPDFlibModernImageDecodeCallback を組み込みます。ネイティブのコーデックモジュールより優先されます |
ClearModernImageDecoderBackend | 登録済みのコールバックを削除します (nil の登録と同等) |
ModernImageCodecAvailable | コーデックモジュールの一回限りの読み込みを試み、ネイティブデコードが利用可能かを報告します。同名の TPDFlib メソッドはこのチェックを包みます |
DecodeModernImageToPNG | 登録済みコールバック経由で、なければネイティブのコーデックモジュール経由で画像を 1 枚デコードします。ApplyOrientation の既定値は True です |