C# 中二值壓縮的意外結果

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

IronPDF 2026.10.1+ 介紹了選擇性開啟的二值壓縮,透過AdvancedCompressionOptions在CompressAndSaveAs中將合格圖像轉換為1位元CCITT第4組,詳情見PDF壓縮指南。 設置BitonalMode = Force可能導致三種結果:彩色圖像變為黑白,掃描結果比原始圖像更柔和,或沒有任何變化。

為什麼我的彩色圖片變成黑白了?

BitonalMode = Force對每個合格的圖像進行純黑白的閾值處理,無論內容為何:彩色以及連續色調的細節被丟棄且無法恢復。

修復: 對於包含彩色或攝影圖像的PDF,將BitonalMode保持在Off,僅對掃描文本、傳真和線條藝術使用Force。

為什麼我的掃描看起來比原始的還要柔和?

僅設置BitonalMode = Force時,BitonalResolutionDpi保持為null並退回到TargetImageDpi,默認為150:300 DPI 掃描在閾值之前被降採樣到150 DPI。

修復: 將BitonalResolutionDpi設置為掃描的DPI,或將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第4組輸出

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

閱讀更多

準備好開始了嗎?

NuGet 下載次數 22,198,312版本:2026.11剛剛發布