feat(ShaderBake): 加 UV 调试 shader 与共用探针渲染器

UV 检查视图要把"这一格铺了哪段 UV"变成一眼能读的颜色,而自检和它问的是同一个
问题的两面,所以把"按同一套参数换张材质再渲一次"抽成 ShaderBakeOverrideRenderer,
两处共用。pass 下标在这里固定成 0:探针 shader 只有一个 pass,照抄用户的下标只会
把"pass 选错"误诊成"管线坏了"。
This commit is contained in:
2026-11-06 17:55:35 +08:00
parent 7ce5a96f47
commit 550d659987
4 changed files with 207 additions and 0 deletions
@@ -0,0 +1,106 @@
using UnityEngine;
namespace XericUI.ShaderBake.Editor
{
/// <summary>
/// 用一张"覆盖材质"按<b>同一套</b>面片 / 相机 / pass 再渲一次的探针。
///
/// <para>两处用得上,问的是同一个问题的两面:</para>
/// <list type="bullet">
/// <item><description>管线自检 —— 内置纯色 shader,回答"画不出来该怪管线还是怪被测 shader"</description></item>
/// <item><description>UV 检查 —— 把顶点 UV 本身画成颜色,回答"这一格到底铺了哪段 UV"</description></item>
/// </list>
///
/// <para><b>settings 是共享引用,不是副本</b>:探针必须和被测对象同参数,否则比较没有意义。
/// 材质只在渲染那一刻需要,画完即可销毁(画面已经在 RT 里,留着只会让人误以为它还在影响显示);
/// RT 由探针自己持有,所以探针要活到下一次正常渲染,那张图才还在。</para>
/// </summary>
internal sealed class ShaderBakeOverrideRenderer
{
private ShaderBakeRenderer m_Probe;
/// <summary>
/// 探针自己那份网格。参数是共享的,所以顶点数与真实渲染一致——但真实渲染那次未必已经建过网格,
/// UV 视图的读数得能从探针这边拿到,否则状态栏的顶点数会空着。
/// </summary>
public Mesh geometry
{
get { return m_Probe != null ? m_Probe.geometry : null; }
}
/// <summary>
/// 换一张 shader 重画一次。失败返回 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>
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;
}
/// <summary> 收掉探针,连带它那张 RT。下一次真实渲染结果回来时调用 </summary>
public void Release()
{
if (m_Probe == null)
return;
// 探针自己回收那张 RT,所以只走它一条路,别两边各销毁一次
m_Probe.Dispose(true);
m_Probe = null;
}
}
}
@@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: 7c4b2f19ae0d48f5b3c16d9e0a4f2b57
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant:
@@ -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
}
@@ -0,0 +1,9 @@
fileFormatVersion: 2
guid: b69a9a69ca9a6930caa8808a0c91f009
ShaderImporter:
externalObjects: {}
defaultTextures: []
nonModifiableTextures: []
userData:
assetBundleName:
assetBundleVariant: