Class BitonalCompressionMode

How the advanced compression pipeline handles bitonal (1-bit black/white) image encoding for scanned documents.

Inheritance

System.Object

BitonalCompressionMode

Namespace: IronPdf

Assembly: IronPdf.dll

Syntax

public sealed class BitonalCompressionMode : Enum

BitonalCompressionMode controls how IronPDF's advanced compression pipeline encodes 1-bit black-and-white images in scanned PDF documents. Force applies bitonal compression to every eligible image, producing the smallest possible file size for scanned content. Off disables bitonal encoding entirely, preserving the original image data without recompression. See PDF compression options for practical guidance.

compressOptions.BitonalCompression = BitonalCompressionMode.Force;

Fields

Force

Force every eligible 8-bit image to be thresholded to 1-bit and CCITT Group 4 encoded. The result is kept only when it is smaller than the JPEG encoding, so it never enlarges an image, but thresholding is lossy: use it only when you know the document is black-and-white scans or line art, not colour or photographic content.

Declaration

public const BitonalCompressionMode Force

Field Value

Type	Description
BitonalCompressionMode

Off

Disabled (default). Images are compressed with the normal JPEG pipeline.

Declaration

public const BitonalCompressionMode Off

Field Value

Type	Description
BitonalCompressionMode

value__

Declaration

public int value__

Field Value

Type	Description
System.Int32