# Remesh Mesh (Narrow-Band DC)

Remesh Mesh rebuilds a mesh with a clean, uniform tessellation by sampling a narrow-band distance field around the original surface and extracting it with Dual Contouring. This normalizes messy, non-manifold, or self-intersecting topology, and is meant to be run before Decimate Mesh to reach an exact face count. Processing runs on the active compute device and the output mesh stays welded.

## Inputs

### Common Inputs

| Parameter | Description | Data Type | Required | Range |
|-----------|-------------|-----------|----------|-------|
| `mesh` | The input mesh to remesh. | MESH | Yes | — |
| `resolution` | Voxel grid resolution (output density). 256 ~ 100k faces, 512 ~ 1M. For an exact face count, follow with Decimate Mesh. (default: 512) | INT | Yes | 32 - 2048 |
| `sign_mode` | Surface extraction mode. "udf" is robust to messy/non-manifold input; "sdf" produces a clean single surface with QEF (Quadratic Error Function) sharp-feature recovery, but needs consistent winding. "solid" builds one watertight solid from messy input: a global inside/outside graph cut (CelloCut) removes double shells and closes small holes. Slower. Selecting a mode reveals its specific sub-options. (default: "udf") | DYNAMIC_COMBO | Yes | "udf"<br>"sdf"<br>"solid" |
| `band` | Narrow-band width in voxel units. In UDF mode also offsets the surface. In solid mode it is the closing radius: creases are filleted and gaps bridged at this size, the surface sits half a voxel out. (advanced, default: 1.0) | FLOAT | Yes | 0.5 - 4.0 |
| `project_back` | Linearly interpolate vertices toward the original surface (0 = pure DC, 1 = snapped). (advanced, default: 0.0) | FLOAT | Yes | 0.0 - 1.0 |
| `fix_poles` | Collapse valence-3 vertex pairs (DC T-junction artifact). (advanced, default: false) | BOOLEAN | Yes | true / false |
| `smooth_iters` | Taubin smoothing iterations (0 = off). 2-3 cleans DC staircase-like artifacts; higher over-smooth QEF edges. (default: 0) | INT | Yes | 0 - 20 |
| `drop_small_components` | Drop components below this fraction of the largest's face count. 0 disables. (advanced, default: 0.01) | FLOAT | Yes | 0.0 - 0.5 |
| `precluster_max_verts` | Cap input vertex count before the field queries; inputs above this are cluster-decimated to it first. Prevents OOM on huge meshes. (advanced, default: 20,000,000) | INT | Yes | 0 - 100,000,000 |

### "udf" Mode Inputs

These parameters appear when `sign_mode` is set to `"udf"`.

| Parameter | Description | Data Type | Required | Range |
|-----------|-------------|-----------|----------|-------|
| `qef` | QEF (Quadratic Error Function) vertex placement: sharp edges on hard-surface input, jagged creases on organic input. (advanced, default: false) | BOOLEAN | No | true / false |
| `drop_inverted_components` | Drop inward-normal (negative-volume) closed components — the UDF inner shell. (advanced, default: false) | BOOLEAN | No | true / false |
| `drop_enclosed_components` | Drop components inside the largest's bbox that fail a point-in-mesh raycast. Disable for legitimate nested parts. (advanced, default: false) | BOOLEAN | No | true / false |

### "sdf" Mode Inputs

These parameters appear when `sign_mode` is set to `"sdf"`.

| Parameter | Description | Data Type | Required | Range |
|-----------|-------------|-----------|----------|-------|
| `qef` | QEF (Quadratic Error Function) dual-vertex placement (recovers sharp features) vs edge-crossing centroid. (default: true) | BOOLEAN | No | true / false |
| `manifold` | Manifold Dual Contouring: 1-4 dual verts/voxel for multi-sheet cases. Slower. (default: false) | BOOLEAN | No | true / false |

### "solid" Mode Inputs

These parameters appear when `sign_mode` is set to `"solid"`.

| Parameter | Description | Data Type | Required | Range |
|-----------|-------------|-----------|----------|-------|
| `fill` | Cost of closing an opening relative to following the surface. Lower closes larger openings (0 puts a lid on a cup); higher only closes small holes and cracks. (default: 20.0) | FLOAT | No | 0.0 - 1000.0 |
| `qef` | QEF (Quadratic Error Function) vertex placement: sharp edges on hard-surface input, jagged creases on organic input. (advanced, default: false) | BOOLEAN | No | true / false |

Note: The `qef` option has a different default depending on the selected mode — false in "udf" and "solid" modes, true in "sdf" mode. When `precluster_max_verts` is greater than 0 and the input mesh has more vertices than this value, the mesh is cluster-decimated down to that target before the field queries. After processing, the node displays the input-to-output face count change on the node (for example, "faces: 1.23M → 200K (-84%)").

## Outputs

| Output Name | Description | Data Type |
|-------------|-------------|-----------|
| `mesh` | The remeshed mesh with uniform tessellation and welded topology. Vertex colors are preserved when present on the input; any UVs, normals, and tangents are not carried over. | MESH |

> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/RemeshMesh/en.md)

---
**Source fingerprint (SHA-256):** `d2869c681e0485f5946a53f0582188ded2183ecd741ea1ff6a591932b18b5abe`
