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

Settings for Image. 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

### ExportFormat

```csharp

public ImageExportFormat ExportFormat { get; set; }

```

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

**Type:** [`ImageExportFormat`](/api/csharp/enums/image-export-format/)

### JpegQuality

```csharp

public int JpegQuality { get; set; }

```

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

**Type:** `int`

### Mode

```csharp

public ImageSettingMode 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:** [`ImageSettingMode`](/api/csharp/enums/image-setting-mode/)

### PageIndex

```csharp

public int? PageIndex { get; set; }

```

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

**Type:** `int?`

### RasterizationDpi

```csharp

public float RasterizationDpi { get; set; }

```

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

**Type:** `float`

## Resource management

```csharp

public void Dispose()

```

`ImageSettings` 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)
- [Jpeg Settings](/api/csharp/settings/format/jpeg-settings.md)
- [Markdown Settings](/api/csharp/settings/format/markdown-settings.md)
- [Pdf Settings](/api/csharp/settings/format/pdf-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)