> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.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`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.