Nieoczekiwane wyniki kompresji bitonalnej w C#

Curtis Chau
Curtis Chau
Zaktualizowano: 12 października 2026

IronPDF 2026.10.1+ wprowadza opcjonalną kompresję bitonalną, która konwertuje kwalifikujące się obrazy do 1-bitowego CCITT Group 4 przez AdvancedCompressionOptions na CompressAndSaveAs, omówioną w przewodniku kompresji PDF. Ustawienie BitonalMode = Force może spowodować trzy objawy: kolorowe obrazy zmienione na czarno-białe, skany wyglądające na bardziej miękkie niż oryginał, lub brak jakiejkolwiek zmiany.

Dlaczego moje kolorowe obrazy są czarno-białe?

BitonalMode = Force progówkuje każdy kwalifikujący się obraz do czystego czarno-białego, niezależnie od jego zawartości: szczegóły kolorów i półtonów są odrzucane i nie mogą być przywrócone.

Naprawa: pozostaw BitonalMode na Off dla plików PDF z obrazami kolorowymi lub fotograficznymi, a Force używaj tylko dla skanowanego tekstu, faksów i grafiki liniowej.

Dlaczego mój skan wygląda na bardziej miękki niż oryginał?

Ustawiając tylko BitonalMode = Force, BitonalResolutionDpi pozostaje null i stosuje się do TargetImageDpi, które domyślnie wynosi 150: skan 300 DPI jest próbkowany do 150 DPI przed progowaniem.

Naprawa: ustaw BitonalResolutionDpi na rozdzielczość DPI skanu, lub ustaw TargetImageDpi = null na progowanie w rozdzielczości źródłowej. Ustawienie BitonalResolutionDpi na 0 nie zachowuje rozdzielczości źródłowej: zachowuje się jak null.

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

Dlaczego kompresja bitonalna nic nie zmieniła?

Kompresja bitonalna pomija obraz bez błędu w następujących przypadkach:

  • Wynik CCITT nie był mniejszy: obraz zachowuje swoje aktualne kodowanie. Decyzja jest podejmowana per obraz, więc dokument może być częściowo skonwertowany
  • Obraz ma maskę: obraz z miękką, szablonową lub kolor-kluczową maską zachowuje swoje aktualne kodowanie, a maska nie jest usuwana ani wyrównywana
  • Obraz jest już 1-bitowy: istniejące skany CCITT i JBIG2 pozostają nietknięte
  • PDF był kompresowany w pamięci: CompressPdfToBytes i CompressPdfToStream nie akceptują AdvancedCompressionOptions, więc tylko CompressAndSaveAs może generować wynik w formacie CCITT Group 4

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

Czytaj więcej

Gotowy, aby rozpocząć?

Pobrania z NuGet 22,198,312Wersja:2026.11właśnie wydane