> For the complete documentation index, see [llms.txt](https://docs.viesus.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.viesus.com/configuration/parameter-reference/mode-switches.md).

# Mode Switches

Controls which processing stages are enabled in the enhancement pipeline.

<table><thead><tr><th width="181.60009765625">Parameter</th><th width="86.2000732421875">Value</th><th width="97.39990234375">Default</th><th>Description</th></tr></thead><tbody><tr><td><code>ARmode</code></td><td>0 – 8</td><td>2</td><td><a href="/pages/Ns1fAktWQXSySxYvkfKM">Artifact removal</a>. See <a href="#armode-values">ARmode values</a> below.</td></tr><tr><td><code>Enhancemode</code></td><td>0 – 3</td><td>1</td><td><a href="/pages/JvqjGnjGdqsk3kQASBze">Enhancement mode</a>. <strong>0</strong> = none, <strong>1</strong> = normal, <strong>2</strong> = no enhance + no manual CC, <strong>3</strong> = normal + no manual CC</td></tr><tr><td><code>RERmode</code></td><td>0 – 2</td><td>0</td><td><a href="/pages/Nt5fpiiAJhxOKjLnl6zV">Red-eye reduction</a>. <strong>0</strong> = disabled, <strong>1</strong> = safe, <strong>2</strong> = extended</td></tr><tr><td><code>FDmode</code></td><td>0 – 3</td><td>1</td><td><a href="/pages/zL6tVzIb4U18r0oQBZ2D">Face detection</a>. <strong>0</strong> = off, <strong>1</strong> = normal, <strong>2</strong> = full analysis, <strong>3</strong> = blur faces (anonymise)</td></tr><tr><td><code>SHPmode</code></td><td>0, 1</td><td>1</td><td><a href="/pages/Q5YiJE6x8rqvzavC5OKq">Local sharpening</a>. <strong>0</strong> = disabled, <strong>1</strong> = enabled</td></tr><tr><td><code>NoiseRedMode</code></td><td>0 – 3</td><td>0</td><td><a href="/pages/14aIw2hrFF71b869yDL0">Noise reduction</a>. <strong>0</strong> = off, <strong>1</strong> = automatic profiling (recommended), <strong>2</strong> = fixed-strength (no profiling), <strong>3</strong> = AI Noise Removal</td></tr><tr><td><code>SKIPmode</code></td><td>0, 1</td><td>1</td><td>Skip artificial images. <strong>0</strong> = skip, <strong>1</strong> = enhance all</td></tr><tr><td><code>WFmode</code></td><td>0, 1</td><td>0</td><td><a href="/pages/NaUpE9hNn3Xxwnu3nfWM">White fix</a>. <strong>0</strong> = disabled, <strong>1</strong> = enabled</td></tr><tr><td><code>FRmode</code></td><td>0 – 3</td><td>1</td><td><a href="/pages/lIiR838RscSsqGYHEDdn">Face reconstruction</a>. <strong>0</strong> = off, <strong>1</strong> = default, <strong>2</strong> = mixed, <strong>3</strong> = fast</td></tr><tr><td><code>AFFmode</code></td><td>0, 1</td><td>0</td><td><a href="/pages/6x3AsIljrmM8rTWn4UEl">Adaptive Face Flash</a>. <strong>0</strong> = disabled, <strong>1</strong> = enabled</td></tr><tr><td><code>ProcessingSequence</code></td><td>0 – 3</td><td>0</td><td>Processing order. <strong>0</strong> = default, <strong>1</strong> = resize after, <strong>2</strong> = resize before, <strong>3</strong> = red-eye first</td></tr><tr><td><code>GAmode</code></td><td>0, 1</td><td>0</td><td><a href="/pages/4vJbdyKDZNCa8fDdJ0Tk">Grain addition</a>. <strong>0</strong> = disabled, <strong>1</strong> = enabled</td></tr><tr><td><code>BGmode</code></td><td>0 – 4</td><td>0</td><td><a href="/pages/GqKSz0mDGOrFA8yfHtYa">Background handling</a>. <strong>0</strong> = off, <strong>1</strong> = alpha, <strong>2</strong> = color replace, <strong>3</strong> = image replace, <strong>4</strong> = alpha + color (pre-composited RGBA)</td></tr><tr><td><code>BGBlurmode</code></td><td>0, 1</td><td>0</td><td><a href="/pages/YihtRB8SqqViYxKr2hDM">Background blurring</a>. <strong>0</strong> = disabled, <strong>1</strong> = enabled</td></tr><tr><td><code>BGBalmode</code></td><td>0 – 3</td><td>0</td><td><a href="/pages/GqKSz0mDGOrFA8yfHtYa">Background balancing</a>. <strong>0</strong> = off, <strong>1</strong> = to first, <strong>2</strong> = strict, <strong>3</strong> = to parameters</td></tr><tr><td><code>VSceneMode</code></td><td>0, 1</td><td>0</td><td>vScene <a href="/pages/nGGFNJ96jlemzu6AVo7b">scene-aware enhancement</a>. <strong>0</strong> = off, <strong>1</strong> = on. Enables scene detection and Scene Preset selection automatically.</td></tr><tr><td><code>HDRmode</code></td><td>0 – 7</td><td>0</td><td><a href="/pages/JHPIX3efhL8sQDBhsChH">HDR tonemapping</a> method. See <a href="#hdrmode-values">HDRmode values</a> below.</td></tr></tbody></table>

## `ARmode` values

<table><thead><tr><th width="110">Value</th><th>Description</th></tr></thead><tbody><tr><td><code>0</code></td><td>Off</td></tr><tr><td><code>1</code></td><td>Auto, CPU-only DCT smoothing</td></tr><tr><td><code>2</code></td><td>Auto with AI (default) — detects artifact severity, selects appropriate model</td></tr><tr><td><code>3</code></td><td>Auto with AI, fast</td></tr><tr><td><code>4</code></td><td>Always CPU — unconditional CPU-based DCT smoothing</td></tr><tr><td><code>5</code></td><td>Always AI — unconditional full-quality AI removal</td></tr><tr><td><code>6</code></td><td>Always AI, fast</td></tr><tr><td><code>7</code></td><td>Always CPU + AI — combined CPU and AI passes</td></tr><tr><td><code>8</code></td><td>Always CPU + AI, fast</td></tr></tbody></table>

## `HDRmode` values

<table><thead><tr><th width="110">Value</th><th>Description</th></tr></thead><tbody><tr><td><code>0</code></td><td>Off — no tonemapping</td></tr><tr><td><code>1</code></td><td>Soft cinematic look — broadly forgiving default</td></tr><tr><td><code>2</code></td><td>Broadcast-standard tonemapping — predictable for video / broadcast</td></tr><tr><td><code>3</code></td><td>Dynamic metadata–aware — best when source carries dynamic HDR metadata</td></tr><tr><td><code>4</code></td><td>Reference knee curve — predictable mid-tones, soft highlight rolloff</td></tr><tr><td><code>5</code></td><td>Smooth-gradient operator — can compress highlights heavily</td></tr><tr><td><code>6</code></td><td>Smooth gradient with explicit white point — sharper highlights</td></tr><tr><td><code>7</code></td><td>High-contrast cinematic — popular for portraits and product shots</td></tr></tbody></table>

## Feature dependencies

Features that depend on another feature enable that dependency automatically at runtime — you do not need to set it yourself:

| Feature                         | Requires                  |
| ------------------------------- | ------------------------- |
| Face Reconstruction (`FRmode`)  | Face Detection (`FDmode`) |
| Red-Eye Removal (`RERmode`)     | Face Detection (`FDmode`) |
| Adaptive Face Flash (`AFFmode`) | Face Detection (`FDmode`) |
| Portrait Auto Crop (`CropMode`) | Face Detection (`FDmode`) |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.viesus.com/configuration/parameter-reference/mode-switches.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.