Nieoczekiwane wyniki kompresji bitonalnej w C#
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);
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:
CompressPdfToBytesiCompressPdfToStreamnie akceptująAdvancedCompressionOptions, więc tylkoCompressAndSaveAsmoż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.