Kromacut v2.6.0

Installation

macOS:

1. Download the .dmg file for your Mac:
   • Apple Silicon (M1/M2/M3): *_aarch64.dmg
   • Intel: *_x86_64.dmg
2. Open the DMG and drag Kromacut to Applications
3. Remove quarantine (required for unsigned apps):
   sudo xattr -d com.apple.quarantine /Applications/Kromacut.app
4. Launch from Applications

Windows:

1. Download the -setup.exe installer.
2. Run the installer and follow the prompts. The standard Windows installer includes the Microsoft Edge WebView2 bootstrapper, but requires internet access if WebView2 needs to be installed or updated.
3. For offline Windows machines, download the *_offline-setup.exe installer instead.
4. Launch Kromacut from the Start menu

Linux:

1. Download the .AppImage or .deb file
2. For AppImage: chmod +x Kromacut*.AppImage && ./Kromacut*.AppImage
3. For Debian/Ubuntu: sudo dpkg -i kromacut*.deb

What's Changed

Added

• Meshing integrity tests - Added unit coverage for greedy and smooth mesh generation, including the default logo image, manifold edge checks, winding/orientation checks, degenerate triangle checks, and multiple layer settings
• Image fixture meshing coverage - Added dedicated test fixtures for the 1024px logo source and a large GitHub issue JPEG, covering meshing and 3MF export topology with real image-derived masks
• 3MF layer-count export tests - Added fixture-backed regression tests using saved .kapp filament profiles to verify generated layers, 3MF mesh objects, assembly references, build items, and slicer metadata parts stay in sync
• 3MF filament color export tests - Added regression coverage that verifies exported base materials, project filament settings, mesh material indices, and slicer extruder metadata match the physical filament colors without missing colors or color-count explosions
• Final export manifold tests - Added 3MF and STL topology checks across both image fixtures, all saved filament profiles, both greedy and smooth meshers, and an 8-color auto-paint logo regression to catch boundary edges, non-manifold edges, and inverted normals after export serialization
• Progress regression tests - Added coverage for quantize, dedither, 3D model build, large-mesh 3MF/STL export, and image algorithm progress callbacks so progress percentages advance through their real work stages without going backwards
• Browser export flow tests - Added Playwright coverage for the normal image-to-print flow across quantization, dedither, auto-paint profiles, 3D mesh builds, STL downloads, 3MF downloads, export timing, browser memory samples, STL triangle counts, compact heightfield quad breakdowns, strict preview port handling, and auto-paint worker settling
• Layer preview filament bar - Added physical filament color segments, swap hover details, and a lower trim handle to the 3D layer preview bar

Changed

• 3D preview lighting - Reworked the 3D view shading to use flat face normals with balanced directional fill lighting, reducing fake shadow bands on flat meshed surfaces while keeping model depth and saturated filament colors readable
• Export memory shape - STL export now writes chunked binary parts instead of one huge contiguous buffer, and 3MF export now uses flat coordinate storage, typed triangle chunks, and chunked XML joins to reduce peak browser memory during large exports
• STL export size - Browser-generated STL exports now reuse Kromacut layer-mask metadata to write an exact fused heightfield surface where possible, avoiding internal layer faces while preserving a manifold printable shell
• 3MF package size - 3MF exports now use DEFLATE compression to reduce generated archive size
• Progress overlays - Long-running progress cards now show elapsed time, estimated time remaining, current step labels, and step counts in a more polished layout
• Agent guidance - Refocused AGENTS.md on Kromacut-specific domain rules, topology/export caveats, persistence boundaries, testing guidance, and when agents should update the changelog

Fixed

• Slicer-safe 3MF and meshing topology - 3MF export now preserves shared vertex connectivity for non-indexed preview geometry while keeping separate colored layer objects, and greedy/smooth meshing now avoids degenerate cap triangles and inverted hole wall winding that could trigger non-manifold or missing-layer slicer warnings
• Auto-paint smooth 3MF topology - 3MF export now welds raw Kromacut export vertices at serialized precision, smooth meshing rejects cap triangles that collapse during 3MF coordinate rounding, and fallback meshing bridges diagonal-only pixel contacts, preventing non-manifold edges in the 8-color logo regression
• Desktop large-file saves - Native STL/3MF/PNG saves now stream blob data to disk in chunks instead of sending one huge array through Tauri IPC, avoiding large-export RangeError: Invalid array length failures on Windows
• Smooth meshing footprint safety - Smooth corner cuts and simplification shortcuts now stay inside the source pixel footprint without running support-repair or clipping passes during smooth layer generation
• 3MF smooth layer packaging - Smooth layers now export as one manifold mesh object per non-empty color layer, and auto-paint exports use the intended physical filament colors instead of the preview's virtual blend colors
• Smooth mesh build progress - 3D build progress now stays monotonic while smooth layers are generated
• 3MF export progress - 3MF export progress now reports explicit geometry collection, vertex writing, triangle writing, and zip compression phases instead of reusing an earlier percentage range
• 2D processing progress - Quantize and dedither progress bars now display their staged producer progress directly instead of masking backwards updates in the app shell
• Auto-paint worker cancellation - Auto-paint now cancels stale worker requests, surfaces worker errors, and prevents accidental exhaustive optimization above its safe filament count instead of leaving the 3D build button stuck on Computing...
• Progress bar fill accuracy - Determinate progress bars now update without width-transition lag, keeping the blue fill aligned with the displayed percentage during dedither, export, and mesh generation
• Print setting decimal inputs - Pixel size, layer height, and first-layer height fields now allow partial decimal edits like 0 and 0. before committing or clamping to valid print settings
• Progress step feedback - Long-running overlays now show separate overall and current-step progress bars across quantization, dedither passes, mesh generation, STL export, and 3MF export; exports also give the browser a frame to render the overlay before heavy work starts and keep very fast exports visible briefly
• Compact STL topology - Fused heightfield STL exports now triangulate conforming surface boundaries and repair diagonal corner contacts, preventing non-manifold edges in large 4-color image stacks
• Layer preview exports - STL and 3MF exports now include every generated physical layer regardless of the 3D preview trim range, preserving complete models and correct filament color mapping