> 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.md).
# Parameters
Complete `viesusini.json` parameter reference for VIESUS. All values are JSON.
Providing a `viesusini.json` is **optional** — VIESUS enhances with built-in defaults when no file is supplied. Supply a file only to override specific defaults, and list just the parameters you want to change; everything omitted keeps its default.
{% hint style="info" %}
**How strength parameters work:** VIESUS automatically calculates the appropriate correction for each image. The strength parameters scale how much of the calculated correction is actually applied. This applies to all corrections, global and local.
{% endhint %}
For descriptions of what each feature does, see [Features](/features/features.md). For ready-to-use configurations, see the [Presets Gallery](/configuration/presets-gallery.md).
{% hint style="info" %}
**Easiest way to tune parameters interactively:** load your config into the [VIESUS Viewer](/tools/viesus-viewer.md), open a representative image, and adjust parameters live with before/after preview.
{% endhint %}
***
## Configuration sections
The `viesusini.json` file groups settings into sections. Each section has its own reference page:
| Section | What it controls | Reference |
| ------------------------ | ------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- |
| `Gpars` | Global correction strengths (brightness, color, sharpening, noise, AI features) and manual corrections | [Global Parameters](/configuration/parameter-reference/global-parameters.md) |
| `Lpars` | Local corrections per region and per color zone (skin, sky, vegetation) | [Local Parameters](/configuration/parameter-reference/local-parameters.md) |
| `Config` | Processing mode flags — which features are active, plus `ARmode`/`HDRmode` values | [Mode Switches](/configuration/parameter-reference/mode-switches.md) |
| `Resize` | Upscaling mode, super-resolution, and target dimensions | [Resizing](/configuration/parameter-reference/resizing.md) |
| `Background`, `AutoCrop` | Background replacement / color / balance, and portrait auto-cropping | [Background & Cropping](/configuration/parameter-reference/background-and-cropping.md) |
| `Other`, `ICCProfiles` | Output format, JPEG quality, DPI, monochrome / sepia, and output ICC profile | [Output & Color](/configuration/parameter-reference/output-and-color.md) |
The file also supports named **Scene Preset** sections (e.g. `vScene_Landscape`, `vScene_People`) that override selected defaults for specific content types. Each section name carries a `vScene_` prefix so the scene type can never clash with a standard section name — for example, the `Other` scene type would otherwise collide with the top-level `Other` section.
VIESUS selects the active preset automatically when scene-aware enhancement (`VSceneMode`) is enabled — see the [vScene example](#scene-aware-enhancement-vscene) below.
A `viesusini.json` generated by VIESUS (for example, exported from the VIESUS Viewer) also carries top-level `version` and `library` keys recording the build that wrote the file. These are informational only — leave them untouched or omit them.
***
## Passing the configuration file
| Interface | How to pass the config |
| -------------- | ---------------------------------------------------------------- |
| CLI | `-p /path/to/viesusini.json` |
| PDF Enhancer | Third positional argument: `viesusPDF src/ dest/ viesusini.json` |
| Node.js module | `iniPath` parameter of `Enhance()` |
| C/C++ SDK | Passed at initialization — see SDK docs |
***
## Common configuration examples
Copy, adapt, and test from these starting points. For downloadable, ready-to-run files, see the [Presets Gallery](/configuration/presets-gallery.md).
### Standard photo enhancement (no resize)
```json
{
"Config": {
"Enhancemode": 1, "NoiseRedMode": 1, "SHPmode": 1,
"FDmode": 1, "RERmode": 1, "FRmode": 1, "ARmode": 2
},
"Other": { "JpegComprQuality": 95 }
}
```
### AI upscaling 2× (requires GPU)
```json
{
"Config": { "Enhancemode": 1, "SHPmode": 1, "FDmode": 1, "ARmode": 2 },
"Resize": { "ResizeOn": 1, "ResizeMode": 10, "ResizeFactor": 2.0 }
}
```
### Background removal to transparency (requires GPU, ≥8 GB VRAM)
Removes the background to a transparent alpha channel — save the output as PNG.
```json
{
"Config": { "Enhancemode": 1, "SHPmode": 1, "FDmode": 1, "BGmode": 1 }
}
```
To replace the background with a solid color instead, set `"BGmode": 2` and add a `Background` section with `backgroundR` / `backgroundG` / `backgroundB` (0 – 255).
### Conservative — gentle strengths, skip artificial images
Skips artificial (non-photographic) images and applies lighter-than-default correction.
```json
{
"Config": { "Enhancemode": 1, "SHPmode": 1, "FDmode": 1, "SKIPmode": 0 },
"Gpars": { "brstrength": 0.3, "ccstrength": 0.3, "shpglobalstrength": 0.2 }
}
```
### Scene-aware enhancement (vScene)
When `VSceneMode: 1` is set, VIESUS detects the scene type and applies the matching **Scene Preset** — only the parameters listed in a preset are overridden; all others fall back to the top-level defaults. Each preset section is named with a `vScene_` prefix followed by the scene type (e.g. `vScene_Landscape`).
```json
{
"Config": { "Enhancemode": 1, "VSceneMode": 1 },
"Gpars": { "brstrength": 0.5 },
"vScene_Landscape": {
"Gpars": { "shpglobalstrength": 0.3 },
"Lpars.sky": { "saturation": 0.1, "brightness": -0.25 },
"Lpars.veg": { "saturation": 0.1, "brightness": 0.25 }
},
"vScene_People": {
"Gpars": { "gastrength": 0.5 },
"Lpars.skin": { "saturation": -0.05, "brightness": 0.1 }
}
}
```
See [Scene-Based Enhancement](/features/scene-based-enhancement.md) for more information and available scene types.
***
## Usage notes
* **`0.5` strength is a balanced starting point** for most automatic applications.
* **Face-related features need testing** in automated workflows — false positives can degrade results.
* **Background manipulation requires verification** — automatic results are not always print-ready without QA.
* **Super-resolution modes increase processing time significantly** but improve quality for upscaling scenarios.
For ready-to-use starting configurations, see the [Presets Gallery](/configuration/presets-gallery.md). For PDF-specific settings, see the [PDF Enhancer Settings Reference](/configuration/pdf-settings.md).
---
# 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.md?ask=&goal=
```
`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.