feat(ShaderBake): 全局参数注入(光照/环境/自定义全局量)

- 渲染前把勾选的全局量写进 Shader 全局,命令缓冲执行完按相反顺序还原,不污染编辑器状态
- 常用预设:光照方向/颜色、环境光三段、反射探针、_Time
- 从 shader 源文件扫描非材质属性的 uniform 声明,按类型生成可编辑条目
- 侧边栏新增可折叠的"全局参数"区,贴图引用不进 JSON(资产引用无法可靠序列化)
This commit is contained in:
2026-11-05 17:56:17 +08:00
parent a0512ad450
commit f8f4a3cfd0
10 changed files with 612 additions and 0 deletions
@@ -0,0 +1,158 @@
using System;
using System.Collections.Generic;
using UnityEngine;
namespace XericUI.ShaderBake
{
/// <summary> 能喂给 shader 的全局量类别,决定用哪个 SetGlobal 入口 </summary>
public enum ShaderBakeGlobalKind
{
Float,
Vector,
Color,
Texture
}
/// <summary>
/// 一条全局参数。贴图引用标了 <see cref="NonSerializedAttribute"/>:JsonUtility 存不下来资产引用,
/// 硬存一个实例 ID 反而会在换会话后变成半死的引用。
/// </summary>
[Serializable]
public class ShaderBakeGlobalEntry
{
public string name;
public ShaderBakeGlobalKind kind;
[Tooltip("关掉就完全不动这个全局量,包括不捕获、不还原")]
public bool enabled;
public float x;
public float y;
public float z;
public float w;
[NonSerialized] public Texture texture;
public ShaderBakeGlobalEntry() { }
public ShaderBakeGlobalEntry(string name, ShaderBakeGlobalKind kind, bool enabled = false)
{
this.name = name;
this.kind = kind;
this.enabled = enabled;
w = 1f;
}
public Vector4 ToVector() { return new Vector4(x, y, z, w); }
public Color ToColor() { return new Color(x, y, z, w); }
}
/// <summary>
/// 一组全局参数。烘焙走的是离屏命令缓冲,没有相机在渲染,"灯在哪、环境光是什么"这类由引擎
/// 在相机流程里塞进去的全局量天然缺失——这里就是补那一块的口子。
///
/// <para><b>只改自己认识的那几条,并且画完就还原</b>:不还原等于把一次烘焙的临时值泄漏给整个编辑器。
/// 还原是尽力而为:引擎每帧会重设的内置量(例如相机相关的矩阵)可能被覆盖回去。</para>
/// </summary>
[Serializable]
public class ShaderBakeGlobalSettings
{
[Tooltip("要参与烘焙的全局参数。没勾选的行完全不参与")]
public List<ShaderBakeGlobalEntry> entries = new List<ShaderBakeGlobalEntry>();
/// <summary>
/// 把启用的条目写进全局,并返回一组还原动作(按相反顺序执行)。
/// </summary>
public List<Action> Apply()
{
var restores = new List<Action>();
if (entries == null)
return restores;
for (int i = 0; i < entries.Count; i++)
{
ShaderBakeGlobalEntry entry = entries[i];
if (entry == null || !entry.enabled || string.IsNullOrEmpty(entry.name))
continue;
string name = entry.name;
switch (entry.kind)
{
case ShaderBakeGlobalKind.Float:
{
float previous = Shader.GetGlobalFloat(name);
Shader.SetGlobalFloat(name, entry.x);
restores.Add(() => Shader.SetGlobalFloat(name, previous));
break;
}
case ShaderBakeGlobalKind.Vector:
{
Vector4 previous = Shader.GetGlobalVector(name);
Shader.SetGlobalVector(name, entry.ToVector());
restores.Add(() => Shader.SetGlobalVector(name, previous));
break;
}
case ShaderBakeGlobalKind.Color:
{
Color previous = Shader.GetGlobalColor(name);
Shader.SetGlobalColor(name, entry.ToColor());
restores.Add(() => Shader.SetGlobalColor(name, previous));
break;
}
case ShaderBakeGlobalKind.Texture:
{
Texture previous = Shader.GetGlobalTexture(name);
Shader.SetGlobalTexture(name, entry.texture);
restores.Add(() => Shader.SetGlobalTexture(name, previous));
break;
}
}
}
return restores;
}
/// <summary> 按名字找已有条目,没有就追加一条(扫描与预设都走这里,避免重复) </summary>
public ShaderBakeGlobalEntry Ensure(string name, ShaderBakeGlobalKind kind)
{
if (entries == null)
entries = new List<ShaderBakeGlobalEntry>();
for (int i = 0; i < entries.Count; i++)
{
if (entries[i] != null && entries[i].name == name)
return entries[i];
}
var entry = new ShaderBakeGlobalEntry(name, kind);
entries.Add(entry);
return entry;
}
/// <summary>
/// 常用光照/环境量。全部默认关闭:不同渲染管线对这些名字的语义不完全一样,
/// 该不该开由用户决定,工具不替他改画面。
/// </summary>
public void AddEnvironmentPresets()
{
AddVector("_WorldSpaceLightPos0", 0.3f, 0.7f, -0.6f, 0f);
AddColor("_LightColor0", 1f, 1f, 1f, 1f);
AddColor("unity_AmbientSky", 0.21f, 0.23f, 0.25f, 1f);
AddColor("unity_AmbientEquator", 0.11f, 0.12f, 0.13f, 1f);
AddColor("unity_AmbientGround", 0.04f, 0.04f, 0.04f, 1f);
AddVector("_Time", 0f, 0f, 0f, 0f);
Ensure("unity_SpecCube0", ShaderBakeGlobalKind.Texture);
}
private void AddVector(string name, float x, float y, float z, float w)
{
ShaderBakeGlobalEntry entry = Ensure(name, ShaderBakeGlobalKind.Vector);
entry.x = x; entry.y = y; entry.z = z; entry.w = w;
}
private void AddColor(string name, float x, float y, float z, float w)
{
ShaderBakeGlobalEntry entry = Ensure(name, ShaderBakeGlobalKind.Color);
entry.x = x; entry.y = y; entry.z = z; entry.w = w;
}
}
}
+8
View File
@@ -1,4 +1,5 @@
using System;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.Rendering;
@@ -356,6 +357,7 @@ namespace XericUI.ShaderBake
// 不动网格(外部模型的绕序不该被我们改),只在这一刻把剔除方向反过来。
bool previousInvert = GL.invertCulling;
GL.invertCulling = previousInvert != settings.output.flipY;
List<Action> restoreGlobals = settings.globals != null ? settings.globals.Apply() : null;
try
{
Graphics.ExecuteCommandBuffer(m_Buffer);
@@ -363,6 +365,12 @@ namespace XericUI.ShaderBake
finally
{
GL.invertCulling = previousInvert;
// 画完立刻还原:这些是编辑器全局状态,留一次烘焙的值下来会污染别处的渲染
if (restoreGlobals != null)
{
for (int i = restoreGlobals.Count - 1; i >= 0; i--)
restoreGlobals[i]();
}
}
m_Buffer.Clear();
}
+3
View File
@@ -19,6 +19,9 @@ namespace XericUI.ShaderBake
[Tooltip("离屏相机")]
public ShaderBakeCameraSettings camera = new ShaderBakeCameraSettings();
[Tooltip("渲染前注入的全局参数(光照方向、环境光、反射贴图等)")]
public ShaderBakeGlobalSettings globals = new ShaderBakeGlobalSettings();
/// <summary> 画面宽高比 </summary>
public float aspect
{