Resultados inesperados da compressão bitonal em C#

Curtis Chau
Curtis Chau
Atualizado: 12 de outubro de 2026

IronPDF 2026.10.1+ introduz compressão bitonal opcional, que converte imagens elegíveis para 1-bit CCITT Grupo 4 através de AdvancedCompressionOptions em CompressAndSaveAs, coberto no guia de compressão de PDF. Definir BitonalMode = Force pode produzir três sintomas: imagens coloridas transformadas em preto e branco, digitalizações que parecem mais suaves do que o original, ou nenhuma mudança.

Por que Minhas Imagens Coloridas Estão em Preto e Branco?

BitonalMode = Force define o limite de todas as imagens elegíveis para preto e branco puro, qualquer que seja o conteúdo: detalhes de cor e de tom contínuo são descartados e não podem ser restaurados.

Correção: deixe BitonalMode em Off para PDFs com imagens coloridas ou fotográficas, e use Force apenas para textos digitalizados, faxes e arte de linha.

Por que Minha Digitalização Parece Mais Suave que o Original?

Com apenas BitonalMode = Force definido, BitonalResolutionDpi permanece null e volta para TargetImageDpi, que tem padrão de 150: uma digitalização de 300 DPI é redimensionada para 150 DPI antes de definir o limite.

Correção: defina BitonalResolutionDpi para o DPI da digitalização, ou defina TargetImageDpi = null para definir o limite na resolução de origem. Definir BitonalResolutionDpi para 0 não mantém a resolução de origem: comporta-se como null.

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

Por que a Compressão Bitonal Não Alterou Nada?

A compressão bitonal pula uma imagem sem erro nestes casos:

  • O resultado CCITT não foi menor: a imagem mantém sua codificação atual. A decisão é tomada por imagem, então um documento pode sair parcialmente convertido
  • A imagem tem uma máscara: uma imagem com uma máscara suave, de estêncil ou chave de cor mantém sua codificação atual, e a máscara não é descartada nem achatada
  • A imagem já é 1-bit: scans existentes em CCITT e JBIG2 são deixados intactos
  • O PDF foi comprimido na memória: CompressPdfToBytes e CompressPdfToStream não aceitam AdvancedCompressionOptions, então apenas CompressAndSaveAs pode produzir saída CCITT Grupo 4

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

Leia Mais

Pronto para começar?

Downloads no NuGet 22,198,312Versão:2026.11recém-lançado