网格基元 (Mesh Primitive) · 截图待补
这个节点是做什么的
Mesh Primitive 是 ComfyTV 3D 几何工坊的起点。选一个形状,它就从一份 three.js 几何配方(尺寸、半径、分段数、弧/扫掠角)构建出一个崭新、结构良好的网格。结果是一个COMFYTV_MODEL(GLB),可直接接入 Mesh Ops、Mesh Boolean、Mesh Bake Maps 或 Line Art。
卡片上会实时预览你选择的形状。你无需接触原始配方——节点体会为选定的 kind 自动填好,预览则写出一张快照作为 image 输出。这是一个由后端快速生成的阶段(运行内置的 mesh3d 构建器),并非 GPU 模型推理。
输出是 ComfyTV 快照,而非原生张量——要接原生 ComfyUI 节点需插入 Bridge(Bridge 文档)。
适用场景
- 任何 3D 建模从基元开始,而不必从磁盘加载模型。
- 制作一个布尔工具——例如用圆柱打孔、用立方体开槽——接入 Mesh Boolean。
- 在拿到最终资产之前,快速做一个基础形状(球、圆环)来测试 Line Art 的取景或烘焙。
参数
kind
要构建的基元。取值为cube、sphere、cylinder、cone、plane、torus 之一(默认 cube)。切换 kind 会重塑配方与实时预览。
recipe
内部(隐藏)。选定kind 的 three.js geometry.parameters JSON——width、radiusTop、phiLength、arc 等。由节点体从卡片填入,你无需手动编辑。下游 op 会根据这份配方生成实际网格。
captured_image
内部(隐藏)。3D 预览快照的/view? URL,由节点体中的预览写入。它会成为 image 输出,方便你在下游看到网格。
输出
使用技巧
- 网格是全新且干净地生成的,因此在 Mesh Ops 里焊接和展开都可预测——好习惯是基元 → op,而不是导入杂乱的几何体。
- 配方里更高的分段数会让球/圆柱更平滑,但面数更多;如需精确面数预算,之后在 Mesh Ops 里 decimate。
相关节点
- Mesh Ops(网格操作) — 对基元 decimate、remesh、weld、subdivide、unwrap、smooth 或 export。
- Mesh Boolean(网格布尔) — 用 union / difference / intersect 合并两个网格。
- Line Art(线稿) — 把网格渲染成线稿图。