ComfyUI Node
Atlas Retopologize Layer 🔷
A ComfyUI node in Atlas/05 · Geometry with 10 inputs and 2 outputs.
Atlas Retopologize Layer 🔷
- solve
- solve
- report
◄layer►
◄methoddecimate►
◄target_vertex_count2000►
◄smooth_iterations0►
◄crease_angle30.00►
◄pure_quadfalse►
◄boundary_smooth_iterations0►
◄rebuild_transition_ribbontrue►
◄merge_volume_primitivesfalse►
CategoryAtlas/05 · Geometry
Inputs (10)
| Name | Type | Default | Description |
|---|---|---|---|
| solve | ATLAS_SOLVE | — | |
| layeropt | STRING | Which mesh to retopologize: blank = the primary scene relief mesh; a layer name (AtlasCleanPlateLayer `name`, e.g. 'bg') = that projection source only; '*' = every relief mesh. | |
| methodopt | COMBO | decimate | quad = Instant Meshes quad remesh (pyinstantmeshes); decimate = quadric decimation (trimesh + fast-simplification); smooth = trimesh Taubin relax (topology unchanged, UVs preserved); voxel_remesh = watertight voxelize + surface nets (closes every interior tear; loses open-boundary silhouettes). Same passes as the Maya/Nuke layer exporters, applied LIVE with the layer's own camera regenerating projection UVs. |
| target_vertex_countopt | INT | 2000100–200000 | Vertex budget for quad/decimate (ignored by smooth). |
| smooth_iterationsopt | INT | 00–50 | Taubin iterations (smooth method, and post-smooth for quad). |
| crease_angleopt | FLOAT | 30.000–90 | Quad remesh crease preservation angle (degrees). |
| pure_quadopt | BOOLEAN | false | Quad remesh: force pure quads (else quad-dominant). |
| boundary_smooth_iterationsopt | INT | 00–50 | Taubin-relax every open boundary loop this many iterations AFTER the retopo pass — rounds the lattice-staircase jaggies on the silhouette without shrinking it or touching interior detail. Moved vertices get their projection UVs regenerated with THIS layer's camera, so 📽 Project stays aligned; if the layer camera has no usable intrinsics the pass is SKIPPED (and said so in the report) rather than leaving UVs stale. 0 = off. Migrated from AtlasLiveMeshRepair's smooth_boundary. |
| rebuild_transition_ribbonopt | BOOLEAN | true | Re-derive the transition ribbon on the NEW rim after retopologizing. A skirt is generated from wherever the silhouette is, so a remesh invalidates it - and feeding it INTO the remesh is worse, because it welds the two sheets the tear exists to keep apart and moves the rim out from under the skirt (seen live as detached slabs with hard opaque rims). The skirt is therefore always stripped first; this rebuilds it. Settings are replayed from the ones the relief-mesh node recorded, so nothing is invented. The background PROBE cannot run here (no depth map), so every column uses the tear-margin fallback - which measured 94-100% of columns anyway. Off = leave the mesh torn and skirtless. |
| merge_volume_primitivesopt | BOOLEAN | false | Fold solid volume primitives (AtlasBlockoutMassing boxes, proxy cylinders) into ONE mesh layer BEFORE retopologizing. Massing emits one primitive per building - 97 on a city plate - and the headless rasteriser loops per mesh, so a merge is both a large speedup and the thing that lets retopo touch massing at all (every method here operates on serialized MESHES). The merged layer keeps provenance=placeholder and the placeholder trust tier: merging is a topology operation, and no topology operation may promote a guess to a measurement. Off = massing boxes pass through untouched. |
Outputs (2)
| Name | Type | Description |
|---|---|---|
| solve | ATLAS_SOLVE | — |
| report | STRING | — |