Chapter 9 — Settings

Edit → Settings… opens the Settings dialog, which docks alongside the main viewport so you can see edits live-update on a real model. The dialog has four tabs: Defaults, Rendering, License, and Experimental.

Settings persist to a JSON file (settings.json) in the app's per-user data directory — Windows AppData, macOS Application Support, etc. Edits save automatically; there's no "Apply" button.

Defaults tab

Settings — Defaults

The Defaults tab controls what File → New produces. Tweak these once and every fresh model starts the way you want.

New Model Defaults

Default Height (mm) / Default Diameter (mm) — starting size.
Default Wall Thickness (mm) / Default Bottom Thickness (mm) — cavity-related defaults applied to new models.
Default Closed Solid — most users want this on (a hollow vase).
Default Open Top — keep on for vases, off for sealed bottles.

Quality Defaults

Default Viewport Quality — Low / Medium / High / VeryHigh / Ultra. Higher = smoother in the editor but slower refresh; a textured body wants at least High to not alias.
Default Export Quality — independent of viewport, used by File → Export. High is the sweet spot for most exports.

Default Printer Preset — picks the build plate for fresh models. The dropdown lists every preset from the Bambu / Prusa / Eazao / WASP / 3D Potter / Stoneflower catalogues plus Custom.

Default Surface Color — the clay tint shown in the viewport. The toolbar 🎨 picker overrides per-session; this sets the starting value for new models.

Library Folder — where saved-to-library projects live on disk. Browse… opens a native folder picker; ⟳ resets to the default location (~/Documents/DigitalClay Projects/).

Rendering tab

Settings — Rendering

The Rendering tab is the studio. Every knob lives here so you can match a particular look (gallery white, terracotta sunset, dramatic gallery spot, etc.):

Material

Roughness (0..1) — 0 = polished glaze, 1 = matte clay. 0.20 default.
Metalness (0..1) — 0 = clay (default), 1 = mirror-finished glaze.
Environment Map intensity (0..1) — how strongly the IBL contributes vs the direct lights. 0.7 default.

Environment

Sky / Mid / Horizon / Ground colours — the four-stop gradient used to build the PMREM environment map. Drives reflections and IBL.

Lights

Five-point studio lighting: Key, Side, Fill, Rim, Bounce. Each light has Position, Intensity, and Color. Defaults give the dramatic asymmetric rake you see on first launch.
Hemisphere Sky / Ground — the ambient light. Two colours blend vertically across the model.

Tone-mapping & Output

Exposure (0.5..2) — overall brightness. 0.85 default produces flatter highlights on glazed clay.
Shadow Map size — soft contact shadows.

Copy / Paste JSON

The bottom of the panel has Copy / Paste JSON buttons. Copy your favourite preset to the clipboard, paste into a Discord post or share it as a file — the JSON is a self-contained snapshot of every render setting.

License tab

Settings — License

Where you enter your purchased license key. Three states:

No license / Demo — the app is in trial mode; certain features are read-only.
License pending — you've entered a key and the server is validating.
Licensed — feature unlock is active.

Click Browse… to load a .lic / .dat / .json license file from disk, or paste the key directly. The license file is portable — copying it to another machine of yours moves the activation. (See ../legal/LICENSING.md for the back-end issuance flow.)

Experimental tab

Settings — Experimental

Three opt-in flags for in-development features. They work today but may evolve in future releases — accept the trade-off before flipping them on.

🏺 Pottery Wheel — exposes the Tools → Pottery Wheel entry. Real-time sculpting tools that spin the model and let you push, pull, carve, smooth, widen, narrow. See Chapter 3.
⎙ Printer path simulation — exposes the Printer sidebar tab. Layer-by-layer toolpath preview with gravity-aware droop prediction. Useful for "will this overhang collapse?" sanity checks before printing.
◬ Multi-Object Lofting — exposes the Lofting Mode dropdown in the Shape tab when you're in Lofting mode. Lets you place up to 8 primitives per layer with topology-changing transitions via SDF + Marching Tetrahedra. See Chapter 2.

Note on auto-enable: when you load a project that uses an experimental feature (e.g. a multi-object loft .t3d), the relevant flag is auto-enabled and an info dialog explains what was activated. You can disable it again here afterward; existing multi-object projects will continue to render correctly even with the flag off.

Where settings live on disk

Platform	Path
Windows	`%APPDATA%/DigitalClay3D/settings.json`
macOS	`~/Library/Application Support/DigitalClay3D/settings.json`
Linux	(web demo only — settings are in-memory and reset per page-load)
iOS	App's Documents container — `Files.app → On My iPhone → DigitalClay3D`
Android	App's external Documents directory

The file is plain JSON — back it up by copying, restore by replacing. Click Save settings at the bottom of the dialog to force-write immediately if you suspect autoSave didn't fire.