From 550d6599870d829c50310e2f7040dc94133954a6 Mon Sep 17 00:00:00 2001
From: LiRuoChen <571244399@qq.com>
Date: Fri, 6 Nov 2026 17:55:35 +0800
Subject: [PATCH 01/23] =?UTF-8?q?feat(ShaderBake):=20=E5=8A=A0=20UV=20?=
=?UTF-8?q?=E8=B0=83=E8=AF=95=20shader=20=E4=B8=8E=E5=85=B1=E7=94=A8?=
=?UTF-8?q?=E6=8E=A2=E9=92=88=E6=B8=B2=E6=9F=93=E5=99=A8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
UV 检查视图要把"这一格铺了哪段 UV"变成一眼能读的颜色,而自检和它问的是同一个
问题的两面,所以把"按同一套参数换张材质再渲一次"抽成 ShaderBakeOverrideRenderer,
两处共用。pass 下标在这里固定成 0:探针 shader 只有一个 pass,照抄用户的下标只会
把"pass 选错"误诊成"管线坏了"。
---
.../ShaderBake/ShaderBakeOverrideRenderer.cs | 106 ++++++++++++++++++
.../ShaderBakeOverrideRenderer.cs.meta | 11 ++
Editor/ShaderBake/ShaderBakeUVDebug.shader | 81 +++++++++++++
.../ShaderBake/ShaderBakeUVDebug.shader.meta | 9 ++
4 files changed, 207 insertions(+)
create mode 100644 Editor/ShaderBake/ShaderBakeOverrideRenderer.cs
create mode 100644 Editor/ShaderBake/ShaderBakeOverrideRenderer.cs.meta
create mode 100644 Editor/ShaderBake/ShaderBakeUVDebug.shader
create mode 100644 Editor/ShaderBake/ShaderBakeUVDebug.shader.meta
diff --git a/Editor/ShaderBake/ShaderBakeOverrideRenderer.cs b/Editor/ShaderBake/ShaderBakeOverrideRenderer.cs
new file mode 100644
index 0000000..43d7166
--- /dev/null
+++ b/Editor/ShaderBake/ShaderBakeOverrideRenderer.cs
@@ -0,0 +1,106 @@
+using UnityEngine;
+
+namespace XericUI.ShaderBake.Editor
+{
+ ///
+ /// 用一张"覆盖材质"按同一套面片 / 相机 / pass 再渲一次的探针。
+ ///
+ /// 两处用得上,问的是同一个问题的两面:
+ ///
+ /// - 管线自检 —— 内置纯色 shader,回答"画不出来该怪管线还是怪被测 shader"
+ /// - UV 检查 —— 把顶点 UV 本身画成颜色,回答"这一格到底铺了哪段 UV"
+ ///
+ ///
+ /// settings 是共享引用,不是副本:探针必须和被测对象同参数,否则比较没有意义。
+ /// 材质只在渲染那一刻需要,画完即可销毁(画面已经在 RT 里,留着只会让人误以为它还在影响显示);
+ /// RT 由探针自己持有,所以探针要活到下一次正常渲染,那张图才还在。
+ ///
+ internal sealed class ShaderBakeOverrideRenderer
+ {
+ private ShaderBakeRenderer m_Probe;
+
+ ///
+ /// 探针自己那份网格。参数是共享的,所以顶点数与真实渲染一致——但真实渲染那次未必已经建过网格,
+ /// UV 视图的读数得能从探针这边拿到,否则状态栏的顶点数会空着。
+ ///
+ public Mesh geometry
+ {
+ get { return m_Probe != null ? m_Probe.geometry : null; }
+ }
+
+ ///
+ /// 换一张 shader 重画一次。失败返回 null 并把原因写进 ,
+ /// 成功时旧探针已经换新,之前那张图随之作废。
+ ///
+ public RenderTexture Render(ShaderBakeSettings settings, Shader shader, string shaderName, out string error)
+ {
+ error = string.Empty;
+ if (shader == null)
+ {
+ Release();
+ error = "找不到 " + shaderName;
+ return null;
+ }
+ var material = new Material(shader)
+ {
+ name = "ShaderBakeOverride",
+ hideFlags = HideFlags.DontSave
+ };
+ RenderTexture rt = RenderWithMaterial(settings, material, out error);
+ // 材质用完即弃:画面已经在 RT 里,留着只会让人误以为它还在影响显示
+ ShaderBakeRenderer.ReleaseTempObject(material, true);
+ return rt;
+ }
+
+ ///
+ /// 用调用方给的那张材质重画一次。材质不归这里所有,画完由调用方销毁——
+ /// 自检那张纯色材质要先设颜色,只能由调用方建。
+ ///
+ public RenderTexture RenderWithMaterial(ShaderBakeSettings settings, Material material, out string error)
+ {
+ error = string.Empty;
+ Release();
+
+ if (settings == null)
+ {
+ error = "没有参数可渲";
+ return null;
+ }
+
+ // 探针这两张 shader 都只有一个 pass。用户填的 pass 下标是给被测 shader 的,原样传过来
+ // 只会让探针画成空画面,于是"pass 选错"被误诊成"管线坏了"。
+ // 这里只借 settings 用一次,出来就还原,不会把改动留在共享对象上。
+ int subjectPass = settings.output.shaderPass;
+ settings.output.shaderPass = 0;
+ RenderTexture rt;
+ try
+ {
+ m_Probe = new ShaderBakeRenderer { settings = settings, material = material };
+ rt = m_Probe.Render();
+ if (rt == null)
+ error = m_Probe.lastError;
+ }
+ finally
+ {
+ settings.output.shaderPass = subjectPass;
+ }
+
+ if (rt == null)
+ {
+ Release();
+ return null;
+ }
+ return rt;
+ }
+
+ /// 收掉探针,连带它那张 RT。下一次真实渲染结果回来时调用
+ public void Release()
+ {
+ if (m_Probe == null)
+ return;
+ // 探针自己回收那张 RT,所以只走它一条路,别两边各销毁一次
+ m_Probe.Dispose(true);
+ m_Probe = null;
+ }
+ }
+}
diff --git a/Editor/ShaderBake/ShaderBakeOverrideRenderer.cs.meta b/Editor/ShaderBake/ShaderBakeOverrideRenderer.cs.meta
new file mode 100644
index 0000000..5062af1
--- /dev/null
+++ b/Editor/ShaderBake/ShaderBakeOverrideRenderer.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 7c4b2f19ae0d48f5b3c16d9e0a4f2b57
+MonoImporter:
+ externalObjects: {}
+ serializedVersion: 2
+ defaultReferences: []
+ executionOrder: 0
+ icon: {instanceID: 0}
+ userData:
+ assetBundleName:
+ assetBundleVariant:
diff --git a/Editor/ShaderBake/ShaderBakeUVDebug.shader b/Editor/ShaderBake/ShaderBakeUVDebug.shader
new file mode 100644
index 0000000..654d450
--- /dev/null
+++ b/Editor/ShaderBake/ShaderBakeUVDebug.shader
@@ -0,0 +1,81 @@
+// UV 状态可视化:把顶点收到的第 0 套 UV 直接当颜色画出来。
+// 它只吃 uv,不吃贴图、不吃光照,所以"这一格到底铺了哪段 UV"没有第二种解释。
+Shader "Hidden/XericUI/ShaderBake/UV Debug"
+{
+ Properties
+ {
+ _LineThickness ("整数边界线宽", Range(1, 400)) = 90
+ _CellMix ("每格色相强度", Range(0, 1)) = 0.22
+ }
+
+ SubShader
+ {
+ Tags { "RenderType" = "Opaque" "ForceSupported" = "True" }
+
+ // 剔除方向交给 Cull Off:这个视图要回答的是"UV 长什么样",
+ // 不该再被正面约定影响一次,否则空画面时两条原因会搅在一起
+ Cull Off
+ ZWrite Off
+ Lighting Off
+
+ Pass
+ {
+ CGPROGRAM
+ #pragma vertex vert
+ #pragma fragment frag
+ #include "UnityCG.cginc"
+
+ float _LineThickness;
+ float _CellMix;
+
+ struct appdata
+ {
+ float4 vertex : POSITION;
+ float2 uv0 : TEXCOORD0;
+ };
+
+ struct v2f
+ {
+ float4 pos : SV_POSITION;
+ float2 uv : TEXCOORD0;
+ };
+
+ fixed3 HueToRgb(float hue)
+ {
+ // 格编号可以是负的,先 floor 取小数保证 hue 落在 0~1,否则色相会随符号跳变
+ hue = hue - floor(hue);
+ float3 rgb = saturate(abs(hue * 6.0 + float3(0.0, 4.0, 2.0)) - 3.0);
+ return rgb;
+ }
+
+ v2f vert(appdata v)
+ {
+ v2f o;
+ o.pos = UnityObjectToClipPos(v.vertex);
+ o.uv = v.uv0;
+ return o;
+ }
+
+ fixed4 frag(v2f i) : SV_Target
+ {
+ float2 cell = floor(i.uv);
+ float2 f = i.uv - cell;
+
+ // 角点即 UV:左下黑、右下红(U 到 1)、左上绿(V 到 1)、右上黄。
+ // 四角是不是 00 / 10 / 01 / 11,看这个就够了
+ fixed4 col = fixed4(f.x, f.y, 0.06, 1.0);
+
+ // 每个整数格给一个稳定色相,相邻格不撞色,混在一起也能数出第几格
+ col.rgb = lerp(col.rgb, HueToRgb(cell.x * 0.618033 + cell.y * 0.381966), _CellMix);
+
+ // 整数边界压暗:格与格之间、UV 单位边界都显出来
+ float line = min(min(f.x, 1.0 - f.x), min(f.y, 1.0 - f.y));
+ col.rgb *= lerp(0.3, 1.0, saturate(line * _LineThickness));
+ return col;
+ }
+ ENDCG
+ }
+ }
+
+ Fallback Off
+}
diff --git a/Editor/ShaderBake/ShaderBakeUVDebug.shader.meta b/Editor/ShaderBake/ShaderBakeUVDebug.shader.meta
new file mode 100644
index 0000000..1c193c2
--- /dev/null
+++ b/Editor/ShaderBake/ShaderBakeUVDebug.shader.meta
@@ -0,0 +1,9 @@
+fileFormatVersion: 2
+guid: b69a9a69ca9a6930caa8808a0c91f009
+ShaderImporter:
+ externalObjects: {}
+ defaultTextures: []
+ nonModifiableTextures: []
+ userData:
+ assetBundleName:
+ assetBundleVariant:
From 4199275c873e53634826e73f67cb3a0b98b75963 Mon Sep 17 00:00:00 2001
From: LiRuoChen <571244399@qq.com>
Date: Fri, 6 Nov 2026 17:55:44 +0800
Subject: [PATCH 02/23] =?UTF-8?q?feat(ShaderBake):=20=E5=B7=A5=E5=85=B7?=
=?UTF-8?q?=E6=A0=8F=E3=80=8CUV=20=E6=A3=80=E6=9F=A5=E3=80=8D=E5=BC=80?=
=?UTF-8?q?=E5=85=B3=EF=BC=8C=E6=8A=8A=E9=9D=A2=E7=89=87=20UV=20=E7=8A=B6?=
=?UTF-8?q?=E6=80=81=E7=9B=B4=E6=8E=A5=E7=94=BB=E6=88=90=E9=A2=9C=E8=89=B2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
打开后预览换成 UV 视图:红 = U、绿 = V,一格四角应是黑/红/绿/黄,整数边界压暗,
每格一个稳定色相。这样"四角顶点是不是 00 10 01 11"不用靠猜,切换 UV X/Y 时也能
看清是哪一格在动。状态栏的占比在这个视图里量的是"面片盖住多少画面",于是
"相机没框住"和"材质渲不出东西"第一次能分开看。
只换看的那张图:导出、材质属性表、写回原材质仍走真实材质,导出菜单里也写明了这点。
管线自检同时改用这个共用探针,两个视图抢同一个探针位,所以自检会把开关顶掉。
---
Editor/ShaderBake/BakeShaderAsImageWindow.cs | 201 +++++++++++++++----
Editor/ShaderBake/BakeShaderWindow.uxml | 3 +
2 files changed, 160 insertions(+), 44 deletions(-)
diff --git a/Editor/ShaderBake/BakeShaderAsImageWindow.cs b/Editor/ShaderBake/BakeShaderAsImageWindow.cs
index 960b1a0..a2280b6 100644
--- a/Editor/ShaderBake/BakeShaderAsImageWindow.cs
+++ b/Editor/ShaderBake/BakeShaderAsImageWindow.cs
@@ -27,13 +27,18 @@ namespace XericUI.ShaderBake.Editor
private const string kUssPath = "Packages/com.lrss3.xericuiactionvessel/Editor/ShaderBake/BakeShaderWindow.uss";
private const string kRowUxmlPath = "Packages/com.lrss3.xericuiactionvessel/Editor/ShaderBake/BakeShaderPropertyRow.uxml";
private const string kGlobalRowUxmlPath = "Packages/com.lrss3.xericuiactionvessel/Editor/ShaderBake/BakeShaderGlobalRow.uxml";
+ private const string kUvDebugShaderPath = "Packages/com.lrss3.xericuiactionvessel/Editor/ShaderBake/ShaderBakeUVDebug.shader";
private const string kPrefSettings = "XericUI.ShaderBake.Settings";
private const string kPrefAutoRefresh = "XericUI.ShaderBake.AutoRefresh";
private const string kPrefChecker = "XericUI.ShaderBake.Checker";
+ private const string kPrefUvCheck = "XericUI.ShaderBake.UvCheck";
private const string kPrefDetailWidth = "XericUI.ShaderBake.DetailWidth";
private const string kPrefSource = "XericUI.ShaderBake.SourceAsset";
+ /// UV 检查视图用的那张调试 shader(Editor 目录下,见 ShaderBakeUVDebug.shader)
+ private const string kUvDebugShader = "Hidden/XericUI/ShaderBake/UV Debug";
+
private const float kDefaultDetailWidth = 340f;
private static readonly string[] kAntiAliasingChoices = { "1", "2", "4", "8" };
private const string kCustomSize = "自定义";
@@ -58,6 +63,7 @@ namespace XericUI.ShaderBake.Editor
private Button m_ExportButton;
private ToolbarToggle m_AutoRefreshToggle;
private ToolbarToggle m_CheckerToggle;
+ private ToolbarToggle m_UvCheckToggle;
private Label m_StatusMessage;
private Label m_StatusSize;
private Label m_StatusTime;
@@ -71,10 +77,8 @@ namespace XericUI.ShaderBake.Editor
private double m_LastRenderMs = -1;
/// 上一次结果的不透明像素占比,-1 = 没测出来
private float m_LastCoverage = -1f;
- /// 管线自检的探针(活着才能让自检那张图继续显示)
- private ShaderBakeRenderer m_SelfTestProbe;
- private RenderTexture m_SelfTestTarget;
- private Material m_SelfTestMaterial;
+ /// 探针(自检 / UV 检查)活着才能让那张图继续显示;下一次正常渲染时收掉
+ private readonly ShaderBakeOverrideRenderer m_Override = new ShaderBakeOverrideRenderer();
private int m_SelectedFace;
[MenuItem(XericRegistrationPaths.ToolBar + "/Bake Shader As Image", false, 20)]
@@ -143,8 +147,9 @@ namespace XericUI.ShaderBake.Editor
m_PropertyTable.Dispose();
if (m_Preview != null)
m_Preview.Dispose();
+ // 探针那张 RT 归探针所有,先收探针
+ m_Override.Release();
// 临时材质一定要还:它挂着的是 shader,不销毁就是每次开关窗口漏一份
- ReleaseSelfTestTarget();
if (m_Source != null) m_Source.Dispose(true);
if (m_Renderer != null) m_Renderer.Dispose(true);
m_Source = null;
@@ -178,6 +183,7 @@ namespace XericUI.ShaderBake.Editor
m_ExportButton = Require("export-menu");
m_AutoRefreshToggle = Require("auto-refresh");
m_CheckerToggle = Require("show-checker");
+ m_UvCheckToggle = Require("uv-check");
m_StatusMessage = Require