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