Material Maker Translate 平移节点深度指南：2D/3D 有符号距离场（SDF）变换原理与实战

发布时间：2026/10/12 3:28:24 · 信平特种工考证网

桌面应用图形学3D渲染图像处理【免费下载链接】material-makerA procedural textures authoring and 3D model painting tool based on the Godot game engine项目地址https://gitcode.com/gh_mirrors/ma/material-maker点击查看免费下载导读本文围绕 Material Maker 中 2D SDF 变换节点Translate平移展开它是有符号距离函数Signed Distance FunctionSDF节点体系中四个变换节点Translate / Rotate / Scale / Scale XY之一用于将一个或多个以 SDF 描述的 2D 形状沿 X、Y 轴整体平移。读完本文你将掌握 Translate 节点的输入输出契约、X/Y 偏移参数的取值范围与微调方式、其底层采样点反向偏移的 SDF 平移数学原理以及如何结合 sdShow、sdCircle 等节点搭建一条从形状生成、变换到灰度图输出的完整可复现工作流同时还会了解同一变换思想在 3D 版本节点中的对应实现。节点概览继承原文档的核心定义依据官方文档 node_simple_sdf_transforms_translate.rstTranslate节点是一个variadic可变参数节点其功能为通过对输入进行平移生成对应的有符号距离图像。节点要点可归纳如下变长输入能力可以接受一个或多个 SDF 格式的输入并一次性对全部输入施加相同的平移量输出特性输出平移后形状的有符号距离函数后续仍可作为 SDF 数据接入布尔运算、重复排列sdRepeat等其他 SDF 算子参数构成接受X 偏移与Y 偏移两个平移量参数。在 nodes_common.rst 的端口类型约定中2D SDF 端口在节点图形界面上以橙色显示并拥有专门的距离场预览效果SDF 数据本身不能直接当作普通灰度图使用需要借助sdShow节点见 node_simple_sdf_operators_sdshow.rst转换为背景为黑、形状为白的灰度图像后再进入常规纹理流程。输入与输出契约项目说明输入端口一个或多个sdf2d类型输入端口名为in##即变长占位符随节点变长尺寸展开为in1、in2……输出端口一个或多个sdf2d类型输出为平移后形状的 SDF输入默认值0.0未连接时按默认距离处理变换行为对所有输入施加同一组X/Y 偏移量在 sdtranslate.mmg 的定义中可以看到输入声明的longdesc为 The input shape, defined as a signed distance function以 SDF 定义的输入形状输出声明的longdesc为 The translated shape平移后的形状类型均为sdf2d。由于是变长节点理论上你可以把任意多个形状例如多个 sdCircle同时接入让它们作为一个整体被统一平移这在构建由若干子形状拼合的复杂图形时非常实用。参数详解X / Y 偏移根据 sdtranslate.mmg 的参数定义Translate 节点暴露两个浮点参数参数名UI 标签默认值最小值最大值步长说明xX0-110.01沿 X 轴的平移量yY0-110.01沿 Y 轴的平移量值得注意的实现细节是两个参数的control字段分别为P1.x与P1.y这意味着它们对应节点图形界面即文档所附节点截图中P1 参数插槽上的 x / y 两个手柄你可以直接在节点体上拖拽手柄来直观调节平移量也可以在参数面板中精确输入数值。依据 nodes_common.rst 对 float 参数的一般约定这里还隐含以下实用规则点击参数输入框左右拖动可连续增减数值到达-1或1边界后继续拖动可以突破界限风险自负float 参数支持GLSL 表达式例如$x可写成$time*0.1来驱动动画或用$rnd(-1, 1)引入随机平移量当参数被表达式、命名参数引用时需以美元符号$前缀引用。由于平移属于刚体变换偏移量取值范围与 SDF 场景坐标直接相关SDF 场景通常以$uv归一化坐标工作默认场景范围约为0..1因此-1..1的平移区间足以覆盖绝大多数拼合需求。平移的数学原理为什么 SDF 可以直接平移这是理解 Translate 节点最关键的一环。对一个距离函数f(p)实施平移变换t标准做法是f(p) f(p - t)即在求点p到平移后形状的距离时等价于求点p - t到原始形状的距离。这是因为把形状沿向量t平移后采样点与形状之间的相对位置恰好被反向补偿。sdtranslate.mmg 中输出表达式正是这一公式的 GLSL 实现$in#($uv-vec2($x, $y))其中$uv是当前采样坐标vec2($x, $y)是平移向量$in#是对输入距离函数的调用——整个表达式表示用反向偏移后的坐标去求输入 SDF 的值。与 node_simple_sdf_transforms_scale_xy.rst 中明确提示非均匀缩放后结果不再是严格正确的 SDF不同平移是保距变换它既不改变点到边界的符号内外关系也不改变距离的数值大小只改变形状所在位置。因此平移后的输出仍然是严格合法的有符号距离函数可以直接无缝地继续参与后续的 SDF 算子如布尔并集/交集、圆角、morph 变形、repeat 重复而不会引入距离场失真这是 Translate 节点区别于 Scale XY 等变换节点的关键优势。3D 版本同样的思想多一个 Z 轴Material Maker 的 3D SDF 节点体系中提供了同名的Translate节点文档见 node_3d_sdf_transforms_translate.rst其实现定义在 sdf3d_translate.mmg输入类型为sdf3dc可携带颜色索引的 3D SDF输出同样为sdf3dc输出表达式为$in#($uv-vec3($x, $y, $z))把 2D 的vec2平移推广为三维向量参数在x、y之外新增z三者默认值均为0、范围均为-1..1、步长0.01其中x、y的control为P1.x/P1.y节点体手柄z的control为None只能通过参数面板调节。文档特别强调当输入形状关联了颜色索引时Translate 节点会把颜色索引一并传递到输出从而保证平移后的形状在 3D 场景中仍能正确区分材质区域。这与 node_3d_sdf.rst 所描述的 3D SDF 渲染管线经由 Render 节点转换为高度图与法线图可以顺畅衔接。源码级剖析变长节点Variadic如何工作Translate 节点之所以能接受一个或多个输入源于 Material Maker 的generic通用/变长节点机制其核心实现位于 gen_shader.gd判定is_generic()检查 shader_model 的参数或输入名中是否含有#占位符——sdtranslate.mmg 中的输入in#恰好命中该判定尺寸管理set_generic_size(size)在尺寸变化后重新调用set_shader_model()触发重编译节点的generic_size字段会随材料文件序列化保存data.generic_size generic_size展开逻辑expand_generic()按generic_size遍历复制输入、输出与参数把#替换为具体序号如in#→in1、in2……并同步修正参数标签中的序号如 1: X 类标签最终由expand_generic_code()处理#count、#for/#end等模板标记。用户侧的交互方式在 nodes_common.rst 中亦有说明变长节点标题栏有专属图标左键单击图标可增加变长尺寸右键弹出菜单可恢复最小尺寸由当前连线决定。这意味着接入多少个输入完全由你的连线需求动态决定节点会自动为每个输入生成对应的in1、in2端口与输出。此外gen_shader.gd 展示了 SDF 数据在引擎中的管线化处理输入距离函数会经generate_input_function()包装成独立的oid_input_name()GLSL 函数输出表达式$in#(...)会被replace_input_with_function_call()替换为该函数的实际调用从而把整个 SDF 图编译进一个连续可执行的 shader 中——这正是 Translate 节点一行输出表达式背后能够支撑任意复杂输入图的原因。实战从形状到灰度图的完整工作流下面给出一个可直接在 Material Maker 中复现的最小示例展示 Translate 节点在 2D SDF 流程中的典型用法形状定义参考 node_simple_sdf_shapes_sdcircle.rst从节点库Tools - Create添加一个sdCircle形状节点它不需要任何输入直接输出一个圆的 SDF并可用radius、X/Y center参数设定圆心位置添加Translate节点把 sdCircle 的输出连接到其in1输入端口将 Translate 的 X / Y 参数或节点上的 P1 手柄设为目标偏移值例如 X 0.25、Y 0.15添加sdShow节点将 Translate 的输出接入即可在预览面板看到黑色背景上的白色平移圆如需多个形状一起平移可复制 sdCircle 并继续接入 Translate 的in2、in3……端口左键单击标题栏变长图标扩容。同样地可将 Translate 与同属变换组的 Rotate 节点、Scale 节点串联实现先旋转、再缩放、最后平移的复合变换再往下接入 sdBoolean、sdMorph 或 sdRepeat 等算子即可用少量形状拼出复杂图案。操作注意事项平移量是相对于 SDF 场景坐标的建议结合 sdShow 预览观察实际位移避免形状移出可视范围若需要让平移量随动画或随机变化可将 X / Y 参数写成$time或$rnd(min, max)表达式详见 nodes_common.rst 的 float 参数说明平移是保距刚体变换输出 SDF 保持正确性因此可以在 Transform 节点之后继续放心地使用任何 SDF 算子。相关节点与文档索引变换组内其他节点Rotate、Scale、Scale XY注意 Scale XY 会破坏距离场严格性SDF 输出显示sdShow 节点含 sdShow 2 的距离修复变体体系总览2D SDF 节点总览基于 Inigo Quilez 的 SDF 代码库包含 Shapes / Operators / Transforms 完整清单3D 对应实现3D SDF Translate 节点及其节点定义 sdf3d_translate.mmg引擎实现gen_shader.gd变长节点展开与 SDF 编译管线、gen_sdf.gdEasy SDF 场景生成器展示sdf2d输出如何产出通用节点规范nodes_common.rst端口颜色、参数编辑、随机种子、变长节点交互。小结Translate 节点是 Material Maker 2D/3D SDF 建模体系中用途最广泛的基础变换之一它以一行采样点反向偏移的 GLSL 表达式实现了数学上完全保距的形状平移凭借变长机制支持多输入统一变换配合 X/Y3D 版含 Z参数的表达式与随机化能力可无缝嵌入布尔、圆角、变形、重复等任意后续 SDF 算子。无论是复现简单的圆形位移还是搭建复杂的组合图案掌握 Translate 的输入输出契约与底层原理都能让你的 SDF 工作流更加可控与高效。赞分享桌面应用图形学3D渲染图像处理【免费下载链接】material-makerA procedural textures authoring and 3D model painting tool based on the Godot game engine项目地址https://gitcode.com/gh_mirrors/ma/material-maker点击查看免费下载相关推荐Material Maker 3D SDF Morph 节点详解有符号距离函数混合的原理、参数与实战Material Maker 3D SDF Morph 节点详解有符号距离函数混合的原理、参数与实战本文聚焦 Material Maker 中用于 3D 场桌面应用图形学3D渲染图像处理Material Maker 3D SDF FBM 节点完全指南为有符号距离场添加分形噪声Material Maker 3D SDF FBM 节点完全指南为有符号距离场添加分形噪声 SDF FBMSigned Distance Field Fra桌面应用图形学3D渲染图像处理Material Maker Revolution 节点将 2D SDF 轮廓绕轴旋转生成 3D 有向距离场Material Maker Revolution 节点将 2D SDF 轮廓绕轴旋转生成 3D 有向距离场导读 Revolution旋转节点是 Ma桌面应用图形学3D渲染图像处理上一篇Video2X终极指南免费AI视频画质提升与流畅度增强全攻略下一篇WeChatMsg如何永久保存微信聊天记录并生成年度报告完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

拿不准这条消息跟你有没有关系？

工种不同、批次不同，要求可能差很多。打电话把你的情况说清楚，我们按信阳、平顶山本地的口径给你捋一遍。

拨 18236992212 在线预约咨询

接着看

这些消息，可能你也用得上

河源电工证年审证明：学历低也能办，全国通用不踩坑河源电工证年审证明：学历低也能办，全国通用不踩坑学历不高，是不是看着“电工证”三个字就发怵？别慌，很多在河南跑工地的兄弟都这么想，觉得没大专文凭就报不上名，其实这是天大的误会。只要年满18周岁、身体健康、具备初中及以上学历，就能考，拿到手是全国通用的应急管理部门特种作业操作证。… 2026/10/12 3:27:14

西安弱电电工证实操怕挂科？3个技巧保过，附官方报名入口西安弱电电工证实操怕挂科？3个技巧保过，附官方报名入口上周刚送走的学员老张，在考场门口跟我直拍大腿：“哥，我就怕那个接线实操，脑子里一片空白，手抖得厉害。” 这种实操考试心里没底怕挂科… 2026/10/12 3:21:51

多久能拿到低压电工证？许昌老师傅揭秘：从报名到拿证只要21天多久能拿到低压电工证？许昌老师傅揭秘：从报名到拿证只要21天怕考不过白交培训费？这种焦虑我太懂了。很多在许昌搞建筑、做物业的老哥，手里攥着几百块报名费，心里直打鼓：万一没考过，钱是不是打水漂了？其实，只要路子对，多久能拿到低压电工证… 2026/10/12 3:16:26

Windows 10任务栏图标空白？从缓存到修复的全流程指南 1. 先弄清你遇到的是哪种"空白"：故障表象分类前阵子帮一位朋友处理了一台Win10电脑，症状很简单：任务栏左侧固定的几个应用图标全都变成了白板，点上去窗口能弹出来，但图标一直是空的。Windows 10 任务栏空白图… 2026/10/12 4:11:33

孟州市电工证快速办理多久拿证？工地忙人实测周期与避坑孟州市电工证快速办理多久拿证？工地忙人实测周期与避坑在工地上摸爬滚打这么多年，最怕的就是“证不在手，活不敢接”。很多兄弟跟我吐槽，工地节奏快得像打仗，白天搬砖、拉线、调试设备，晚上还要赶进度，根本挤不出整块时间来复习那些晦涩难懂的电工理论。想考个证增加收入，又怕周期太长，万一工地上突然缺人或者项目… 2026/10/12 4:08:30

电工证需要考试么？工地忙没时间复习，这证到底值不值得考电工证需要考试么？工地忙没时间复习，这证到底值不值得考工地现场钢筋水泥满天飞，每天连轴转12小时以上，想抽时间看书复习简直是天方夜谭。很多工友心里犯嘀咕：电工证需要考试么？要是必须考，那这证值不值得考？毕竟大家都不傻，不想花钱花精力还得受罪。其实，电工证需要考试么… 2026/10/12 3:58:01

销售团队拓客效果复盘指标体系分析：从外呼到跟进的三层拆解从漏斗模型角度拆解拓客复盘，外呼、沟通、推进三个环节各对应一个核心指标。为什么复盘不能只看"打了多少电话"这一个数字？很多团队复盘只看外呼总量，打得多就觉得状态好，但这个数字掩盖了真正的问题。同样打两百个电话… 2026/10/12 3:56:30

数字资产托管竞争新维度：香港信托模式的合规纵深解析香港信托模式在数字资产托管这个赛道里，天然带着一种“老钱”面对“新钱”时的从容感。我做了几年机构级数字资产托管相关的合规设计，见过不少团队拿着冷存储方案、多签钱包、MPC分片到处讲技术，但真正到了需要承接家族办公室、合资格基金这类… 2026/10/12 3:55:30

眉山如何考取电工证？工地太忙没空复习？这证全国通用别拖眉山如何考取电工证？工地太忙没空复习？这证全国通用别拖在眉山工地上混过的人都知道，最怕的就是忙完活还要被喊去考试。很多老电工心里都有本难念的经：工地太忙根本没时间复习考试，白天跟着进度跑，晚上还得应付检查，哪还有精力啃那些枯燥的理论题？… 2026/10/11 0:01:20

电工证能开什么证明？这份保姆级教程帮你避开报销与上岗的坑电工证能开什么证明？这份保姆级教程帮你避开报销与上岗的坑怕考不过白交培训费？这确实是很多想入行电工人最纠结的点。别急，今天这篇保姆级教程不讲虚的，直接拆解电工证能开什么证明… 2026/10/11 0:06:18

南宁电工证体检包过靠谱吗?3步网上查询避坑指南南宁电工证体检包过靠谱吗?3步网上查询避坑指南在南宁想考个电工证，最怕啥？不是怕考不过，而是怕还没开始就被中介坑了。尤其是听到“体检包过”这种话，心里直打鼓：这到底是不是违规操作？去了会不会白花钱还耽误事？别急，咱们不整虚的，直接上干货。… 2026/10/11 0:11:05

广东韶关电工证考试实操怕挂科？深扒多少钱与避坑指南广东韶关电工证考试实操怕挂科？深扒多少钱与避坑指南实操考试心里没底，怕挂科补考？别慌，很多人卡在“理论过了，实操拉胯”这一步。广东韶关电工证考试到底多少钱？其实官方定价透明，但机构报价五花八门，这里面的水深得能淹死人。… 2026/10/12 0:03:23

特种作业证预约考试流程详解，千万别踩坑特种作业证预约考试流程详解，千万别踩坑刚入行做市政工程的兄弟，是不是最怕花几千块培训费，结果预约了考试却考不过，钱白扔了人还丢脸？这种焦虑太真实了，毕竟咱们在南阳卧龙区干市政公用工程，手里没本子上不了岗，但考证这事儿水太深，千万别踩坑… 2026/10/12 0:08:22

国开可以考电工证吗官方回应跨省转证避坑指南国开可以考电工证吗官方回应跨省转证避坑指南之前考的证在外省能不能转过来？这是很多像老张一样的建筑工人最头疼的问题。很多人拿着老家办的证，到了新工地想干活，结果被安全员一句“这证查不到”给打回来了。关于“国开可以考电工证吗”这种野路子，官方回应一直很明确：特种作业操作证必须通过正规渠道报考，别信那些… 2026/10/12 0:13:56

看完这篇，接下来怎么办

考证这件事，其实没你想的那么复杂

这篇文章讲的是一个具体问题，但真轮到自己报名考试，还有不少细碎的事要提前理清。我们在信阳、平顶山两地做特种作业考证咨询多年，把大家问得最多的几步，给你捋顺。

先预审材料

身份证、学历证明、体检报告、白底照片，自己先备齐发我们看一眼。缺啥补啥，别等到报名当天才发现少东西，那批就赶不上了。

再安排辅导

理论刷题加实操要点，我们按当期考试范围给你划重点。上过班的师傅底子不差，缺的就是熟悉题型这一步。

考完盯证书

成绩出来多久能领证、证到手怎么查真假、三年后什么时候复审，我们都帮你记着，到点提醒。

本文涉及的报考条件、收费、批次均以河南省应急管理部门当期公示为准。具体到你个人的情况，打 18236992212 说清楚，我们给你一句准话。

本地师傅常问

信阳、平顶山这边的几句实在话

在信阳工地干活，低压电工证基本是进场标配，没有连报名面试都过不了
平顶山矿上电厂那边，高压电工和高处作业证需求稳，老师傅不愁找活
新手别上来就报难的，先从低压电工入手，考过再增项更顺

地区用工情况随项目变化，以当地企业实际为准。想按你情况挑个合适工种，打 18236992212。

这篇文章只解决一个具体问题。真要报名，流程、材料、考试是另一整套事。不清楚自己处在哪一步，打 18236992212，按你的进度给建议。

看完文章还有疑问，常见问题在"常见问答"里能找到；想直接聊，电话最省时间。文章信息仅供参考，报考条件、收费以官方当期公示为准。

不确定自己符不符合报考条件？电话里说下年龄、学历、工种意向，我们给你判断。

文章导读

看完这篇咋接着走

这篇文章讲的是一个具体问题，但真轮到自己报名考试，还有不少细碎的事要提前理清。我们在信阳、平顶山两地做特种作业考证咨询多年，把大家问得最多的几步给你捋顺。

先预审材料：身份证、学历证明、体检报告、白底照片，自己先备齐发我们看一眼，缺啥补啥。再安排辅导：理论刷题加实操要点，按当期考试范围划重点。考完盯证书：成绩出来多久能领证、证到手怎么查真假、三年后什么时候复审，我们都帮你记着。

本地师傅常问

信阳平顶山的实在话

在信阳工地干活，低压电工证基本是进场标配，没有连报名面试都过不了。平顶山矿上电厂那边，高压电工和高处作业证需求稳，老师傅不愁找活。新手别上来就报难的，先从低压电工入手，考过再增项更顺。

地区用工情况随项目变化，以当地企业实际为准。想按你情况挑个合适工种，打 18236992212。本文涉及的报考条件、收费、批次均以河南省应急管理部门当期公示为准。

延伸服务

看完文章接着办

这篇文章只解决一个具体问题。真要报名，流程、材料、考试是另一整套事。不清楚自己处在哪一步，打 18236992212，按你的进度给建议。

材料预审、考前辅导、排批考试、考完盯证，这一整套我们接着。常见问题在 faq.html 能找到，想直接聊电话最省时间。

文章信息仅供参考，报考条件、收费以官方当期公示为准。不确定自己符不符合报考条件，电话里说下年龄学历工种意向，我们给你判断。

文章导读

看完这篇咋接着走

这篇文章讲的是一个具体问题，但真轮到自己报名考试还有不少细碎的事要提前理清。我们在信阳平顶山两地做特种作业考证咨询多年，把大家问得最多的几步给你捋顺。先预审材料：身份证学历证明体检报告白底照片自己先备齐发我们看一眼缺啥补啥。再安排辅导：理论刷题加实操要点按当期考试范围划重点。考完盯证书：成绩出来多久能领证证到手怎么查真假三年后什么时候复审我们都帮你记着。

本地师傅常问补充

信阳平顶山的实在话

在信阳工地干活低压电工证基本是进场标配没有连报名面试都过不了。平顶山矿上电厂那边高压电工和高处作业证需求稳老师傅不愁找活。新手别上来就报难的先从低压电工入手考过再增项更顺。地区用工情况随项目变化以当地企业实际为准。想按你情况挑个合适工种打 18236992212。本文涉及的报考条件收费批次均以河南省应急管理部门当期公示为准。

延伸服务

看完文章接着办

这篇文章只解决一个具体问题。真要报名流程材料考试是另一整套事。不清楚自己处在哪一步打18236992212按你的进度给建议。材料预审考前辅导排批考试考完盯证这一整套我们接着。常见问题在faq.html能找到想直接聊电话最省时间。文章信息仅供参考报考条件收费以官方当期公示为准。不确定自己符不符合报考条件电话里说下年龄学历工种意向我们给你判断。

本地师傅常问再补

信阳平顶山的实在话

在信阳工地干活低压电工证基本是进场标配没有连报名面试都过不了。平顶山矿上电厂那边高压电工和高处作业证需求稳老师傅不愁找活。新手别上来就报难的先从低压电工入手考过再增项更顺。地区用工情况随项目变化以当地企业实际为准。想按你情况挑个合适工种打18236992212。本文涉及的报考条件收费批次均以河南省应急管理部门当期公示为准。

延伸服务再补