---
title: "PdfSettings"
canonical_url: "https://www.nutrient.io/api/csharp/settings/format/pdf-settings/"
md_url: "https://www.nutrient.io/api/csharp/settings/format/pdf-settings.md"
last_updated: "2026-10-08T08:55:57.713Z"
description: "Settings for Pdf. Values fall back through three levels: document → SDK → built-in default."
---

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.

```csharp

using Nutrient;

```

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

## Properties

### BitonalImageCompression

```csharp

public PdfCompression BitonalImageCompression { get; set; }

```

Gets or sets the value of BitonalImageCompression. Reads walk the chain: Document override → SDK override → Default. Writes go to document level if available, otherwise SDK level.

**Type:** [`PdfCompression`](/api/csharp/enums/pdf-compression/)

### ColorImageCompression

```csharp

public PdfCompression ColorImageCompression { get; set; }

```

Gets or sets the value of ColorImageCompression. Reads walk the chain: Document override → SDK override → Default. Writes go to document level if available, otherwise SDK level.

**Type:** [`PdfCompression`](/api/csharp/enums/pdf-compression/)

### Conformance

```csharp

public PdfConformance Conformance { get; set; }

```

Gets or sets the value of Conformance. Reads walk the chain: Document override → SDK override → Default. Writes go to document level if available, otherwise SDK level.

**Type:** [`PdfConformance`](/api/csharp/enums/pdf-conformance/)

### EnableColorDetection

```csharp

public bool EnableColorDetection { get; set; }

```

Gets or sets the value of EnableColorDetection. Reads walk the chain: Document override → SDK override → Default. Writes go to document level if available, otherwise SDK level.

**Type:** `bool`

### EnableLinearization

```csharp

public bool EnableLinearization { get; set; }

```

Gets or sets the value of EnableLinearization. Reads walk the chain: Document override → SDK override → Default. Writes go to document level if available, otherwise SDK level.

**Type:** `bool`

### ForceImageDpi

```csharp

public int ForceImageDpi { get; set; }

```

Gets or sets the value of ForceImageDpi. Reads walk the chain: Document override → SDK override → Default. Writes go to document level if available, otherwise SDK level.

**Type:** `int`

### Mode

```csharp

public PdfSettingsMode Mode { get; set; }

```

Gets or sets the value of Mode. Reads walk the chain: Document override → SDK override → Default. Writes go to document level if available, otherwise SDK level.

**Type:** [`PdfSettingsMode`](/api/csharp/enums/pdf-settings-mode/)

### Optimize

```csharp

public bool Optimize { get; set; }

```

Gets or sets the value of Optimize. Reads walk the chain: Document override → SDK override → Default. Writes go to document level if available, otherwise SDK level.

**Type:** `bool`

### SavePreferences

```csharp

public PdfSavePreferences SavePreferences { get; set; }

```

Gets or sets the value of SavePreferences. Reads walk the chain: Document override → SDK override → Default. Writes go to document level if available, otherwise SDK level.

**Type:** [`PdfSavePreferences`](/api/csharp/enums/pdf-save-preferences/)

### UseDeflateOnJpeg

```csharp

public bool UseDeflateOnJpeg { get; set; }

```

Gets or sets the value of UseDeflateOnJpeg. Reads walk the chain: Document override → SDK override → Default. Writes go to document level if available, otherwise SDK level.

**Type:** `bool`

### ZlibLevel

```csharp

public int ZlibLevel { get; set; }

```

Gets or sets the value of ZlibLevel. Reads walk the chain: Document override → SDK override → Default. Writes go to document level if available, otherwise SDK level.

**Type:** `int`

## Resource management

```csharp

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.

---

## Related pages

- [Format](/api/csharp/settings/format.md)
- [Accessibility Settings](/api/csharp/settings/format/accessibility-settings.md)
- [Cad Settings](/api/csharp/settings/format/cad-settings.md)
- [Email Settings](/api/csharp/settings/format/email-settings.md)
- [Html Settings](/api/csharp/settings/format/html-settings.md)
- [Image Settings](/api/csharp/settings/format/image-settings.md)
- [Jpeg Settings](/api/csharp/settings/format/jpeg-settings.md)
- [Markdown Settings](/api/csharp/settings/format/markdown-settings.md)
- [Presentation Settings](/api/csharp/settings/format/presentation-settings.md)
- [Search Settings](/api/csharp/settings/format/search-settings.md)
- [Spreadsheet Settings](/api/csharp/settings/format/spreadsheet-settings.md)
- [Text Settings](/api/csharp/settings/format/text-settings.md)
- [Word Settings](/api/csharp/settings/format/word-settings.md)