This HTML page is not optimized for LLM or AI agent consumption. Fetch the Markdown version instead: /api/csharp/settings/format/pdf-settings.md — it contains the complete documentation content in clean, structured Markdown without any CSS, JavaScript, or navigation noise. PdfSettings

Settings for Pdf. Values fall back through three levels: document → SDK → built-in default. Writes target the document only when set on a document’s settings, otherwise the SDK globally when set on SdkSettings.

using Nutrient;

The SDK creates this class through factory methods or other SDK objects.

Properties

BitonalImageCompression

public PdfCompression BitonalImageCompression { get; set; }

The compression method to use for bitonal (black and white) images in PDF documents.

Type: PdfCompression

ColorImageCompression

public PdfCompression ColorImageCompression { get; set; }

The compression method to use for color images in PDF documents.

Type: PdfCompression

Conformance

public PdfConformance Conformance { get; set; }

The PDF conformance level for the output document.

Type: PdfConformance

EnableColorDetection

public bool EnableColorDetection { get; set; }

Indicates whether automatic color detection is enabled to determine if an image is bitonal or color.

Type: bool

EnableLinearization

public bool EnableLinearization { get; set; }

Indicates whether PDF linearization (fast web view) is enabled. Linearized PDFs can be displayed page-by-page while still downloading.

Type: bool

ForceImageDpi

public int ForceImageDpi { get; set; }

Forces all images in the PDF to a specific DPI (dots per inch) resolution. A value of 0 means no DPI forcing is applied.

Type: int

Mode

public PdfSettingsMode Mode { get; set; }

The mode options for PDF processing.

Type: PdfSettingsMode

Optimize

public bool Optimize { get; set; }

Indicates whether PDF optimization is enabled to reduce file size.

Type: bool

SavePreferences

public PdfSavePreferences SavePreferences { get; set; }

Preferences for saving PDF documents.

Type: PdfSavePreferences

UseDeflateOnJpeg

public bool UseDeflateOnJpeg { get; set; }

Indicates whether Deflate compression should be applied to JPEG images.

Type: bool

ZlibLevel

public int ZlibLevel { get; set; }

The compression level for Zlib/Deflate compression. Higher values provide better compression but take longer to process.

Type: int

Resource management

public void Dispose()

PdfSettings implements IDisposable. Call Dispose() or use a C# using declaration to release its native handle right away. If you don’t, the handle is released when the object is garbage collected.