Resultados inesperados de la compresión bitonal en C#

Curtis Chau
Curtis Chau
Actualizado: 12 de octubre de 2026

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);
C#

¿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: CompressPdfToBytes y CompressPdfToStream no aceptan AdvancedCompressionOptions, por lo que solo CompressAndSaveAs puede 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.

Leer más

¿Listo para empezar?

Descargas de NuGet 22,198,312Versión:2026.11recién lanzado