feat(ShaderBake): 测试视图扩成 UV / 梯度 / 棋盘三种,探针常驻

原来只有 UV 一种,量不出"这一格到底占画面多大"。梯度给一把灰度尺,
棋盘给方块与角标,配纯色自检共四种,由 _Mode 选。
探针渲染器改成持有同一个 ShaderBakeRenderer:实时预览每秒重画几十次,
每次新建再销毁材质与网格本身就是一次卡顿;同时把被测的 pass 临时借成 0,
否则用户选的 pass 下标会让纯色探针假报"管线坏了"。
This commit is contained in:
2026-11-06 18:22:13 +08:00
parent e5cf075117
commit 7edb4c3780
2 changed files with 78 additions and 61 deletions
+61 -15
View File
@@ -1,9 +1,10 @@
// UV 状态可视化:把顶点收到的第 0 套 UV 直接当颜色画出来。 // 测试视图:把"这一格面片在画面里到底占多大、铺了哪段 UV"变成一眼能读的颜色。
// 它只吃 uv,不吃贴图、不吃光照,所以"这一格到底铺了哪段 UV"没有第二种解释。 // 三种图都只吃顶点 uv0,不吃贴图、不吃光照、不吃时间,所以画面为空或变形只有几何与 UV 两种原因。
Shader "Hidden/XericUI/ShaderBake/UV Debug" Shader "Hidden/XericUI/ShaderBake/Debug View"
{ {
Properties Properties
{ {
_Mode ("视图(0=UV 1=梯度 2=棋盘)", Float) = 0
_LineThickness ("整数边界线宽", Range(1, 400)) = 90 _LineThickness ("整数边界线宽", Range(1, 400)) = 90
_CellMix ("每格色相强度", Range(0, 1)) = 0.22 _CellMix ("每格色相强度", Range(0, 1)) = 0.22
} }
@@ -12,7 +13,7 @@ Shader "Hidden/XericUI/ShaderBake/UV Debug"
{ {
Tags { "RenderType" = "Opaque" "ForceSupported" = "True" } Tags { "RenderType" = "Opaque" "ForceSupported" = "True" }
// 剔除方向交给 Cull Off:这个视图要回答的是"UV 长什么样", // 剔除方向交给 Cull Off:这些视图要回答的是几何与 UV,
// 不该再被正面约定影响一次,否则空画面时两条原因会搅在一起 // 不该再被正面约定影响一次,否则空画面时两条原因会搅在一起
Cull Off Cull Off
ZWrite Off ZWrite Off
@@ -25,6 +26,7 @@ Shader "Hidden/XericUI/ShaderBake/UV Debug"
#pragma fragment frag #pragma fragment frag
#include "UnityCG.cginc" #include "UnityCG.cginc"
float _Mode;
float _LineThickness; float _LineThickness;
float _CellMix; float _CellMix;
@@ -48,6 +50,19 @@ Shader "Hidden/XericUI/ShaderBake/UV Debug"
return rgb; return rgb;
} }
// 每个整数格给一个稳定色相,相邻格不撞色,混在一起也能数出这是第几格
fixed3 CellHue(float2 cell)
{
return HueToRgb(cell.x * 0.618033 + cell.y * 0.381966);
}
// 整数 UV 边界压暗:格与格之间、UV 单位边界都显出来
float EdgeMask(float2 f)
{
float line = min(min(f.x, 1.0 - f.x), min(f.y, 1.0 - f.y));
return lerp(0.3, 1.0, saturate(line * _LineThickness));
}
v2f vert(appdata v) v2f vert(appdata v)
{ {
v2f o; v2f o;
@@ -56,22 +71,53 @@ Shader "Hidden/XericUI/ShaderBake/UV Debug"
return o; return o;
} }
// UV 视图:红 = U,绿 = V。角点即 UV,一格四角该是 黑(0,0) 红(1,0) 绿(0,1) 黄(1,1)
fixed4 UvView(float2 cell, float2 f)
{
fixed3 col = fixed3(f.x, f.y, 0.06);
col = lerp(col, CellHue(cell), _CellMix);
return fixed4(col * EdgeMask(f), 1.0);
}
// 梯度视图:两条灰度尺。主体沿 U 由黑到白,顶部窄带沿 V 由黑到白,
// 每 0.1 一档压暗。量的是一格铺满之后刻度在画面上跨了多少像素——
// 尺子只占画面中间一小段,就说明相机框的是整个网格而不是这一格
fixed4 GradientView(float2 f)
{
float ruler = lerp(f.x, f.y, step(0.86, f.y));
float tenth = frac(ruler * 10.0);
float tick = min(tenth, 1.0 - tenth);
float gray = ruler * lerp(0.35, 1.0, saturate(tick * 40.0));
gray *= EdgeMask(f);
return fixed4(gray, gray, gray, 1.0);
}
// 棋盘视图:半 UV 一格的棋盘 + 每格一个色相 + 左下角红、右上角蓝。
// 方块变矩形=横竖缩放不等,变平行四边形=斜切或透视,两角换位置=U 或 V 被镜像
fixed4 CheckerView(float2 cell, float2 f)
{
float2 q = floor(f * 2.0);
float check = fmod(q.x + q.y, 2.0);
fixed3 col = CellHue(cell) * (0.2 + 0.8 * check);
// 角标放在格内靠边的一小块,压过棋盘本身
float bottomLeft = max(f.x, f.y);
float topRight = max(1.0 - f.x, 1.0 - f.y);
col = lerp(col, fixed3(1.0, 0.16, 0.16), saturate((0.15 - bottomLeft) * 30.0));
col = lerp(col, fixed3(0.16, 0.4, 1.0), saturate((0.15 - topRight) * 30.0));
return fixed4(col * EdgeMask(f), 1.0);
}
fixed4 frag(v2f i) : SV_Target fixed4 frag(v2f i) : SV_Target
{ {
float2 cell = floor(i.uv); float2 cell = floor(i.uv);
float2 f = i.uv - cell; float2 f = i.uv - cell;
// 角点即 UV:左下黑、右下红(U 到 1)、左上绿(V 到 1)、右上黄。 if (_Mode < 0.5)
// 四角是不是 00 / 10 / 01 / 11,看这个就够了 return UvView(cell, f);
fixed4 col = fixed4(f.x, f.y, 0.06, 1.0); if (_Mode < 1.5)
return GradientView(f);
// 每个整数格给一个稳定色相,相邻格不撞色,混在一起也能数出第几格 return CheckerView(cell, f);
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 ENDCG
} }
+17 -46
View File
@@ -3,17 +3,19 @@ using UnityEngine;
namespace XericUI.ShaderBake.Editor namespace XericUI.ShaderBake.Editor
{ {
/// <summary> /// <summary>
/// 用一张"覆盖材质"按<b>同一套</b>面片 / 相机 / pass 再渲一次的探针。 /// 用一张"覆盖材质"按<b>同一套</b>面片 / 相机再渲一次的探针。
/// ///
/// <para>两处用得上,问的是同一个问题的两面:</para> /// <para>两处用得上,问的是同一个问题的两面:</para>
/// <list type="bullet"> /// <list type="bullet">
/// <item><description>管线自检 —— 内置纯色 shader,回答"画不出来该怪管线还是怪被测 shader"</description></item> /// <item><description>管线自检 —— 内置纯色 shader,回答"画不出来该怪管线还是怪被测 shader"</description></item>
/// <item><description>UV 检查 —— 把顶点 UV 本身画成颜色,回答"这一格到底铺了哪段 UV"</description></item> /// <item><description>测试视图 —— UV / 梯度 / 棋盘,回答"这一格占画面多大、铺了哪段 UV"</description></item>
/// </list> /// </list>
/// ///
/// <para><b>settings 是共享引用,不是副本</b>:探针必须和被测对象同参数,否则比较没有意义。 /// <para><b>settings 是共享引用,不是副本</b>:探针必须和被测对象同参数,否则比较没有意义。
/// 材质只在渲染那一刻需要,画完即可销毁(画面已经在 RT 里,留着只会让人误以为它还在影响显示); /// 材质<b>不归这里所有</b>,由调用方建、由调用方销毁——测试视图那张要设 _Mode,会反复用。</para>
/// RT 由探针自己持有,所以探针要活到下一次正常渲染,那张图才还在。</para> ///
/// <para>探针是<b>常驻</b>的:RT 与网格按签名缓存,持续刷新(实时预览开着时每秒几十次)如果
/// 每次都重建一遍探针,卡顿就来自这里。</para>
/// </summary> /// </summary>
internal sealed class ShaderBakeOverrideRenderer internal sealed class ShaderBakeOverrideRenderer
{ {
@@ -21,7 +23,7 @@ namespace XericUI.ShaderBake.Editor
/// <summary> /// <summary>
/// 探针自己那份网格。参数是共享的,所以顶点数与真实渲染一致——但真实渲染那次未必已经建过网格, /// 探针自己那份网格。参数是共享的,所以顶点数与真实渲染一致——但真实渲染那次未必已经建过网格,
/// UV 视图的读数得能从探针这边拿到,否则状态栏的顶点数会空着。 /// 测试视图的读数得能从探针这边拿到,否则状态栏的顶点数会空着。
/// </summary> /// </summary>
public Mesh geometry public Mesh geometry
{ {
@@ -29,53 +31,28 @@ namespace XericUI.ShaderBake.Editor
} }
/// <summary> /// <summary>
/// 换一张 shader 重画一次。失败返回 null 并把原因写进 <paramref name="error"/>, /// 用给定材质按同一套参数重画一次。失败返回 null 并把原因写进 <paramref name="error"/>。
/// 成功时旧探针已经换新,之前那张图随之作废。
/// </summary>
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;
}
/// <summary>
/// 用调用方给的那张材质重画一次。材质<b>不归这里所有</b>,画完由调用方销毁——
/// 自检那张纯色材质要先设颜色,只能由调用方建。
/// </summary> /// </summary>
public RenderTexture RenderWithMaterial(ShaderBakeSettings settings, Material material, out string error) public RenderTexture RenderWithMaterial(ShaderBakeSettings settings, Material material, out string error)
{ {
error = string.Empty; error = string.Empty;
Release(); if (settings == null || material == null)
if (settings == null)
{ {
error = "没有参数可渲"; error = material == null ? "探针材质还没建起来" : "没有参数可渲";
return null; return null;
} }
// 探针这两张 shader 都只有一个 pass。用户填的 pass 下标是给被测 shader 的,原样传过来 if (m_Probe == null)
// 只会让探针画成空画面,于是"pass 选错"被误诊成"管线坏了"。 m_Probe = new ShaderBakeRenderer { settings = settings };
// 这里只借 settings 用一次,出来就还原,不会把改动留在共享对象上。 m_Probe.material = material;
// 探针 shader 只有一个 pass,用户填的 pass 下标是给被测 shader 的,照抄过来只会画成空画面,
// 于是"pass 选错"被误诊成"管线坏了"。这里只借 settings 用一次,出来就还原。
int subjectPass = settings.output.shaderPass; int subjectPass = settings.output.shaderPass;
settings.output.shaderPass = 0; settings.output.shaderPass = 0;
RenderTexture rt; RenderTexture rt;
try try
{ {
m_Probe = new ShaderBakeRenderer { settings = settings, material = material };
rt = m_Probe.Render(); rt = m_Probe.Render();
if (rt == null) if (rt == null)
error = m_Probe.lastError; error = m_Probe.lastError;
@@ -84,16 +61,10 @@ namespace XericUI.ShaderBake.Editor
{ {
settings.output.shaderPass = subjectPass; settings.output.shaderPass = subjectPass;
} }
if (rt == null)
{
Release();
return null;
}
return rt; return rt;
} }
/// <summary> 收掉探针,连带它那张 RT。下一次真实渲染结果回来时调用 </summary> /// <summary> 收掉探针,连带它那张 RT 与网格。关窗口时调用 </summary>
public void Release() public void Release()
{ {
if (m_Probe == null) if (m_Probe == null)