文档 /
节点说明 /
网格简化
网格简化
使用 QEM(二次误差度量)简化将 3D 网格简化到目标面数,并在当前计算设备上运行计算。
节点说明
DecimateMesh 更新于 2026-11-12
网格简化 - ComfyUI Built-in Node Documentation
使用 QEM(二次误差度量)简化将 3D 网格简化到目标面数,并在当前计算设备上运行计算。
使用 QEM(二次误差度量)简化将 3D 网格简化到目标面数,并在当前计算设备上运行计算。"midpoint" 放置模式是 cumesh 忠实预设,可在保留头发等细薄特征的同时提供最佳质量,而 "qem" 则将顶点放置在 QEM 最优位置,并可选地提供线和特征边控制。输出网格保持焊接。
输入
通用输入
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
|---|---|---|---|---|
mesh | 要简化的 3D 网格。 | MESH | 是 | - |
target_face_count | 目标最大面数。0 表示禁用。(默认值:200000) | INT | 是 | 0 到 50000000 |
placement_mode | midpoint:cumesh 忠实(推荐)。qem:QEM 最优放置。(默认值:"midpoint") | DYNAMIC\_COMBO | 是 | "midpoint" "qem" |
Midpoint 输入
"midpoint" 放置模式不暴露额外的子参数;它使用默认的 midpoint 放置预设。
QEM 输入
以下子参数仅当 placement_mode 设置为 "qem" 时才会出现在界面中。
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
|---|---|---|---|---|
line_quadric_weight | 逐边线二次权重;保留尖锐的山脊/山谷。0 表示关闭。(默认值:0.0) | FLOAT | 否 | 0.0 到 100.0 |
feature_edge_quadric_weight | 在二面角特征边(折痕)上的额外二次权重。0 表示关闭。(默认值:0.0) | FLOAT | 否 | 0.0 到 1000.0 |
feature_edge_min_dihedral_deg | 将边视为特征边的最小二面角(度)。(默认值:30.0) | FLOAT | 否 | 0.0 到 180.0 |
clamp_v_to_edge | 将 QEM 最优位置投影到塌缩的边线段上。(默认值:true) | BOOLEAN | 否 | true false |
注意:当 target_face_count 为 0,或网格的面数已经不超过目标值时,将跳过简化。该节点会在自身上显示面数减少摘要,例如 faces: 1.23M → 200K (-84%)。
输出
| 输出名称 | 描述 | 数据类型 |
|---|---|---|
mesh | 面数减少后的简化网格;连接性保持焊接。 | MESH |
本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! 在 GitHub 上编辑
Source fingerprint (SHA-256): 55336e5b52e27d940e5402ecd74fd0ac847a1c6acd35955eccf72aab8ed940f9