gronodandDevin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
4c2863e52c
Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
70 lines
4.8 KiB
Markdown
70 lines
4.8 KiB
Markdown
# 22 — Settings and presets
|
||
|
||
Persisted at `{app_data}/settings.json` via `load_settings` / `save_settings`. Invalid JSON loads `AppSettings::default()`. `save_settings` calls `validate()` then writes pretty JSON and **immediately** applies `log::set_max_level`.
|
||
|
||
## `AppSettings` (`settings.rs`)
|
||
|
||
| Field | Default | Notes |
|
||
|-------|---------|-------|
|
||
| `argyll_binary_dir` | `null` | Overrides bundled sidecars. `resolve_binary` checks this first. |
|
||
| `default_instrument` | `null` | **Stored but not applied to argv.** Stage 2 `#instrumentSelect` is the source of truth. Do not start honouring this without an explicit product decision. |
|
||
| `log_level` | `null` | `error` / `warn` / `info` / `debug` / `trace`. `null` → Debug in debug builds, Info in release. Applied at startup **and** on save (#158). |
|
||
| `delta_e_good_max` | `2.0` | Stage 3 swatch traffic-light "Good". Must be ≥ 0. |
|
||
| `delta_e_warning_max` | `5.0` | Stage 3 "Warning" band. Must be **strictly greater** than good. |
|
||
| `custom_presets` | `[]` | User presets; built-ins are **not** stored here. |
|
||
| `enable_i1pro2_leds` | `false` | Adds `chartread -Y l`. Default off so stock Argyll still runs. |
|
||
| `calibration_stale_days` | `30` | Stage 0 / Stage 1 reminder. |
|
||
| `default_install_location` | `"user"` | `"user"` \| `"system"` for Stage 5. |
|
||
| `ask_before_overwrite_profile` | `true` | |
|
||
| `open_color_panel_after_install` | `false` | |
|
||
|
||
Validation error strings (surface in `#deltaEThresholdError`):
|
||
|
||
- `"ΔE thresholds cannot be negative."`
|
||
- `"Good ΔE threshold must be strictly less than the warning threshold."`
|
||
|
||
Saving dispatches a DOM `settings-saved` event so the live swatch grid reclassifies without a re-read.
|
||
|
||
Settings dialog ids: `argyll_binary_dir`, `default_instrument`, `enable_i1pro2_leds`, `deltaEGoodMax`, `deltaEWarningMax`, `deltaEThresholdError`, `calibrationStaleDays`, `defaultInstallLocation`, `askBeforeOverwriteProfile`, `openColorPanelAfterInstall`, `logLevelSelect`, `btnOpenLogFolder`, `btnCopyLogPath`, `btnCopyLogExcerpt`, `logPathDisplay`, `saveSettingsBtn`, `closeSettingsBtn`.
|
||
|
||
Log helpers: `get_log_path`, `get_recent_log_excerpt`, `open_log_dir`.
|
||
|
||
## `ProfilingPreset`
|
||
|
||
Every field is optional-defaulted with `#[serde(default)]` except the required identity / Stage 1–2 core. `applyPreset` **must** set TIFF DPI (#113) — a historical bug left `#tiffDpi` at 300 when loading the 150 dpi draft preset.
|
||
|
||
| Field | Type | Stage |
|
||
|-------|------|-------|
|
||
| `id`, `name`, `description` | string | identity. Names/descriptions go through `textContent`, never `innerHTML` (#114 XSS) |
|
||
| `colour_space` | `"rgb"` \| `"cmyk"` | 1 |
|
||
| `patch_count`, `white_patches`, `black_patches` | u32 | 1 |
|
||
| `grey_steps`, `single_channel_steps`, `neutral_steps` | Option\<u32\> | 1 advanced |
|
||
| `preconditioning_profile` | Option\<path\> | 1 `-c` |
|
||
| `neutral_concentration` | Option\<f64\> | 1 `-N` |
|
||
| `ofps_high_quality` | Option\<bool\> | 1 `-G` |
|
||
| `ofps_adaptation` | Option\<f64\> | 1 `-A` |
|
||
| `full_spread_algorithm` | Option\<string\> | 1 `-t/-r/-R/-q/-Q/-i/-I` |
|
||
| `total_ink_limit` | Option\<u32\> | 1 `-l` CMYK |
|
||
| `dark_emphasis`, `device_power` | Option\<f64\> | 1 `-V` / `-p` |
|
||
| `instrument`, `page_size`, `bit_depth`, `dpi` | | 2 |
|
||
| `random_seed`, `no_randomize` | | 2 `#printtargLayoutOrder` |
|
||
| `calibration_file`, `apply_calibration` | | 0 / 2 `-K` |
|
||
| `colprof_algorithm`, `colprof_quality`, `colprof_intent` | | 4 |
|
||
| `colprof_fwa`, `colprof_illuminant`, `colprof_observer` | | 4 |
|
||
| `colprof_input_viewing_cond`, `colprof_output_viewing_cond` | | 4 |
|
||
|
||
## Built-in presets (`get_default_presets`)
|
||
|
||
Built-ins cannot be deleted. Custom presets overlay by `id`. Import/export is JSON via `export_preset_json` / `import_preset_json` with schema validation (unknown keys ignored via serde default; missing required fields fail).
|
||
|
||
| id | Name | Space | Patches | Page | Bit | DPI | Quality | Extra |
|
||
|----|------|-------|---------|------|-----|-----|---------|-------|
|
||
| `preset-std-rgb` | Standard RGB Photo (800 patches) | rgb | 800, white 4 | A4 | 8 | 300 | `m` | FWA D50, seed 1, instrument i1, alg `l` |
|
||
| `preset-hq-cmyk` | High-Gamut CMYK Proofing (1500 patches) | cmyk | 1500, black 8 | A3 | 16 | 300 | `h` | ink limit 320, FWA D50, seed 1 |
|
||
| `preset-draft-rgb` | Fast RGB Draft (400 patches) | rgb | 400 | A4 | 8 | **150** | `l` | FWA D50, seed 1 |
|
||
| `preset-ultra-rgb` | Ultra Precision RGB (2500 patches) | rgb | 2500, white 6, black 6 | A3 | 16 | 300 | `u` | `ofps_high_quality=true` (`-G`), FWA D50, seed 1 |
|
||
|
||
All four: `instrument: "i1"`, `colprof_algorithm: "l"`, `random_seed: 1`, `no_randomize: false`, `colprof_fwa: "D50"`.
|
||
|
||
UI: `#presetSelect`, `#btnSavePresetModal` → `#savePresetDialog` (`savePresetName`, `savePresetDesc`, `btnConfirmSavePreset`), `#btnOpenPresetsDialog` → `#managePresetsDialog` (`managePresetsList`, `btnExportActivePreset`, `btnImportPreset`).
|