Material Maker 的 sdRoundedShape 节点详解:用距离场减法实现形状圆角化

原创2026-10-11 09:27:081,420 阅读
文章标签:桌面应用图像处理3D建模图形学

Material Maker 的 sdRoundedShape 节点详解:用距离场减法实现形状圆角化

在 Material Maker 的 2D 有符号距离函数(SDF)节点体系中,sdRoundedShape 是一个极为常用且原理简洁的形状修饰算子:它接收任意一个以 SDF 描述的 2D 形状,通过从距离函数中减去一个常量,让形状沿外法线方向整体"膨胀"一圈,从而把尖锐的角部自然磨圆。本文将结合仓库中的节点定义(sdroundedshape.mmg)、SDF builder 的底层代码(round.gd)与库条目(base.json),完整讲解该节点的输入输出、参数语义、数学原理、实际接线流程与源码级实现,帮助你在自己的材质图里熟练使用"一键倒角"技巧。

sdRoundedShape 在 SDF 节点体系中的位置

Material Maker 的 2D SDF 节点遵循"少量基础形状 + 运算符组合 + sdShow 输出"的设计理念(见 node_simple_sdf.rst):先用 sdCircle、sdBox、sdPolygon、sdRoundedBox 等形状节点定义基本几何,再用 sdBoolean、sdSmoothBoolean、sdRoundedShape 等运算符对距离场做集合或修饰运算,最后通过 sdShow 节点把距离场渲染为灰度图像。sdRoundedShape 属于 Operators 分类中的"修饰类"算子,在节点库中的路径为 Simple/SDF/Operators/sdRoundedShape(注册信息见 base.json)。

原文档对它的定位是:

根据其输入,通过从距离函数中减去一个常数(即将其向外"生长")来生成一个圆角形状的有符号距离图像。

这意味着它不产生新几何,只对输入形状的距离场数值做整体平移,属于对任意形状通用的圆角/倒角操作——无论是多边形、星形、十字还是任意组合的布尔结果,只要它是一条合法的 2D SDF,都能被 sdRoundedShape 统一磨圆。

输入与输出:同为 sdf2d 数据类型

在 sdroundedshape.mmg 中,节点定义了 1 个输入、1 个输出:

端口 名称 类型 说明
输入 in sdf2d 输入形状,以有符号距离函数描述
输出 默认输出 sdf2d 圆角化后的形状距离函数
  • 输入 in 的类型是 sdf2d,默认值 0.0,可直接连接任何 2D SDF 形状节点或其他运算符(sdBoolean、sdMorph 等)的输出;
  • 输出同样是 sdf2d,因此 sdRoundedShape 可以级联——把圆角结果再喂给另一个 sdRoundedShape,或用 sdTranslate、sdRotate 等变换继续加工,或与其它形状做布尔运算;
  • 由于输出仍是距离场而非普通纹理,最终必须通过 sdShow 之类的节点渲染为灰度图才能直观看到结果(sdShow 的定义见 sdshow.mmg)。

节点的 shader_model 里输出表达式只有一行核心代码:

$in($uv)-$r

即"取输入形状在采样点处的距离值,减去圆角半径 r"。

唯一参数 r:圆角半径

sdRoundedShape 只有一个参数,原文档称之为"要从函数中减去的距离"。在 sdroundedshape.mmg 中完整定义如下:

参数 名称 类型 默认值 最小值 最大值 步长 说明
r Radius(半径) float 0.2 0.0 1.0 0.01 膨胀(倒角)操作的长度
  • r = 0:不产生任何变化,输出与输入完全一致;
  • r 增大:形状向外扩张的幅度增大,原本的尖角被半径约为 r 的圆弧替代,圆角越明显;
  • r 上限 1.0、步长 0.01:参数面板中以滑杆方式精细调节,默认 0.2 适合大多数中等圆角场景。

在 base.json 的节点库注册条目中,sdroundedshape 条目的默认参数同样记录为 "r": 0.2,与 mmg 文件保持一致。另外,仓库的别名表 aliases.json 中 Simple/SDF/Operators/sdRoundedShape 的别名是 smooth,说明它本质上等价于"平滑/倒角"语义,在库搜索框输入 smooth 也能定位到该节点。

数学原理:SDF 减常数 = 等距外扩

理解这个节点不需要复杂的图形学知识,只需抓住 SDF 的核心约定:距离场中某点的值 = 该点到形状表面的最短距离,负值在形状内部,0 在表面,正值在外部。

对距离函数执行 d(x) - r:

  • 原本在表面上的点(d = 0)现在得到 -r,落入内部;
  • 原本在外部、距离表面恰好 r 处的点(d = r)现在得到 0,成为新的表面。

因此所有表面点都沿法线方向向外推进了距离 r,形状整体扩张。扩张后,原本夹角小于 180° 的尖角处,相邻两侧扩张面交出的是一条半径约为 r 的圆弧——这正是"圆角/倒角"效果;而在本来就光滑的凸弧上,扩张只是等距放大。从几何上看,这等价于对原形状取与半径为 r 的圆的 Minkowski 和。

底层实现印证了这一点:SDF builder 中对应的 Round 修饰器 round.gd 的 mod_code 只有一行:

return "%s -= $width;\n" % [ output_name ]

它继承自 union.gd,在场景被转换为 shader 模型时,于子形状的距离值计算完成之后统一减去 width,即"向外生长"的宽度。该修饰器在 sdf_builder.tscn 中注册在 SDF2D/Alter/Round 节点下,与节点图里的 sdRoundedShape 一一对应。

与 sdAnnularShape 的对比

仓库中还有一个容易混淆的算子 sdAnnularShape,二者的差异就在"是否取绝对值":

  • sdRoundedShape:d - r,只向外膨胀,得到更大的圆角形状;
  • sdAnnularShape:abs(d) - r(见 sdannularshape.mmg),对距离取绝对值后减常数,内外两侧同时收缩,产生以原轮廓为中线、宽度约 2r 的"环/描边"效果。

原文档也明确区分了两者:sdRoundedShape 是"从函数中减一个常数"(向外生长),sdAnnularShape 是"从函数绝对值中减一个常数"(生成环绕形状的环)。选哪个取决于你是要磨圆外形,还是要掏空出轮廓描边。

在材质图中接线:从形状到灰度输出

一个完整的"圆角形状"用法在节点图中通常包含三个环节:

  1. 生成基础形状:放置 sdCircle、sdPolygon、sdRoundedBox、sdStar 等形状节点(形状节点列表见 node_simple_sdf.rst 的 Shapes 小节);
  2. 套接 sdRoundedShape:将形状节点输出接入 sdRoundedShape 的 in 端口,把 r 调到你想要的圆角幅度;
  3. 可视化输出:将圆角后的 sdf2d 输出接入 sdShow(bevel 控制边缘过渡带宽度,base 控制底色),即可得到黑底白形的灰度图像(见 sdshow.mmg),也可以继续连接 sdBoolean 做布尔组合,或经过 sdTranslate/sdRotate/sdScale 变换后再统一输出。

文档所附的示例图 示例输出 展示了典型的圆角效果:输入形状的所有尖角被替换为光滑圆弧,整体轮廓保持原形状的拓扑特征。节点图上的接线示意见 节点示意图。

在仓库自带的示例工程中也能找到真实用例:文档工具工程 doc_tools.ptex 与骷髅材质工程 skulls.ptex 都嵌入了 sdroundedshape 节点(参数 r = 0.01),用于把 3D SDF 结果也做轻微圆角——这说明该 mmg 模板在仓库中还被复用为 3D 场景的圆角算子(3D 版本另有独立的 sdf3d_rounded 类型注册于 base.json)。打开这些 ptex 文件即可对照观察节点的实际连接方式与参数取值。

使用技巧与注意事项

  • 圆角是"打磨"而非"裁剪":sdRoundedShape 不会改变形状的整体拓扑(不会把多边形变成圆盘),只是抹平尖锐转角。若需要彻底变圆,应直接使用 sdCircle/sdEllipse 等圆形基础形状。
  • r 与后续布尔运算的配合:先圆角再做 sdBoolean 并集,能避免两个形状接缝处出现尖角;配合 sdMorph(两个距离场按因子混合,见 sdmorph.mmg)还可以在"尖角版"与"圆角版"之间做平滑过渡动画。
  • 级联多次圆角:sdRoundedShape 输出仍是 sdf2d,可以再接入另一个 sdRoundedShape。多次小半径级联近似于分段磨圆,常用于制作更柔和的渐变轮廓。
  • 注意 r 的相对性:r 是在归一化 UV 坐标系下度量的,默认范围 0~1。当输入形状本身经过 sdScale 缩放后,同样的 r 值对应的实际圆角大小会相应变化,需要结合变换链路整体评估。
  • 输出仍需要 sdShow 或后续使用:sdf2d 不是普通颜色纹理,直接查看时看不到效果;务必用 sdShow 渲染灰度,或继续用于其他 SDF 运算后再输出。

小结

sdRoundedShape 是 Material Maker 2D SDF 工具箱里"一个参数解决倒角"的典型代表:其全部行为浓缩在 $in($uv)-$r 这一行 shader 表达式中(sdroundedshape.mmg),配合 SDF builder 的 -= $width 修饰代码(round.gd)共同构成了"距离场向外等距扩张"的数学本质。掌握它之后,你可以在任意形状、任意布尔组合的结果上自由添加可控圆角,让程序化材质中的几何轮廓既保持锐利设计感,又获得柔和的过渡边缘。

登录后查看全文
material-maker