C# での 2 値圧縮の予期しない結果

Curtis Chau
Curtis Chau
更新日: 2026年10月12日

IronPDF 2026.10.1+ はオプトインの2値圧縮を導入し、適格な画像を AdvancedCompressionOptions 上で CompressAndSaveAs によって1ビットのCCITT Group 4に変換します。詳細は PDF圧縮ガイド に記載されています。 BitonalMode = Forceの設定により、カラー画像が白黒に変わる、元の画像よりも柔らかく見えるスキャンに変わる、または何も変わらない、という3つの症状が発生する可能性があります。

なぜ私のカラー画像が白黒になっているのですか?

BitonalMode = Forceは、適格なすべての画像を純粋な白黒にし、内容に関係なく、カラーや連続調の詳細は破棄され、復元できません。

修正: カラーや写真画像を含むPDFではBitonalModeをOffに設定し、スキャンしたテキスト、ファックス、線画にのみForceを使用してください。

なぜ私のスキャンが元のものよりも柔らかく見えるのですか?

BitonalMode = Forceのみ設定されている場合、BitonalResolutionDpiはnullのままになり、TargetImageDpiにフォールバックします。これは標準では150 DPIで、300 DPIのスキャンはしきい値処理の前に150 DPIにダウンサンプリングされます。

修正: スキャンのDPIにBitonalResolutionDpiを設定するか、ソース解像度でしきい値処理するためにTargetImageDpi = nullを設定してください。 BitonalResolutionDpiを0に設定すると、ソース解像度を保持しません。それはnullのように動作します。

var options = new AdvancedCompressionOptions();
options.BitonalMode = BitonalCompressionMode.Force;
options.BitonalResolutionDpi = 300; // Threshold at 300 DPI
pdf.CompressAndSaveAs("output.pdf", options);
C#

なぜビトナル圧縮が何も変更しなかったのですか?

以下のケースでは、エラーなしに画像をスキップします:

  • CCITT結果が小さくならなかった: 画像は現在のエンコーディングを維持します。 決定は画像ごとに行われるため、ドキュメントが部分的に変換されて出力されることがあります。
  • 画像にマスクがある: 柔らかい、ステンシル、またはカラーキーのマスクを持つ画像は、現在のエンコーディングを保持し、マスクはドロップされず、平坦化もされません。
  • 画像がすでに1ビットである: 既存のCCITTおよびJBIG2スキャンは変更されません。
  • PDFがメモリ内で圧縮されている: CompressPdfToBytesおよびCompressPdfToStreamはAdvancedCompressionOptionsを受け入れないため、CompressAndSaveAsのみがCCITT Group 4の出力を生成できます。

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

もっと読む

準備はできましたか?

NuGetダウンロード数 22,198,312バージョン:2026.11ちょうどリリースされました