Convert textured 3D models (GLB, 3MF, STL, OBJ, or COLLADA) into multi-color 3D-printable files (3MF) for multi-filament printers.
Pre-built binaries for Linux, Windows, and macOS are available on the Releases page.
- Launch
ditherforge - In the Model section, click the File dropdown and choose Browse
for file… to select a
.glb,.3mf,.stl,.obj, or.dae(COLLADA) file (an OBJ or COLLADA model packaged in a.zipalongside its.mtl/textures also works). Previously loaded models are one click away under the dropdown's Recent submenu. - Set Nozzle diameter and Layer height to match your slicer
- Set Size (mm) to your target print size
- Optionally, open the Stickers panel to apply PNG or JPEG images onto the model surface
- Optionally, open the Split panel to cut the model in two halves that print side-by-side and assemble with pegs
- Adjust the palette and color settings — the output preview updates automatically
- Use File > Export 3MF to save the result (defaults to
<input>.3mf) - Open the exported 3MF in OrcaSlicer or BambuStudio and print
All sidebar sections are collapsible — click a section header to fold or expand it.
The input model is just another setting: swapping it from the Model dropdown keeps the rest of your configuration — palette, adjustments, stickers, and color pins all carry over (sticker placements rescale to the new model's size). The File menu is JSON-only: Open JSON… and Open Recent JSON load and list saved settings files.
For real use, you'll want to update your Inventory filament collection as described right below.
The Filaments menu lists all available filament collections. Click a collection name to open its editor.
In the collection editor you can:
- Add, edit, or remove colors (click a swatch to change its hex or label)
- Delete the collection
Use Filaments > Import... to load a collection from a plain-text file.
Each line must be in the format #RRGGBB Label, for example:
#FF0000 Red
#00FF00 Green
#0000FF Blue
Use Filaments > New... to create an empty collection and add colors manually.
A built-in Panchroma Basic collection (28 colors) is included and cannot be deleted.
Use Size (mm) to scale the model so its largest extent matches the given
value. For example, set 100 to make the model 100 mm wide (or tall, whichever
is larger).
Use Scale mode for a relative multiplier instead. Toggle between Size and Scale using the radio buttons above the input field.
Set Nozzle diameter and Layer height in the settings panel to match the values you will use in your slicer. These control the voxel grid resolution:
- The first layer uses wider voxels (
nozzle × 1.275) to ensure full coverage and prevent the slicer from dropping thin features. - Upper layers use narrower voxels (
nozzle × 1.05) for finer color detail.
The default values are 0.4 mm nozzle and 0.20 mm layer height.
3MF and GLB files can contain multiple objects. When a file has more than one, an Object dropdown appears in the settings panel. Choose All objects to process the entire file together, or pick a specific object to work with it alone. STL files always contain a single mesh and do not show this control.
Meshes sometimes have faces without a texture or vertex color (common in STL files and in some 3MF files). By default these faces render as plain white. The Base color section of the settings panel offers two modes:
-
Solid — pick a single color from any of your filament collections. This acts as the "paint" applied to any face that has no other color assigned, before dithering and palette selection.
-
Texture — load a MaterialX shader graph (
.mtlxfile, or a.ziparchive containing the.mtlxand its textures) and apply it as a procedural or image-backed pattern. Procedural graphs (marble, brick, conditional banding such as rainbow stripes) are sampled per voxel in 3D, so the pattern looks carved-from-the-block rather than projected. Image-backed PBR packs (Quixel, AmbientCG, …) are projected via triplanar mapping, so they wrap cleanly across faces without requiring authored UVs on the mesh.Two knobs appear once a file is loaded:
- Tile size (mm) — the object-space distance one shading-unit cycle of the procedural maps to. For image packs this is also the texture's repeat distance. Smaller = denser pattern.
- Triplanar — sharpness of the triplanar projection blend for
image-backed graphs.
1is a soft cosine blend; higher values approach a hard box map. Ignored by purely procedural graphs that don't read texture coordinates.
Try the official
standard_surface_marble_solid.mtlxfor a procedural example, or grab a free image-backed pack from GPUOpen MatLib or AmbientCG and feed in its.zipdirectly. Only the graph'sbase_coloroutput is consumed — normal maps, roughness, etc. are ignored, and only RGB is baked into the print.
The palette grid shows all color slots. Each slot is either:
- Locked (solid border, lock icon) — a specific filament you have chosen
- Unlocked (dashed border) — filled automatically from the active filament collection
Click a slot to open the collection picker and choose a filament color. This locks the slot to that color. To unlock it and return it to auto, click the lock icon in the top-left corner of the swatch.
Add slots with the + button (up to 16). Remove a slot with the × button that appears on hover. The number of slots is the total number of filaments used in the output.
Unlocked slots are filled with the best-matching colors from the filament collection selected under Unlocked colors from. Locked colors are taken into account, so auto-selected colors complement rather than duplicate them.
Use Filaments in the menu bar to manage collections. See Managing Filament Collections.
Three sliders adjust the model's colors before palette selection:
- Brightness — lighten or darken (-100 to +100, default 0)
- Contrast — increase or reduce contrast (-100 to +100, default 0)
- Saturation — increase or reduce color intensity (-100 to +100, default 0)
The input preview reflects these adjustments instantly via GPU shaders. The output re-renders with each change.
Stickers let you apply PNG or JPEG images directly onto the model surface before voxelization. As you drag the cursor over the model while placing, a floating billboard preview shows exactly where the sticker will sit.
To place a sticker:
- Open the Stickers panel in the sidebar.
- Click Add and choose a PNG or JPEG file. A thumbnail appears in the panel and the app enters placement mode automatically.
- Click a point on the input model. The sticker centers on that point, oriented to the surface. The input preview updates immediately to show the applied sticker.
- Adjust Scale, Rotation, and Mode as needed.
Each sticker has two modes, selected with radio buttons:
- Projection (default) — projects the sticker along its normal, like a slide projector. The image lands on whatever front-facing surface is closest along the projection direction and does not wrap around corners. Works well on most shapes, including complex or non-developable geometry.
- Unfold — flood-fills from the clicked triangle across the mesh, unfolding each triangle into the sticker's tangent plane. The sticker wraps around curves following the surface. A Surface bend limit slider stops the flood-fill at sharp edges (0° = no limit). Best on developable patches (cylinders, cones, gentle curves).
There is no hard limit on the number of stickers. They are composited over the base model color during voxelization and are affected by the brightness, contrast, and saturation sliders like any other color on the model.
Sticker placements, scale, rotation, mode, and bend limit are saved and restored with the JSON settings file.
Color pins remap specific colors in the model before dithering. Use them to correct individual colors without affecting the rest of the model — for example, to shift a too-yellow green toward a truer green filament.
Each pin has:
- Source color — the color to replace, sampled from the input model or
typed as
#RRGGBB - Target color — the filament color to map toward, chosen from a collection
- Reach — how far the adjustment spreads in color space (delta E units, default 5). Higher values affect a broader range of similar colors.
To sample a source color from the model, click the eyedropper icon on a pin and then click a point on the input model preview. The color at that pixel is captured as the source.
Up to 8 pins are supported. The pipeline uses Gaussian RBF interpolation in CIELAB color space to blend multiple pin effects smoothly.
Color snap shifts each voxel's color toward the nearest palette color before dithering, by up to the configured delta E distance. This reduces noise in regions that are nearly a single solid color.
Set the value with the Color snap (delta E) slider (0 to 50, default 5). Set to 0 to disable.
Two options in the Advanced section keep sharp color boundaries from muddying. They are independent and can be used together.
- Color-aware cells (on by default) — segments each layer by color and tiles each monochrome region separately, so cell boundaries land on color boundaries. A checkerboard or other sharp pattern stays pure black/white instead of averaging to gray along the edges. Color features smaller than one cell are merged into a neighbouring region; the merge keeps the highest-contrast color boundary crisp — a thin strip between black and white cedes to whichever side it least resembles rather than smearing the sharp edge toward gray. The Color contrast (delta E) slider sets how different two surface colors must be before their boundary is cut into a cell edge — low (~5) cuts almost any edge, higher (~20–30) only crisp ones.
- Confine dither to color regions (off by default) — stops dither error from bleeding across color boundaries. The cell graph is split into color regions and each is dithered in isolation, so a gray area's error can't speckle an adjacent solid black or white area. Smooth gradients still diffuse normally; only sharp color jumps act as barriers. Works with every dither mode. The Region barrier (delta E) slider sets how different neighboring colors must be to count as a barrier.
The Dither panel selects how each voxel's pre-dither color is mapped onto a palette color. Different modes trade global accuracy ("drift": does the average output color match the average input?) against local pattern ("wander": how far from the nearest-input palette do picks reach?).
The dropdown offers:
- Riemersma — walks voxels along a locally-coherent tour and diffuses each cell's quantization error into a sliding window of recent cells. Preserves average color exactly (zero drift) and avoids the scanline directionality of Floyd-Steinberg.
- Riemersma pair — like Riemersma but scores each voxel jointly with its
tour-neighbour and prefers picks whose residuals cancel. On a flat-gray
area with a black/white palette this prefers
(black, white)instead of the long(black, black, white, white, …)kick the single-cell version produces. Same drift as Riemersma; lower wander on flat/textured regions; slightly noisier on detailed near-palette images. - Blue noise — picks the smallest palette simplex (pair, triangle, or full) that brackets each cell's input within a tolerance, then chooses among its vertices via a low-discrepancy sequence. Bounds wander tightly on uniform regions at the cost of a small global drift.
- Dizzy — randomized error-diffusion (Liam Appelbe's blue-noise dizzy, iterated three times with drift correction). Blue-noise look with no directional structure on flat areas.
- Floyd-Steinberg (default) — deterministic scanline order. Preserves average chroma exactly, but produces visible directional structure on flat areas.
- none — no dithering; each cell snaps to the nearest palette color.
When Riemersma or Riemersma pair is selected, an Alpha slider appears (0..1, default 0.85). It's the per-cell input-bias maximum: pulls each cell's pick toward its nearest-input palette when the cell is close to a palette color. 0 = pure error-diffusion (zero drift but black/white oscillation around near-grey input). Higher values suppress that oscillation; ≥0.9 starts to posterize textured surfaces.
When Blue noise is selected, a Tolerance slider appears (default 20, in 8-bit RGB units). Smaller (≈5–10) forces the dither to bracket each input with more palette colors (lower drift, wider color spread on near- flat regions). Larger (≈20–40) sticks to 2-color pairs (tighter wander bounds, small per-cell drift).
The Split panel cuts the model along an axis-aligned plane into two halves that print separately and assemble back into the original. Both halves are laid out side by side on the build plate, sitting flat on the cut face. Use this when the model is taller than your build volume, when supports for an overhang would otherwise be hard to remove, or when you want to paint each half before assembly.
To split a model:
- Open the Split panel and check Split into two parts. Alpha-wrap is forced on automatically — a clean cut needs a watertight input mesh.
- Choose the Cut plane (XY, XZ, or YZ) and the Offset along that axis. The 3D viewer overlays a translucent quad showing the live cut position.
- Optionally tilt the cut off-axis with the two Tilt about … angles (±85° each). Both at 0° gives a flat axis-aligned cut; combine the two for a fully oblique plane.
- Pick a Connector style:
- Pegs — a solid peg on one half mates with a matching pocket on the other. Best for FDM where dowel hardware isn't on hand. Two peg options choose which half carries the male pegs.
- Dowel/magnet holes — matching pockets on both halves; print or buy dowel pins, or glue in magnets for a magnetic catch.
- None — flat cut, glue-only assembly.
- Adjust Count (number of connectors along the cut; Auto picks 1, 2, or 3 based on the cut polygon's inscribed-circle radius), Diameter, Depth, Clearance (per-side radial gap on the female feature so the peg slides in), and Bed gap (space between the two halves on the plate) as needed.
- Choose how each half rests on the bed with the per-half orientation dropdowns. Cut face down/up rests the half on its seam (the default, and it stays flat even when the cut is tilted); the ±axis up options rest the half on a model side instead.
- Export the result with File > Export 3MF as usual. The exported file contains two build items, one per half, that the slicer treats as independent objects.
The freshly exposed cut face is hidden once the halves are reassembled, so DitherForge fills it (and any connector pockets) with a single flat filament — the nearest palette color to the cut's average — instead of wasting print time dithering a surface no one sees. Only a thin rim at the visible perimeter seam keeps its dithered detail. This is automatic; there is no toggle.
Stickers, color pins, and base color are applied to the original (unsplit) mesh, so they survive the cut and appear on whichever half they land on. Split panel state is saved and restored with the JSON settings file.
If you turn off Alpha-wrap while Split is enabled, Split is automatically disabled as well. A toast explains the dependency.
Use File > New to reset every setting to its factory default — palette, color pins, adjustments, dither mode, split, the lot. Useful when starting fresh on a new model without manually undoing the previous session's configuration. Anything missing from a settings file you load is treated the same way: it falls back to its factory default rather than carrying over from the previously loaded settings.
Use File > Save JSON to save all current settings — palette, color pins, adjustments, size, and nozzle settings — to a JSON file.
Use File > Save JSON As... to save to a new file.
Use File > Open JSON… and select a .json file to restore all settings and
re-open the associated model. Recently loaded settings files are listed under
File > Open Recent JSON. (To swap only the model without touching other
settings, use the File dropdown in the Model section instead.)
Settings files are automatically associated with the input model. When you open a model, DitherForge suggests a default settings path based on the model's filename.
Use File > Export 3MF... after the pipeline finishes (the output preview is visible). The exported file includes per-face material assignments compatible with OrcaSlicer and BambuStudio.
File > Export 3MF is disabled until the pipeline produces a valid output.
- Load — reads a GLB, 3MF, STL, OBJ, or COLLADA file and scales it to millimeters. The model bottom is normalized to Z = 0. For files with multiple objects, the selected object (or all objects) is processed. The geometry mesh is then decimated to voxel resolution with QEM mesh decimation — detail finer than the voxel grid won't survive voxelization, so discarding it here keeps the downstream stages fast. The pristine mesh is kept separately for color sampling, so textures and per-face colors stay at full resolution.
- Stickers — maps each sticker image onto the mesh. "Projection" mode (the default) projects the image along the sticker normal onto the frontmost surface; "Unfold" mode flood-fills from the placement point across mesh adjacency. Sticker colors are alpha-composited over the base texture.
- Split (optional) — cuts the geometry mesh along the configured plane
(axis-aligned or tilted) using CGAL's
Polygon_mesh_processing::clip, bakes peg or dowel connectors into the cut faces via boolean ops, and lays the two halves side by side on the build plate. The hidden cut face is flat-filled with a single filament (only the visible perimeter rim keeps its dither). Color sampling stays in the original mesh's coordinate frame, so stickers, color pins, and base color survive the cut unchanged. - Voxelize — maps the model onto a grid of cells matching the nozzle and
layer settings. Each cell gets the color sampled from the original texture
(including any stickers). First-layer cells are wider (
nozzle × 1.275); upper cells are narrower (nozzle × 1.05). - Color adjust — applies brightness, contrast, and saturation.
- Color warp — applies color pin remappings using Gaussian RBF interpolation in CIELAB color space.
- Palette — resolves locked colors, then selects auto colors from the active collection. Applies color snap to shift cell colors toward the palette.
- Dither — assigns a palette color to each cell to approximate the original
texture. The default
floyd-steinbergmode assigns palette colors in a deterministic scanline order, preserving average chroma exactly. Five other modes are available —riemersma,riemersma-pair,blue-noise,dizzy-corrected, andnone— each with different drift/wander/structure trade-offs. See How to Choose a Dither Mode. - Clip — cuts the decimated mesh along voxel color boundaries and assigns each fragment a palette color.
- Merge — merges coplanar triangles to reduce face count.
- Export — writes a 3MF file with per-face material assignments. When
Split is enabled, two
<object>entries are emitted (one per half) so slicers see them as independent build items.
If Alpha-wrap is enabled (Advanced section), it runs inside the Load stage to produce a watertight shell of the input mesh — the load-time decimation feeds it a mesh already pruned to voxel resolution. Split also forces alpha-wrap on, since the cut needs a watertight input.
Each stage is cached by its settings hash. Changing a downstream parameter (e.g., dithering mode) skips all upstream stages on the next run. The stage caches persist across app restarts on disk (zstd-compressed), so re-opening a recent model is much faster than the first time — in particular the Load cache, which now subsumes both decimation and alpha-wrap, the slowest upstream work.
While the pipeline runs, the output stage list shows live progress for each stage along with cache hit/miss status. If a stage fails, the error message appears as a final line in the list.
ditherforge-cli runs the same pipeline from the command line, without a GUI
window. It is driven by a DitherForge settings .json file — the same
format the GUI saves and loads. Every processing option (input model, size,
palette, inventory, dither mode, base color, stickers, color pins, splitting,
…) lives in that file, so the GUI and CLI always produce identical output from
the same settings.
ditherforge-cli settings.json
Set up the model and options in the GUI, save the settings file, then point the
CLI at it. The input model is taken from the settings file's inputFile field;
its path is resolved relative to the .json. The output is written next to the
current directory as <model>.3mf unless --output is given.
Inputs may be .glb, .3mf, .stl, .obj, or .dae (COLLADA) — plus an OBJ
or COLLADA model packaged in a .zip with its .mtl/textures.
The CLI has only the handful of flags that are not processing options (those all come from the JSON):
| Flag | Default | Description |
|---|---|---|
<settings.json> |
— | Required. DitherForge settings file holding the input path and all processing options. |
--output |
derived from the model name | Output .3mf file path |
--force |
— | Bypass the 300 mm extent size check |
--debug-render DIR |
— | Write PNG renders (input + dithered + sampled, four views each) into DIR |
--debug-render-res |
800 |
Square PNG resolution for --debug-render |
--debug-cells-dir DIR |
— | After voxelization, write per-slab cell PNGs colored by sampled RGB into DIR |
The inventory collection named in the settings file is resolved from the same
built-in and user collections the GUI uses (e.g. Inventory, Panchroma Basic). User collections live in ~/.config/ditherforge/collections/.
Requires Go 1.24+, Node.js 20.19+ (or 22.12+), and the Wails CLI.
Install Wails:
go install github.com/wailsapp/wails/v2/cmd/wails@latest
Build both binaries:
git clone https://github.com/rtwfroody/ditherforge.git
cd ditherforge
./build.sh
This produces:
build/bin/ditherforge— desktop GUIditherforge-cli— CLI tool
For development with hot reload:
wails dev
go test -timeout 10m ./...
These models work well with DitherForge and are free to download:
| Model | Author | Source | License | Notes |
|---|---|---|---|---|
| Golden Pheasant | iRahulRajput | Sketchfab | CC BY 4.0 | |
| Colorful Fish | Kamilla Kraus | Fab | CC BY 4.0 | Enable alpha wrap to clean up the model's mesh. |
On surfaces that curve sharply or wrap back on themselves (e.g. the outside of a bowl, the rim of a cup) an unfold-mode sticker can come out stretched horizontally or repeated several times across the model instead of appearing once at the placement. This is why projection is the default mode; switch to unfold only on developable patches like cylinders or gentle curves where wrapping around the surface matters.
| Setting | Default | Description |
|---|---|---|
| Model file | none | The 3D model to convert, picked from the File dropdown at the top of the Model section (Browse for file… or Recent). Changing it swaps only the model — all other settings, stickers, and color pins are kept. |
| Printer | Snapmaker U1 | Target printer profile. Restricts which nozzle and layer-height values are selectable, and determines which printer/process settings are embedded in the exported 3MF. |
| Size (mm) | 100 | Scale the model so its largest extent equals this value in mm |
| Scale | 1.0 | Relative scale multiplier |
| Nozzle diameter | 0.4 mm | Controls voxel cell width. First layer: nozzle × 1.275. Upper layers: nozzle × 1.05. |
| Layer height | 0.20 mm | Controls voxel cell height |
| Object | All objects | For multi-object 3MF/GLB files, selects which object(s) to process |
| Base color | white | Color used for mesh faces that lack texture or vertex color |
| Setting | Range | Default | Description |
|---|---|---|---|
| Brightness | -100 to +100 | 0 | Shifts all colors lighter or darker before palette selection |
| Contrast | -100 to +100 | 0 | Increases or reduces the tonal range |
| Saturation | -100 to +100 | 0 | Increases or reduces color intensity |
Stickers composite PNG or JPEG images onto the model surface before voxelization.
| Field | Description |
|---|---|
| Image | PNG or JPEG file to use as the sticker |
| Placement | Set by clicking a point on the input model. A floating billboard preview follows the cursor during placement. |
| Scale | Size of the sticker on the surface, in mm |
| Rotation | Rotation of the sticker around the surface normal (0–360°) |
| Mode | Projection (default) projects the image along the normal onto the nearest front-facing surface. Unfold flood-fills across mesh adjacency, wrapping around curves. |
| Surface bend limit | (Unfold mode only.) Stops flood-fill where adjacent faces exceed this angle. 0 = no limit. |
Multiple stickers can be added. They are applied in order and composited over the base model color. Sticker colors are subject to the same brightness, contrast, and saturation adjustments as the rest of the model.
Stickers are saved as part of the JSON settings file.
Cuts the model along an axis-aligned plane into two halves laid out side by side on the build plate. Optional connectors register the halves during glue-up.
| Field | Default | Description |
|---|---|---|
| Split into two parts | off | Master toggle. When off, the rest of the section is hidden and the pipeline behaves as if Split didn't exist. Forces Alpha-wrap on; turning Alpha-wrap off auto-disables Split. |
| Cut plane | XY | Axis-aligned plane: XY (cut along Z), XZ (cut along Y), or YZ (cut along X). |
| Offset (mm) | bbox mid | Position of the cut plane along the chosen axis, measured from the model's local origin. Adjustable via number field or slider. |
| Tilt about … (°) | 0 | Two angles (±85° each) that tilt the cut off the chosen axis. Both 0° = flat axis-aligned cut; combine for a fully oblique plane. |
| Connector style | Pegs | Pegs (built-in male/female; two options choose which half carries the pegs), Dowel/magnet holes (matching pockets for separate dowel pins or glued-in magnets), or None (flat cut). |
| Count | Auto | Number of connectors. Auto picks 1, 2, or 3 based on the cut polygon's inscribed-circle radius. |
| Diameter (mm) | 3.0 | Connector diameter. Hidden when style is None. |
| Depth (mm) | 2.0 | Connector depth (per side for dowels/magnets). Hidden when style is None. |
| Clearance (mm) | 0.15 | Per-side clearance applied to the female feature, both radially (pocket diameter) and axially (pocket depth). |
| Half orientation | Cut face down/up | Per half, how it rests on the bed. Cut face down/up rests on the seam (stays flat even when tilted); ±axis up rests on a model side. |
While the Split panel is open, a translucent overlay in the 3D viewer shows the live cut plane through the input model.
Each pin maps a source color to a target filament color using Gaussian RBF interpolation in CIELAB color space.
| Field | Description |
|---|---|
| Source color | Color in the model to remap. Enter as #RRGGBB or use the eyedropper to sample from the input viewer. |
| Target color | Filament color to map toward. Selected from a filament collection. |
| Reach (sigma) | Gaussian falloff in delta E units (1–100, default 5). Controls how broadly similar colors are also shifted. |
Up to 8 pins. Invalid pins (missing source or target hex) are silently ignored.
| Feature | Description |
|---|---|
| Color slots | 1–16 slots. Each slot is locked (specific filament) or unlocked (auto-selected from collection). |
| Lock / unlock | Click the lock icon on a swatch to toggle. Auto-selected colors are shown with a dashed border. |
| Collection picker | Click a slot swatch to open the filament picker and lock that slot to a color. |
| Unlocked colors from | The filament collection used to fill unlocked slots. |
Shifts each voxel's color toward its nearest palette color by up to the configured delta E distance before dithering. Reduces noise in nearly solid-color regions.
| Setting | Range | Default | Description |
|---|---|---|---|
| Color snap | 0–50 delta E | 5 | Pre-dither snap distance. Set to 0 to disable. |
| Feature | Description |
|---|---|
| Built-in collection | "Panchroma Basic" — 28 colors, read-only |
| Custom collections | Created via Filaments > New... or Filaments > Import... |
| Import format | Plain text, one color per line: #RRGGBB Label |
| Editing | Click a swatch in the collection editor to change its hex value or label |
| Operation | Menu item | Behavior |
|---|---|---|
| Save | File > Save JSON | Saves to current path; prompts for path if unsaved |
| Save to new file | File > Save JSON As... | Always prompts for a file path |
| Load | File > Open JSON… | Opening a .json file restores all settings and re-opens the model |
| Recent | File > Open Recent JSON | Lists recently loaded settings files |
Saved settings include: input file path, size/scale, nozzle diameter, layer height, palette (locked colors and collection), color adjustments, color pins, stickers, dither mode, color snap, split configuration, and advanced flags.
These options are in the Advanced section of the settings panel (collapsed by default).
| Option | Default | Description |
|---|---|---|
| No merge | off | Disables coplanar triangle merging in the final mesh |
| No simplify | off | Disables the load-time QEM mesh decimation |
| Color-aware cells | on | Tiles each layer per color region so cell boundaries land on color boundaries (crisp edges). See How to Keep Color Edges Crisp. |
| Color contrast (delta E) | 20 | (Color-aware cells.) Minimum CIELAB color difference for a boundary to be cut into a cell edge. |
| Confine dither to color regions | off | Dithers each color region in isolation so error can't bleed across sharp color boundaries. See How to Keep Color Edges Crisp. |
| Region barrier (delta E) | 20 | (Confine dither.) Minimum CIELAB color difference for a cell boundary to act as a dither-error barrier. |
| Alpha-wrap | off | Wraps the input mesh with a watertight shell (CGAL Alpha-wrap) to fix self-intersections, thin walls, and other geometry that slicers choke on. Can be slow on large models. |
| Alpha (mm) | nozzle diameter | Alpha-wrap probe radius. Larger = smoother wrap that bridges gaps but loses detail; smaller = hugs the surface more tightly. |
| Offset (mm) | alpha / 30 | How far the wrap sits above the input surface. Larger values shrink-wrap less tightly. |
| Stats | off | Logs face counts per material to the status bar |
Ready for use. The output 3MF includes embedded printer/process profiles for the Snapmaker U1, Snapmaker J1, Prusa XL (2 tools), Prusa XL (5 tools), Bambu Lab H2D, and Bambu Lab H2D Pro across their supported nozzle and layer-height combinations. Only the Snapmaker U1 path has been tested end-to-end on real hardware; the other profiles are wired up but unverified, and may need manual adjustment in the slicer.