ExternalizeInlineImages

ドキュメント最適化、画像処理、パフォーマンス

説明

選択したページコンテンツ内でバイト単位で同一の対応インライン画像を検出し、繰り返される BI から EI までの定義を 1 つの共有 Image XObject への参照に置き換えます

構文

Delphi

Function TPDFlib.ExternalizeInlineImages(Const PageRange: WideString= ''; MinimumOccurrences: Integer= 2): Integer;

パラメータ

PageRange1,3,5-7 などの 1 から始まるページ範囲です。すべてのページを対象にする場合は空文字列です。重複するページ番号は無視されます
MinimumOccurrences昇格に必要な正確な出現回数の最小値であり、2 以上でなければなりません

戻り値

置き換えられたインライン画像の出現数。対象グループがないか範囲が無効な場合は 0。最小値が 2 未満、または適用前に処理がキャンセルされた場合も同様です

備考

グループ化には寸法、ビット深度、画像マスクと補間フラグ、色空間、フィルターチェーン、デコードパラメーター、デコード配列、エンコード済みペイロードが含まれ、SHA-256 による索引付けの後で完全一致比較が行われます

直接の DeviceGray、DeviceRGB、DeviceCMYK 画像およびステンシルマスクがサポートされます。名前付きまたは複雑なカラースペースと不明なインライン辞書エントリは変更されません

既存のフィルターとデコードパラメーターは保持されます。フィルターなしのペイロードは、圧縮表現のほうが小さい場合にのみ Flate 圧縮されます

Image XObject、ページリソース、および置換命令を含む保守的な推定値が元のインライン範囲より小さい場合にだけ、グループが昇格されます

この操作は収集と適用の進捗を報告し、ページ境界で Abort に応答し、以前に選択されていたページを復元します。また、べき等です

収集中のキャンセルでは変更されず、適用中のキャンセルでは既に完了したページを保持します

例

ReplacedImages:= PDF.ExternalizeInlineImages('1-200', 3);
Writeln(ReplacedImages);

関連項目

OptimizeImages、RecompressStreams、NormalizeContentStreams