settings reference

Settings reference

Every field in the Settings dialog. Grouped by the dialog's three columns. Values persist to %APPDATA%\CCL_Clay3DP\settings.json; the schema mirrors Models/PipelineSettings.cs in the code repo.

📷 The Settings dialog open, all groups visible, used as the canonical screenshot for cross-reference.

Clay Material

Field	Type	Default	Notes
PresetName	string	Stoneware	One of Porcelain / Stoneware / Earthenware. Selecting a preset overwrites bead diameter, max overhang, bond ratio, density. Custom is implicit when any preset value is overridden.
BeadDiameter	mm	2.5	Diameter of the deposited clay bead. Sets the heatmap reference and the Preview Clay Model tube radius. Layer height must be ≤ this value — see Pipeline 3.
MaxOverhangAngle	degrees	varies by preset	Cap on overhang at which the Clay heatmap channel scores 1.0.
MinLayerBondRatio	0–1	varies by preset	Minimum acceptable layer-to-layer overlap ratio. Below this, Clay channel scores 1.0.
MaterialDensity	g/cm³	varies by preset	Reference for nozzle / feedrate calculations (currently informational).
WaterPercent	% of dry mass	varies	Lab's mix recipe — additive % (6% = 60 g water per 1 kg dry clay). Recorded only; downstream effect deferred until the lab's 6/8/10/12% experiments produce a curve. See Materials.
EnableShrinkageCompensation	bool	false	When on, the slice pipeline scales input geometry to compensate for total drying + firing shrinkage.
ShrinkagePercent	%	0 (range 0–25)	Total drying-plus-firing shrinkage. Scale factor applied is 1 / (1 − pct/100) about the part footprint centroid on Z = 0.

Build Volume

Field	Type	Default	Notes
Width	mm	400	X dimension of the cell envelope. Centered on world origin.
Depth	mm	400	Y dimension. Centered on world origin.
Height	mm	1000	Z dimension. Starts at the build plate (Z=0).

The pipeline accesses computed XMin / XMax / YMin / YMax properties under the hood (= ±Width/2, ±Depth/2). JsonIgnored, not persisted.

Pre-1.2 settings.json (which had explicit XMin/XMax/YMin/YMax) migrate automatically on first load — Width = old (XMax − XMin), Depth = old (YMax − YMin).

Tool / Nozzle

Field	Type	Default	Notes
NozzleTool	string	T11	One of T10, T11, T12 — the RoboDK reference frame for the active nozzle. Sets the tool change in the post-processed output. Currently the only Tool group field; nozzle-parameter expansion (sizes, behaviors per nozzle) is tracked as #12.

Toolpath

Field	Type	Default	Notes
SpiralSlice	bool	true	True = Spiral mode (vase, continuous spiral). False = Layer mode.
OuterWallBracing	bool	false	Layer mode only. Adds a bracing rib per layer (zigzag by default, or sinusoidal — see SinusoidalBracing). Wall-contact points kiss the outer-wall bead by half a bead width ("french kiss" overlap, Issue #11). Requires ruled geometry.
BracingContactPoints	int	60	Layer + Bracing only. Number of times the bracing toolpath touches the outer wall per layer — countable by eye in the viewport. Range 4..500. Decoupled from FramesPerLayer (Issue #11) so bracing density is independent of toolpath sampling.
SinusoidalBracing	bool	false	Layer + Bracing only. When true, the rib is a smooth cosine wave instead of a triangle-wave zigzag. Same contact-point count; gentler on robot accel/decel because there are no corner reversals.
SpiralFollowsCurveNormal	bool	false	Spiral mode only. Banks the build plate to follow the surface normal. Off by default; warns when enabled.
LayerHeight	mm	1.8	Z step between contours. Must be ≤ BeadDiameter — slice rejects otherwise.
FramesPerLayer	int	varies	Number of robot frames generated per contour. Higher = smoother + slower.
StartAngle	degrees	0	Where on the contour the spiral starts (Spiral mode) or the seam lands (Layer mode).
DirectionCCW	bool	true	Spiral / layer direction.

Robot / Extruder

Field	Type	Default	Notes
FeedRate	mm/s	varies	Operation speed along the toolpath. Maps to RoboDK SpeedOperation.
TravelSpeed	mm/s	varies	Approach / retract speed. Maps to RoboDK SpeedRapid.
MaxWristAngularVelocity	rad/s	varies	Cap for the Robot heatmap channel. Above this, frames score 1.0.
SpindleSpeed	int (S-value)	varies	Extruder SPD command emitted at start of each path. See Calibration for SPD→flow.
RoboDKExecutablePath	path	(empty)	Where RoboDK is installed. First-run prompts you to set this.
RoboDKStationTemplatePath	path	(empty)	Path to the bundled 3DP_v0.4.rdk station. First-run prompts.
RoboDKProjectName	string	CCL_Clay3DP	Display name for the loaded RoboDK project. Cosmetic.

Base (multi-layer raft)

Field	Type	Default	Notes
EnableBase	bool	false	When on, prepends N flat layer contours below the part. The part body shifts up by N × LayerHeight.
LayerCount	int	0	How many base layers.

Persistence

What	Where
On-disk file	%APPDATA%\CCL_Clay3DP\settings.json
Schema migration	Automatic via [JsonExtensionData] on BuildVolumeSettings (catches old XMin/XMax/YMin/YMax keys, computes Width/Depth at first Load)
Import / Export	Settings dialog buttons round-trip to/from a user-chosen JSON file (does not modify the global persisted file until OK is clicked)

For the schema-as-code, see Models/PipelineSettings.cs and the dependent classes (ClayMaterialSettings, RobotSettings, etc.) in the code repo.