Resultados inesperados da compressão bitonal em C#
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);
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:
CompressPdfToByteseCompressPdfToStreamnão aceitamAdvancedCompressionOptions, então apenasCompressAndSaveAspode 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.