iccery-v2-mac/docs/22-settings-presets.md

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