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 です

関連項目

ModernImageCodecAvailable、AddModernImageFromFile