游戏引擎 / 系统课时

用预览与运行窗口确认修改是否生效

用预览与运行窗口确认修改是否生效

修改 Shader 后,编辑器预览正常不代表运行场景一定使用了同一份材质。本课建立一条从编写、保存、挂载到运行与回退的验证路径,并用一个明显变色的测试效果,快速区分代码错误、资源引用错误和运行时参数覆盖。

学习目标

  • 建立 Shader 修改后可重复执行的验证顺序。
  • 用明显的颜色差异核对编辑器和运行窗口。
  • 按症状定位不生效原因,并安全恢复基线。

准备能一眼识别的测试效果

在 Godot 4 场景中添加带纹理的 Sprite2D,将下列完整 Shader 保存为 debug_tint.gdshader,通过节点的 Material 属性创建 ShaderMaterial 并指定该 Shader。这里保留纹理透明度,仅让不透明部分逐渐变成洋红色,便于肉眼判断。

glsl
shader_type canvas_item;

uniform float debug_mix : hint_range(0.0, 1.0, 0.1) = 0.0;

void fragment() {
    // 让 0 和 1 成为清晰的验证基线。
    // 不覆盖 Alpha,避免透明边缘干扰判断。
    COLOR.rgb = mix(COLOR.rgb, vec3(1.0, 0.0, 1.0), debug_mix);
}

预期结果:材质的 Debug Mix 为 0 时,精灵保持原样;调成 1 后,可见像素变为洋红色;调成 0.5 时呈中间效果。这是画面验证,不会产生控制台输出。

形成保存、预览和运行闭环

  1. 在 Shader 编辑器中确认没有编译错误,保存 .gdshader,并保存包含材质引用的场景。
  2. 选中目标 Sprite2D,检查 Material 确实指向含测试 Shader 的 ShaderMaterial,而不是另一个材质。
  3. 在材质的 Shader Parameters 中将 Debug Mix 设为 1,观察二维编辑视口是否变成洋红色。
  4. 使用 Godot 4 的 运行当前场景(通常是 F6),在独立运行窗口确认同一精灵也变色;按 F8 停止。
  5. 将 Debug Mix 改回 0,重新运行当前场景,确认颜色恢复。只比较同一个场景、同一个节点,避免把其他场景的精灵误当测试对象。

Shader 从保存到运行与回退的验证流程

按症状定位没有变化的原因

  • 视口和运行窗口都不变色:先看 Shader 编辑器是否有错误,再确认 Sprite2D 有纹理、可见且透明度不为零;检查 Material 下的 Shader 引用及 Debug Mix 是否真的为 1。
  • 视口变色,运行窗口不变:确认按 F6 运行的是当前保存的场景;检查运行中的脚本是否重新设置材质参数、替换材质或修改节点可见性。不要把编辑器中的本地资源状态直接等同于运行时状态。
  • 改了 Shader 源码却没有新效果:确认编辑的是节点实际引用的 .gdshader,且已保存;若改的是 uniform 默认值,还要检查材质是否保存了旧的参数覆盖值。
  • 多个精灵同时变化:查看是否共用同一个 ShaderMaterial 资源;需要独立参数时,为节点使用各自的材质资源。

回退到可验证的基线

调试前保存一份已确认正常的 Shader 与场景,最好纳入版本控制。若改动导致异常,先停止运行,恢复最近一次正常的源码和材质参数,再运行同一场景。不要只撤销源码却保留检查器中的异常数值。

这条验证链的通过条件是:编辑视口与运行窗口一致,修改参数能产生可预测变化,恢复参数后效果也能复原。达到这三点,才能确信本次 Shader 修改真正生效。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用预览与运行窗口确认修改是否生效

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通