Material Maker 的 sdRoundedShape 节点详解:用距离场减法实现形状圆角化
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 是"从函数绝对值中减一个常数"(生成环绕形状的环)。选哪个取决于你是要磨圆外形,还是要掏空出轮廓描边。
在材质图中接线:从形状到灰度输出
一个完整的"圆角形状"用法在节点图中通常包含三个环节:
- 生成基础形状:放置
sdCircle、sdPolygon、sdRoundedBox、sdStar等形状节点(形状节点列表见 node_simple_sdf.rst 的 Shapes 小节); - 套接 sdRoundedShape:将形状节点输出接入
sdRoundedShape的in端口,把r调到你想要的圆角幅度; - 可视化输出:将圆角后的
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)共同构成了"距离场向外等距扩张"的数学本质。掌握它之后,你可以在任意形状、任意布尔组合的结果上自由添加可控圆角,让程序化材质中的几何轮廓既保持锐利设计感,又获得柔和的过渡边缘。