Material Maker 2D 预览面板完全指南:节点输出预览、辅助线与动画导出

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

Material Maker 2D 预览面板完全指南:节点输出预览、辅助线与动画导出

导读

Material Maker 是一款基于 Godot 引擎的程序化纹理创作与 3D 模型绘制工具。其 2D Preview(2D 预览)面板 是日常材质编辑流程中最核心的实时反馈窗口:选中任意节点即可立即看到其第一个输出端口的纹理结果,配合鼠标滚轮缩放、中键平移、辅助线网格、多视图模式与后处理滤镜,可以在不打开外部软件的情况下完成纹理检查、参数微调与像素画风格预览。本文以 用户界面文档 为骨架,结合仓库源码 panels/preview_2d 与 windows/export_animation,完整讲解面板的交互操作、右键菜单功能、视图与辅助线配置,以及把预览节点导出为静态图片、逐帧 PNG 和 Sprite Sheet 动画的完整实战流程。

一、面板定位与两个预览实例

Material Maker 主界面布局中默认配置了两个独立的 2D 预览面板。在 main_window_layout.gd 中可以看到:

{ name="Preview2D", scene=preload("res://material_maker/panels/preview_2d/preview_2d_panel.tscn"), position="TopRight" , parameters={preview_mode=1} },
{ name="Preview2D (2)", scene=preload("res://material_maker/panels/preview_2d/preview_2d_panel.tscn"), position="BottomRight", parameters={preview_mode=2} },
  • Preview2D 位于右上区域,preview_mode = 1,即"第一预览面板";
  • Preview2D (2) 位于右下区域,preview_mode = 2,即"第二预览面板"。

面板的核心逻辑定义在 preview_2d_panel.gd 中,通过 enum Modes {CUSTOM_PREVIEW=0, PREVIEW_1=1, PREVIEW_2=2} 区分两种用途;preview_mode 同时决定面板配置项的后缀(_2),从而让两个面板的视图模式、辅助线样式等设置互不干扰、各自记忆。

此外,面板脚本还通过 CUSTOM_PREVIEW 模式服务于其他场景(例如 windows/sdf_builder/preview_2d.gd 中复用同一套预览渲染逻辑),本文聚焦标准材质编辑工作流中的两个面板。

二、选择预览内容:节点、输出端口与锁定

2.1 节点选择自动预览

选中任意节点后,该节点的第一个输出端口会自动显示在第一预览面板中。这由 preview_2d.gd 中的 set_generator() 实现:它通过 generator.get_shader_code("uv", output, context) 获取该输出端口的着色器代码,再经 MMGenBase.generate_preview_shader() 包装后实时渲染。面板同时连接了节点的 parameter_changed 信号,参数一旦变化,预览立刻刷新。

2.2 左键点击输出端口

在节点图上左键单击某个输出端口,该输出会取代节点默认的第一个输出,显示在第一预览面板中。输出端口的实时切换同样由 set_generator() 完成:当 output 序号变化或收到 __output_changed__ 通知时(见 preview_2d.gd),面板会强制刷新渲染目标。

2.3 Ctrl 点击锁定预览

按住 Control(macOS 上为 Command) 再点击输出端口,会锁定当前预览选择——此后无论再选择哪个节点或点击哪个输出端口,面板内容都不会改变,方便你把某个中间结果钉在屏幕上对照。再次按住 Control 点击已锁定的输出,即可解除锁定。

锁定状态在面板菜单栏中也有一个可视化的开关按钮(PreviewLocked,带"锁/开锁"双图标),其回调逻辑见 preview_2d_panel.gd,并与当前图编辑器(MMGraphEdit)的 locked_preview 数组联动——所以锁定状态会随节点图一起被保存与恢复。

2.4 Shift 点击在第二面板中预览

按住 Shift 点击(或按住 Shift 再 Control 点击)输出端口,会将预览显示在第二个 2D 预览面板中。也就是说:你可以在第一面板固定观察节点 A,同时在第二面板快速切换对比节点 B/C/D 的输出。

三、纹理边界检查:角线与网格

2D 预览面板上叠加的角线(以及网格的外沿)表示纹理的实际边界,其核心用途是快速检查纹理是否无缝环绕(wrap)。

该功能由 lines.gd 实现,支持 4 种样式(STYLES = [ "None", "Corners", "Lines", "Grid" ]):

样式 显示内容 适用场景
None 不绘制任何辅助线 最终效果查看
Corners 四条角线标出纹理边界 检查边缘接缝与 tile 边界
Lines 中心十字 + 四角边界线(1×1 网格) 快速定位中心与边缘
Grid 自定义数量的网格线 对齐图案、检查平铺

选择 Grid 样式时,可以额外设置 Custom Grid Size(取值范围 1~32,见 preview_2d_panel.tscn),网格线随即按该数量均匀分布。所有辅助线都可以自定义颜色(GuidesColor 拾色器),且每个面板独立记忆自己的样式、网格尺寸与颜色(配置键为 preview_<suffix>_guides_style / _guides_grid_size / _guides_color,见 lines.gd)。

小技巧:在 Grid 样式下放大预览,配合四角边界线即可直观判断纹理在 tile 方向是否连续——这是制作可平铺材质(如砖墙、布料)时的高频检查手段。

四、视图导航:缩放、平移与重置

面板支持完整的视图操作(见 preview_2d_panel.gd 的 _on_gui_input):

  • 鼠标滚轮:缩放预览。向上放大、向下缩小,缩放范围被限制在 0.005× ~ 5.0× 之间;
  • 按住鼠标中键拖动:平移预览画面;
  • 触控板手势:也支持双指平移(PanGesture)与捏合缩放(MagnifyGesture);
  • Reset View 按钮(或右键菜单中的对应项):将视图恢复到居中(center = (0.5, 0.5))与默认缩放(view_scale = 1.2),实现见 preview_2d_panel.gd 的 reset_view()。

当鼠标悬停在面板上时,状态栏会提示当前快捷键组合:"#MMB: Pan, Mouse wheel: Zoom"(见 preview_2d_panel.gd)。

五、直接在预览上编辑参数:控制点(Gizmo)

这是 2D 预览面板最具特色的一环:根据所选节点,面板上会显示对应的控制点,可以直接用鼠标拖动来修改节点参数。

其实现位于 preview_2d_panel.tscn 中定义的一系列 control_point 实例,配合 control_point.gd 工作:

  • 节点参数定义中带有 control 属性的参数(例如 P1.x、P1.y、P1.r、P1.a 等)会被自动映射到对应控制点上(见 control_point.gd);
  • 控制点类型(control_type)包括 Simple(普通点)、Rect(矩形框)、Radius(半径线)、Scale(缩放框)与 RotateScale(旋转缩放);
  • 拖动时通过 update_parameters() 把屏幕坐标换算回节点参数空间并写回生成器(control_point.gd),面板与图编辑器中的参数实时同步;
  • 复杂的多边形/折线/样条/像素/晶格参数(如多边形编辑节点),则通过 ComplexParameters 下拉列表在面板内切换编辑(见 preview_2d_panel.gd)。

吸附到网格:按住 Control 拖动控制点时,坐标会被吸附到当前网格(snap 精度取 Grid 辅助线的网格尺寸,角度类参数则吸附到 15° 步进,见 control_point.gd)。若当前没有显示 Grid 辅助线,则 Ctrl 拖动不会吸附,因此需要"精细微调"时建议先关闭网格,需要"对齐整数值"时再开启。

此外,按住 Shift 拖动控制点会约束其在单一轴向移动(水平/垂直,取位移较大的轴),并显示红/绿坐标轴十字指示(axes.gd)。

六、右键上下文菜单:面板的完整功能入口

在 2D 预览面板空白处右键弹出上下文菜单,可执行以下操作(与面板菜单栏按钮一一对应):

6.1 重置视图

reset view 将缩放与平移恢复为默认状态(等价于菜单栏的 Reset View 按钮)。

6.2 选择辅助线样式与颜色

对应上文第三节的 Guides 设置:None / Corners / Lines / Grid 四种样式 + 自定义网格尺寸 + 颜色拾取。设置入口在菜单栏 View 按钮下拉面板中(preview_2d_panel.tscn)。

6.3 选择视图模式(View Mode)

提供三种显示模式(对应 preview_2d_panel.tscn 与底层 Shader):

模式 行为 典型用途
Extend 超出 0~1 的 UV 区域继续外推绘制 观察超出纹理边界的内容
Repeat 超出区域按 fract(uv) 平铺重复 检查纹理在多个 tile 上的连续性
Clamp 超出区域显示纯背景色 严格只看单个纹理 tile

6.4 后处理滤镜(Post Process Filter)

面板内置 6 档"低分辨率模拟"滤镜(见 preview_2d_panel.gd 的 POSTPROCESS_OPTIONS):

  • None(原始分辨率)
  • Lowres 32x32
  • Lowres 64x64
  • Lowres 128x128
  • Lowres 256x256
  • Lowres 512x512

其原理是在片段着色器中把采样坐标 uv 量化到对应分辨率的像素格中心(如 preview_2d((floor(uv*32.0)+vec2(0.5))/32.0)),从而以任意屏幕分辨率实时模拟低分辨率像素画效果。这是制作 Pixel Art(像素画)风格纹理时最实用的功能:先在面板上以 32×32 或 64×64 档位预览效果,满意后再按真实目标分辨率导出。

6.5 导出预览节点到文件

将当前预览的节点按设定分辨率渲染为图片文件。支持 PNG 与 EXR 两种格式,分辨率可选 64 到 8192 共 8 档预设(64/128/256/512/1024/2048/4096/8192),或选择 Custom 自定义宽高(16~2048,见 preview_2d_panel.tscn)。

导出菜单(export_menu.gd)提供了很有用的文件名模板变量:

  • $project:当前项目名
  • $node:当前节点标题
  • $idx:序号
  • $resolution:导出分辨率(如 1024)

默认文件名模板为 $project_$node,勾选后可在导出前实时预览解释结果(ExportFileResultLabel)。导出的底层渲染路径为 generator.render_output_to_texture(output, image_size) + texture.save_to_file()(见 preview_2d.gd)。

6.6 导出预览节点的动画

将带动画(随时间变化)的节点导出为一组 PNG 文件或 Sprite Sheet,具体操作详见下一节。

6.7 渲染到 References 面板

将当前预览节点按设定分辨率渲染后,直接作为参考图添加到 References(参考图)面板。实现见 preview_2d.gd:渲染纹理 → ImageTexture.create_from_image() → 交给 Reference 面板的 add_reference()。这在 3D 绘制/建模时需要"对着参考图"的场景非常有用。

6.8 透明棋盘格背景

面板默认在透明区域(Alpha 通道)绘制棋盘格,菜单中可调节其亮度(Light / Mid-tones / Dark)与格子大小(Small / Medium / Large),对应底层 Shader 的 background_color_1/2 与 checker_size(见 preview_2d_panel.gd)。建议在检查带透明度的纹理时调大格子尺寸,减少视觉干扰。

七、导出动画(Export Animation)详解

选择预览面板上下文菜单(或菜单栏 Export → Animation)中的 Export animation 会弹出独立的 Export Animation 窗口(场景定义在 export_animation.tscn,逻辑在 export_animation.gd)。

7.1 窗口控件一览

控件 说明 默认值 / 范围
Size 导出尺寸(单帧正方形边长) 预设 8 档:64~8192
Begin 动画开始时间 默认 0.0,最大 10.0
End 动画结束时间 默认 1.0,最大 10.0
Images 帧数 默认 10,范围 1~100
Spritesheet 输出形式 PNG files / 1 line / 2 lines / 4 lines / 1 column spritesheet

窗口底部还有 Export 与 Close 两个按钮。

7.2 三幅预览图与"差异"检查

窗口中央并排显示三幅预览:

  1. First frame(首帧):按 Begin 时间渲染的静止图像;
  2. Animation(动画):在 Begin 与 End 之间循环播放的实时动画;
  3. Last frame(末帧):按 End 时间渲染的静止图像。

在修改 Begin 或 End 数值时,动画图上方会叠加一层 Difference(差异) 视图:两帧像素相同的部分显示为黑色,不同的部分显示为红色。该效果由 export_animation.tscn 中的专用 Shader 实现:

COLOR = vec4(mix(vec3(0.0, 0.0, 0.0), vec3(1.0, 0.0, 0.0),
    clamp(length(texture(begin, UV)-texture(end, UV)), 0.0, 1.0)), 1.0);

这一设计是为了帮助你精确调出无缝循环动画:不断微调 Begin/End,直到差异视图中红色区域收敛到最小(首帧与末帧像素一致),即可得到一个首尾完美衔接的循环纹理动画(例如流动的水、闪烁的霓虹、旋转的图案)。

7.3 动画时间驱动的底层原理

动画的驱动逻辑见 export_animation.gd:节点生成器输出的着色器代码中,动画时间变量 elapsed_time 被替换为三种形态:

  • 首帧/末帧:elapsed_time 改为 uniform,直接由 Begin/End 数值赋值(画面冻结在特定时刻);
  • 动画帧:改为 begin + sign(end-begin) * mod(TIME, abs(end-begin)),即基于 TIME 在区间内循环往复。

因此任何在节点中使用时间(如 elapsed_time 或噪声演化)的生成器,都可以无缝走这条导出管线。

7.4 点击 Export 导出

点击 Export 按钮后,会弹出文件保存对话框(仅支持 PNG 过滤),随后按以下规则输出:

  • 生成多个 PNG 文件时:默认在文件名后追加 _帧序号(从 1 开始,如 fire_1.png、fire_2.png…);
  • 自定义序号占位符:若文件名中包含连续的一个或多个 # 字符(如 fire_###.png),则 # 会被替换为帧序号,且按 # 数量补零(如 3 个 # → fire_001.png),便于按字典序排序;注意文件名中不能出现多组 #;
  • 生成 Sprite Sheet 时:文件名原样使用(不追加序号),所有帧按 1 行、2 行、4 行或 1 列(纵向)排列合成一张大图,帧从左到右、从上到下填充。

帧采样方式为时间线性插值:第 i 帧对应时刻 begin + (end-begin) * i / images(见 export_animation.gd)。若勾选了偏好设置中的"记住动画导出设置"(remember_anim_export),本次的尺寸/起止时间/帧数/排列方式会在下次打开窗口时自动恢复(见 export_animation.gd)。

八、实战示例:导出无缝循环的像素风火苗动画

综合以上能力,一个典型的工作流如下:

  1. 在节点图中搭建一个带时间演化的生成器(例如 FBM 噪声 + 颜色映射),选中节点,在第一预览面板中实时观察效果;
  2. 打开预览面板的 View 菜单,将 Filter 设为 Lowres 64x64,检查像素画观感是否符合预期;
  3. 切换 View Mode 为 Repeat,配合 Corners 辅助线确认纹理可以无缝平铺;
  4. 打开 Export Animation 窗口,设置 Size(如 64)、Begin=0、End=4、Images=12,观察首帧与末帧的差异视图,微调 End 直到红色差异消失;
  5. 在 Spritesheet 中选择 4 lines spritesheet,点击 Export,输入文件名 fire_###.png,得到一张 3 列 4 行的 64×64 帧动画图,可直接用于引擎的动画分割。

九、小结

Material Maker 的 2D 预览面板远不止是一个"看图窗口":它以节点图实时渲染为基础,把纹理边界检查(角线/网格)、视图导航(缩放/平移/三种模式)、参数可视化编辑(控制点 + 网格吸附)、像素画预览(6 档低分辨率滤镜)与完整导出管线(静态图 / 逐帧 PNG / Sprite Sheet / 参考图 / TAA 渲染)整合在同一个交互面上。两个面板分别服务于"锁定对比"与"快速切换"两种工作习惯,配合差异视图调循环动画的设计,足以覆盖从材质搭建、无缝平铺验证到动画资源输出的完整流程。相关实现细节可进一步阅读 preview_2d_panel.gd、preview_2d_panel.tscn 与 export_animation.gd。

登录后查看全文
material-maker