Repository navigation
v0.6.2 — the print release
The print release: AI 3D models come out as one solid, printable STL in millimetres, and every finished STL is checked before it reaches a slicer.
Before you upgrade
- For 3D printing, install the new extra:
pip install -e ".[print]"(numpy, scipy, scikit-image). Everything else works without it;chimera doctorsays whether it's there. --mode finishSTLs are now in millimetres. A--scale-mmmodel, or any GLB/FBX, used to load 1000× too small in a slicer. If you've been scaling those up by 1000 in the slicer, stop. An unscaled STL/OBJ input, such as a FreeCAD part, keeps its own numbers.
render --mode finish --solid
TRELLIS.2 and Pixal3D don't output solids. Each mesh is a paper-thin, double-sided sheet with layers stacked inside (a shirt over the body), so the body is an empty cavity, and --watertight sealed that into a hollow shell. --solid (with --scale-mm) rebuilds it as one solid:
chimera render --mode finish --from figure.glb --solid --scale-mm 228.6 --formats stl,glb- Blender writes the mesh as a raw STL in mm at the print size, seams welded and small holes capped.
- The host finds the outside (closing leaks, with the radius picked from the jump in solid volume when the body cavity seals), keeps only the outer skin, and rebuilds one surface from it with an FFT Poisson solve.
- The finish keeps the largest piece and repairs decimation pinches.
It runs on the CPU: about 3 minutes and a few GB of RAM for a 230 mm figure. On an RTX 5090 box, a fresh TRELLIS.2 model at 200 mm went from HOLLOW (44 cm³ in 30 pieces, 6,478 open edges) to one 481 cm³ solid. Hunyuan3D 2.1 is already solid, so --watertight is still enough there.
STL print check
Every STL that --mode finish writes is checked for size in mm, closed and manifold edges, separate pieces, volume, and SOLID vs HOLLOW (rays cast through the model). The report prints in the console and goes into the sidecar as print_check; a HOLLOW result points you to --solid.
Fixes
- STL units, as above.
- The hero render after
--scale-mm. Scaling about the origin left the model floating, 0.39 m up for a GLB and 114 m up for a mm-scale mesh, away from the floor and the light rig: a dim or black render. The model now sits on the floor, centred, and the STL starts at z = 0.
Tips
- Judge a print with a low, raking light at full size; a shrunken overview hides surface defects.
- Generate 3D from images with a plain background, like a product shot. A busy scene behind the subject can come back as a plate behind the figure, which no clean-up removes.
Validated live on an RTX 5090 with Blender 5.2.2: --solid on four TRELLIS.2 and Hunyuan3D models, and the STL units for STL, --scale-mm and GLB inputs. 1230 GPU-free tests · ruff clean · CI on Linux and Windows.
Full details are in the CHANGELOG; every change since v0.6.1: v0.6.1...v0.6.2.
🤖 Generated with Claude Code