Resultados inesperados de la compresión bitonal en C#
IronPDF 2026.10.1+ introduce compresión bitonal opcional, que convierte imágenes elegibles a 1-bit CCITT Grupo 4 mediante AdvancedCompressionOptions en CompressAndSaveAs, cubierto en la guía de compresión PDF. Configurar BitonalMode = Force puede producir tres síntomas: imágenes en color convertidas a blanco y negro, escaneos que se ven más suaves que el original, o sin cambios.
¿Por qué mis imágenes en color están en blanco y negro?
BitonalMode = Force umbraliza cada imagen elegible a puro blanco y negro, sin importar lo que contenga: los detalles en color y tonos continuos se descartan y no se pueden restaurar.
Solución: deje BitonalMode en Off para PDFs con imágenes en color o fotográficas, y use Force solo para texto escaneado, faxes y dibujos lineales.
¿Por qué mi escaneo se ve más suave que el original?
Con solo BitonalMode = Force configurado, BitonalResolutionDpi permanece en null y se retrocede a TargetImageDpi, que por defecto es 150: un escaneo de 300 DPI se reduce a 150 DPI antes del umbral.
Solución: configure BitonalResolutionDpi al DPI del escaneo, o configure TargetImageDpi = null para umbralizar en la resolución de origen. Configurar BitonalResolutionDpi a 0 no mantiene la resolución de origen: se comporta como null.
var options = new AdvancedCompressionOptions();
options.BitonalMode = BitonalCompressionMode.Force;
options.BitonalResolutionDpi = 300; // Threshold at 300 DPI
pdf.CompressAndSaveAs("output.pdf", options);
¿Por qué la compresión bitonal no cambió nada?
La compresión bitonal omite una imagen sin error en estos casos:
- El resultado de CCITT no era más pequeño: la imagen mantiene su codificación actual. La decisión se toma por imagen, por lo que un documento puede salir parcialmente convertido.
- La imagen tiene una máscara: una imagen con máscara suave, plantilla o clave de color mantiene su codificación actual, y la máscara ni se elimina ni se aplana.
- La imagen ya es de 1-bit: los escaneos existentes de CCITT y JBIG2 no se tocan.
- El PDF se comprimió en memoria:
CompressPdfToBytesyCompressPdfToStreamno aceptanAdvancedCompressionOptions, por lo que soloCompressAndSaveAspuede producir salida de CCITT Grupo 4.
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.