Parameters

Complete reference for all viesusini.json parameters — Gpars, Lpars, Config, Resize, Background, ICCProfiles, AutoCrop, and Other.

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.

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.

For descriptions of what each feature does, see Features. For ready-to-use configurations, see the Presets Gallery.

Easiest way to tune parameters interactively: load your config into the VIESUS Viewer, open a representative image, and adjust parameters live with before/after preview.

---

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
Lpars	Local corrections per region and per color zone (skin, sky, vegetation)	Local Parameters
Config	Processing mode flags — which features are active, plus ARmode/HDRmode values	Mode Switches
Resize	Upscaling mode, super-resolution, and target dimensions	Resizing
Background, AutoCrop	Background replacement / color / balance, and portrait auto-cropping	Background & Cropping
Other, ICCProfiles	Output format, JPEG quality, DPI, monochrome / sepia, and output ICC profile	Output & Color

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 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.

Standard photo enhancement (no resize)

{
  "Config": {
    "Enhancemode": 1, "NoiseRedMode": 1, "SHPmode": 1,
    "FDmode": 1, "RERmode": 1, "FRmode": 1, "ARmode": 2
  },
  "Other": { "JpegComprQuality": 95 }
}

AI upscaling 2× (requires GPU)

{
  "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.

{
  "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.

{
  "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).

{
  "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 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. For PDF-specific settings, see the PDF Enhancer Settings Reference.