> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# RemeshMesh - ComfyUI Built-in Node Documentation

> Remesh Mesh 会围绕原始表面采样窄带距离场，并使用 Dual Contouring 提取，从而以干净、均匀的细分重建网格。

Remesh Mesh 会围绕原始表面采样窄带距离场，并使用 Dual Contouring 提取，从而以干净、均匀的细分重建网格。这可以规范化杂乱、非流形或自相交的拓扑，并且应在 Decimate Mesh 之前运行，以获得精确的面数。处理在活动计算设备上运行，输出网格保持焊接状态。

## 输入

### 通用输入

| 参数                      | 描述                                                                                                                        | 数据类型           | 必需 | 范围               |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------- | -- | ---------------- |
| `网格`                    | 要重新划分网格的输入网格。                                                                                                             | MESH           | 是  | —                |
| `分辨率`                   | 体素网格分辨率（输出密度）。256 约对应 10 万面，512 约对应 100 万面。若需要精确面数，请随后使用 Decimate Mesh。（默认：512）                                           | INT            | 是  | 32 - 2048        |
| `符号模式`                  | 表面提取模式。"udf" 对杂乱/非流形输入更稳健；"sdf" 通过 QEF（Quadratic Error Function，二次误差函数）锐边恢复生成干净的单层表面，但需要一致的绕序。选择某个模式后会显示其特定子选项。（默认："udf"） | DYNAMIC\_COMBO | 是  | "udf"<br />"sdf" |
| `带宽`                    | 窄带宽度，以体素为单位。在 UDF 模式下还会偏移表面。（高级，默认：1.0）                                                                                   | FLOAT          | 是  | 0.5 - 4.0        |
| `project_back`          | 将顶点朝原始表面线性插值（0 = 纯 DC，1 = 吸附到表面）。（高级，默认：0.0）                                                                              | FLOAT          | 是  | 0.0 - 1.0        |
| `fix_poles`             | 折叠价数为 3 的顶点对（DC T 形接缝伪影）。（高级，默认：false）                                                                                    | BOOLEAN        | 是  | true / false     |
| `smooth_iters`          | Taubin 平滑迭代次数（0 = 关闭）。2-3 可清理 DC 阶梯状伪影；更高值会过度平滑 QEF 边缘。（默认：0）                                                             | INT            | 是  | 0 - 20           |
| `drop_small_components` | 丢弃面数低于最大组件该比例的组件。0 表示禁用。（高级，默认：0.01）                                                                                      | FLOAT          | 是  | 0.0 - 0.5        |
| `precluster_max_verts`  | 在距离场查询前限制输入顶点数；超过此值的输入会先聚类简化到该值。防止巨大网格出现 OOM。（高级，默认：20,000,000）                                                           | INT            | 是  | 0 - 100,000,000  |

### "udf" 模式输入

当 `sign_mode` 设置为 `"udf"` 时，这些参数会出现。

| 参数                         | 描述                                                                    | 数据类型    | 必需 | 范围           |
| -------------------------- | --------------------------------------------------------------------- | ------- | -- | ------------ |
| `qef`                      | 使用 QEF（Quadratic Error Function，二次误差函数）对偶顶点放置，以获得更锐利的边缘。（高级，默认：false） | BOOLEAN | 否  | true / false |
| `drop_inverted_components` | 丢弃法线朝内（负体积）的封闭组件——UDF 内壳。（高级，默认：false）                                | BOOLEAN | 否  | true / false |
| `drop_enclosed_components` | 丢弃位于最大组件包围盒内、且未通过点在网格内射线检测的组件。对于合法的嵌套部件，请禁用此选项。（高级，默认：false）          | BOOLEAN | 否  | true / false |

### "sdf" 模式输入

当 `sign_mode` 设置为 `"sdf"` 时，这些参数会出现。

| 参数         | 描述                                                                        | 数据类型    | 必需 | 范围           |
| ---------- | ------------------------------------------------------------------------- | ------- | -- | ------------ |
| `qef`      | 使用 QEF（Quadratic Error Function，二次误差函数）对偶顶点放置（可恢复锐利特征），而不是边交叉质心。（默认：true） | BOOLEAN | 否  | true / false |
| `manifold` | 流形 Dual Contouring：针对多片层情况，每个体素使用 1-4 个对偶顶点。速度较慢。（默认：false）               | BOOLEAN | 否  | true / false |

注意：`qef` 选项的默认值因所选模式而异——在 `"udf"` 模式下为 false，在 `"sdf"` 模式下为 true。当 `precluster_max_verts` 大于 0 且输入网格的顶点数超过此值时，会在距离场查询前将网格聚类简化到该目标值。处理完成后，节点会显示输入到输出的面数变化（例如，"faces: 1.23M → 200K (-84%)"）。

## 输出

| 输出名称   | 描述                                                        | 数据类型 |
| ------ | --------------------------------------------------------- | ---- |
| `mesh` | 重新划分网格后的网格，具有均匀细分和焊接拓扑。如果输入中存在顶点颜色，则会保留；任何 UV、法线和切线都不会保留。 | MESH |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/RemeshMesh/zh.md)

***

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