feat(ShaderBake): 不透明覆盖率读数、管线自检与贴图 ST 归位

"画面是棋盘格"这件事有两种完全不同的成因——什么都没画出来,和画出来但 alpha 为 0,
以前只能靠猜。现在:
- 每次渲染后降采样测一次不透明占比,写进预览读数和状态栏;
- 「管线自检」用 Unlit/Color 按同一套面片/相机/pass 再画一次,把问题分到管线还是被测 shader;
- 脚本造的临时材质里 Tiling 为 0 的贴图属性会被归位为 1(那等于把四个顶点 UV 乘成同一个点),
  并在属性表提示还有几张贴图没指定。
This commit is contained in:
2026-11-06 08:19:46 +08:00
parent dc5f2adae9
commit 632197b50e
5 changed files with 275 additions and 4 deletions
+138 -2
View File
@@ -69,6 +69,12 @@ namespace XericUI.ShaderBake.Editor
private bool m_RenderPending; private bool m_RenderPending;
private double m_LastRenderMs = -1; private double m_LastRenderMs = -1;
/// <summary> 上一次结果的不透明像素占比,-1 = 没测出来 </summary>
private float m_LastCoverage = -1f;
/// <summary> 管线自检的探针(活着才能让自检那张图继续显示) </summary>
private ShaderBakeRenderer m_SelfTestProbe;
private RenderTexture m_SelfTestTarget;
private Material m_SelfTestMaterial;
private int m_SelectedFace; private int m_SelectedFace;
[MenuItem(XericRegistrationPaths.ToolBar + "/Bake Shader As Image", false, 20)] [MenuItem(XericRegistrationPaths.ToolBar + "/Bake Shader As Image", false, 20)]
@@ -138,6 +144,7 @@ namespace XericUI.ShaderBake.Editor
if (m_Preview != null) if (m_Preview != null)
m_Preview.Dispose(); m_Preview.Dispose();
// 临时材质一定要还:它挂着的是 shader,不销毁就是每次开关窗口漏一份 // 临时材质一定要还:它挂着的是 shader,不销毁就是每次开关窗口漏一份
ReleaseSelfTestTarget();
if (m_Source != null) m_Source.Dispose(true); if (m_Source != null) m_Source.Dispose(true);
if (m_Renderer != null) m_Renderer.Dispose(true); if (m_Renderer != null) m_Renderer.Dispose(true);
m_Source = null; m_Source = null;
@@ -410,11 +417,16 @@ namespace XericUI.ShaderBake.Editor
if (m_PropertyTable == null) if (m_PropertyTable == null)
return; return;
m_PropertyTable.SetTarget(m_Source.shader, m_Source.material); m_PropertyTable.SetTarget(m_Source.shader, m_Source.material);
string textureHint = ShaderBakePropertyTable.RepairTextureScale(m_Source.shader, m_Source.material);
Label note = rootVisualElement.Q<Label>("props-note"); Label note = rootVisualElement.Q<Label>("props-note");
if (note != null) if (note != null)
{
note.text = m_Source.shader == null note.text = m_Source.shader == null
? "未指定 shader" ? "未指定 shader"
: (m_PropertyTable.rowCount + " 项可编辑属性(隐藏属性不列出)"); : (m_PropertyTable.rowCount + " 项可编辑属性(隐藏属性不列出)");
if (!string.IsNullOrEmpty(textureHint))
note.text += "\n" + textureHint;
}
// 只有"来源是材质"才有可写回/可回读的原资产 // 只有"来源是材质"才有可写回/可回读的原资产
SetApplyRevertEnabled(m_Source.sourceMaterial != null); SetApplyRevertEnabled(m_Source.sourceMaterial != null);
} }
@@ -635,12 +647,30 @@ namespace XericUI.ShaderBake.Editor
{ {
faceInfo.text = meshMode faceInfo.text = meshMode
? "外部网格不参与面片点选" ? "外部网格不参与面片点选"
: "选中第 " + (m_SelectedFace + 1) + " 格:UV (" + cell.uvX + ", " + cell.uvY + ")"; : "选中第 " + (m_SelectedFace + 1) + " 格:UV (" + cell.uvX + ", " + cell.uvY + ")\n" +
FaceCornerText(surface, cell);
} }
SetFaceFieldsEnabled(!meshMode); SetFaceFieldsEnabled(!meshMode);
UpdateFaceOverlay(); UpdateFaceOverlay();
} }
/// <summary>
/// 这一格四个顶点的实际 UV 写出来。"设为 UV0" 的约定就是四角落在 (0,0)(1,0)(0,1)(1,1),
/// 再乘重复、加偏移;把结果摊开显示,是不是这个范围一眼就能核对。
/// </summary>
private static string FaceCornerText(ShaderBakeSurfaceSettings surface, ShaderBakeFaceCell cell)
{
Vector2 min = Vector2.Scale(new Vector2(cell.uvX, cell.uvY), surface.uvTiling) + surface.uvOffset;
Vector2 max = Vector2.Scale(new Vector2(cell.uvX + 1, cell.uvY + 1), surface.uvTiling) + surface.uvOffset;
return "四角 UV:(" + Corners(min.x, max.x) + ", " + Corners(min.y, max.y) + ")";
}
/// <summary> 一个轴的两个角值,左下在前 </summary>
private static string Corners(float low, float high)
{
return low.ToString("0.##") + " / " + high.ToString("0.##");
}
private void SetFaceFieldsEnabled(bool enabled) private void SetFaceFieldsEnabled(bool enabled)
{ {
VisualElement x = rootVisualElement.Q<VisualElement>("face-uv-x"); VisualElement x = rootVisualElement.Q<VisualElement>("face-uv-x");
@@ -708,6 +738,7 @@ namespace XericUI.ShaderBake.Editor
BindInt("surf-submesh", () => m_Renderer.settings.surface.meshSubMesh, v => m_Renderer.settings.surface.meshSubMesh = v); BindInt("surf-submesh", () => m_Renderer.settings.surface.meshSubMesh, v => m_Renderer.settings.surface.meshSubMesh = v);
BindBool("surf-normalize", () => m_Renderer.settings.surface.normalizeMeshSize, v => m_Renderer.settings.surface.normalizeMeshSize = v); BindBool("surf-normalize", () => m_Renderer.settings.surface.normalizeMeshSize, v => m_Renderer.settings.surface.normalizeMeshSize = v);
BindBool("surf-uv-st", () => m_Renderer.settings.surface.applyUvToMainTexST, v => m_Renderer.settings.surface.applyUvToMainTexST = v); BindBool("surf-uv-st", () => m_Renderer.settings.surface.applyUvToMainTexST, v => m_Renderer.settings.surface.applyUvToMainTexST = v);
BindBool("surf-double-sided", () => m_Renderer.settings.surface.doubleSided, v => m_Renderer.settings.surface.doubleSided = v);
ObjectField meshField = rootVisualElement.Q<ObjectField>("surf-mesh"); ObjectField meshField = rootVisualElement.Q<ObjectField>("surf-mesh");
if (meshField != null) if (meshField != null)
@@ -821,6 +852,7 @@ namespace XericUI.ShaderBake.Editor
BindFloat("cam-rot-y", () => m_Renderer.settings.camera.eulerAngles.y, v => SetCamRot(m_Renderer.settings.camera.eulerAngles.x, v, m_Renderer.settings.camera.eulerAngles.z)); BindFloat("cam-rot-y", () => m_Renderer.settings.camera.eulerAngles.y, v => SetCamRot(m_Renderer.settings.camera.eulerAngles.x, v, m_Renderer.settings.camera.eulerAngles.z));
BindFloat("cam-rot-z", () => m_Renderer.settings.camera.eulerAngles.z, v => SetCamRot(m_Renderer.settings.camera.eulerAngles.x, m_Renderer.settings.camera.eulerAngles.y, v)); BindFloat("cam-rot-z", () => m_Renderer.settings.camera.eulerAngles.z, v => SetCamRot(m_Renderer.settings.camera.eulerAngles.x, m_Renderer.settings.camera.eulerAngles.y, v));
Click("cam-fit", FitCamera); Click("cam-fit", FitCamera);
Click("cam-selftest", RunPipelineSelfTest);
} }
private void SetCamPos(float x, float y, float z) { m_Renderer.settings.camera.position = new Vector3(x, y, z); } private void SetCamPos(float x, float y, float z) { m_Renderer.settings.camera.position = new Vector3(x, y, z); }
@@ -833,6 +865,93 @@ namespace XericUI.ShaderBake.Editor
SetStatus("相机已框住面片"); SetStatus("相机已框住面片");
} }
/// <summary>
/// 用一个不吃贴图、不吃光照、不吃 UV 的内置纯色 shader,按<b>同一套</b>面片/相机/pass 再画一次。
/// 画得出来就说明管线是通的,画面空的原因在被测 shader 那边(贴图没指定、pass、混合模式);
/// 画不出来才是这里的问题(相机框不住、面片尺寸、pass 下标)。
/// </summary>
private void RunPipelineSelfTest()
{
Shader solid = Shader.Find("Unlit/Color");
if (solid == null)
{
SetSelfTestNote("自检不可用:这个工程里找不到 Unlit/Color");
return;
}
ReleaseSelfTestTarget();
var probeMaterial = new Material(solid)
{
name = "ShaderBakeSelfTest",
hideFlags = HideFlags.DontSave
};
probeMaterial.color = new Color(0.25f, 0.85f, 0.5f);
float coverage = -1f;
string failure = string.Empty;
// settings 是共享引用:自检必须和被测走同一套面片/相机/pass,才有控制变量的意义。
// 探针还要活着:它一 Dispose 就把那张 RT 一起销毁了,而自检结果正是那张图。
// 下一次正常渲染或关窗口时由 ReleaseSelfTestTarget 收掉。
m_SelfTestMaterial = probeMaterial;
m_SelfTestProbe = new ShaderBakeRenderer { settings = m_Renderer.settings, material = probeMaterial };
try
{
RenderTexture rt = m_SelfTestProbe.Render();
if (rt == null)
failure = m_SelfTestProbe.lastError;
else
{
Color average;
if (ShaderBakeReadback.MeasureCoverage(rt, out coverage, out average))
{
// 把纯色结果直接显示出来:数字说有像素,眼睛说看到什么,两边对上才算过
m_SelfTestTarget = rt;
m_Preview.SetResult(rt, m_Renderer.settings.output.size);
m_Preview.SetCoverage(coverage, average);
}
}
}
catch (Exception evt)
{
failure = evt.Message;
}
if (!string.IsNullOrEmpty(failure))
{
SetSelfTestNote("自检失败:" + failure);
return;
}
if (coverage <= 0.001f)
{
SetSelfTestNote("自检未画出任何像素 → 问题在渲染管线本身。先按「框住面片」,再看面片宽高、pass 下标与翻转 Y");
SetStatus("管线自检:空画面");
return;
}
SetSelfTestNote("自检通过:纯色面片不透明 " + Mathf.RoundToInt(coverage * 100f) +
"%。管线是通的,画面空是被测 shader 自己的事(贴图、pass、混合模式、需要光照)");
SetStatus("管线自检:正常");
}
private void SetSelfTestNote(string text)
{
Label note = rootVisualElement.Q<Label>("selftest-note");
if (note != null)
note.text = text;
}
private void ReleaseSelfTestTarget()
{
// 探针自己会回收那张 RT,所以先释放探针、再清引用,别两边各销毁一次
if (m_SelfTestProbe != null)
{
m_SelfTestProbe.Dispose(true);
m_SelfTestProbe = null;
m_SelfTestTarget = null;
}
ShaderBakeRenderer.ReleaseTempObject(m_SelfTestMaterial, true);
m_SelfTestMaterial = null;
}
// ── 右侧细节栏宽度 ────────────────────────────────────── // ── 右侧细节栏宽度 ──────────────────────────────────────
private void BindDetailSplit() private void BindDetailSplit()
@@ -1004,6 +1123,8 @@ namespace XericUI.ShaderBake.Editor
m_RenderPending = false; m_RenderPending = false;
if (m_Renderer == null || m_Preview == null) if (m_Renderer == null || m_Preview == null)
return; return;
// 真实结果回来了,自检那张临时图就该退场
ReleaseSelfTestTarget();
double start = EditorApplication.timeSinceStartup; double start = EditorApplication.timeSinceStartup;
RenderTexture rt = m_Renderer.Render(); RenderTexture rt = m_Renderer.Render();
@@ -1018,6 +1139,11 @@ namespace XericUI.ShaderBake.Editor
} }
m_Preview.SetResult(rt, m_Renderer.settings.output.size); m_Preview.SetResult(rt, m_Renderer.settings.output.size);
float coverage;
Color average;
m_LastCoverage = ShaderBakeReadback.MeasureCoverage(rt, out coverage, out average) ? coverage : -1f;
if (m_LastCoverage >= 0f)
m_Preview.SetCoverage(m_LastCoverage, average);
UpdateFaceOverlay(); UpdateFaceOverlay();
UpdateSizeReadout(); UpdateSizeReadout();
if (string.IsNullOrEmpty(m_StatusMessage.text) || m_StatusMessage.text.StartsWith("导出")) if (string.IsNullOrEmpty(m_StatusMessage.text) || m_StatusMessage.text.StartsWith("导出"))
@@ -1042,7 +1168,17 @@ namespace XericUI.ShaderBake.Editor
return; return;
if (m_StatusMessage.text.StartsWith("导出") || m_StatusMessage.text.StartsWith("参数已改")) if (m_StatusMessage.text.StartsWith("导出") || m_StatusMessage.text.StartsWith("参数已改"))
return; return;
m_StatusMessage.text = "已渲染 · " + mesh.vertexCount + " 顶点"; m_StatusMessage.text = "已渲染 · " + mesh.vertexCount + " 顶点" + CoverageHint();
}
/// <summary> 状态栏的覆盖率后缀:把"看着像没渲染"拆成"没画出来"和"画出来但是透明的" </summary>
private string CoverageHint()
{
if (m_LastCoverage < 0f)
return string.Empty;
if (m_LastCoverage <= 0.001f)
return " · 全透明,一个像素都没画出";
return " · 不透明 " + Mathf.RoundToInt(m_LastCoverage * 100f) + "%";
} }
private void SetStatus(string message) private void SetStatus(string message)
+7 -1
View File
@@ -154,6 +154,7 @@
<xer:IntegerField name="surf-submesh" label="SubMesh" class="field-full" /> <xer:IntegerField name="surf-submesh" label="SubMesh" class="field-full" />
<ui:Toggle name="surf-normalize" label="适配尺寸" class="field-toggle" /> <ui:Toggle name="surf-normalize" label="适配尺寸" class="field-toggle" />
<ui:Toggle name="surf-uv-st" label="写 _MainTex_ST" class="field-toggle" /> <ui:Toggle name="surf-uv-st" label="写 _MainTex_ST" class="field-toggle" />
<ui:Toggle name="surf-double-sided" label="双面绘制" class="field-toggle" />
<ui:VisualElement class="field-row"> <ui:VisualElement class="field-row">
<ui:Button name="surf-reset" text="面片归位" class="field-half" /> <ui:Button name="surf-reset" text="面片归位" class="field-half" />
<ui:Button name="surf-pick-scene" text="取选中物体" class="field-half" /> <ui:Button name="surf-pick-scene" text="取选中物体" class="field-half" />
@@ -190,7 +191,12 @@
<xer:FloatField name="cam-rot-y" label="Y" class="field-third" /> <xer:FloatField name="cam-rot-y" label="Y" class="field-third" />
<xer:FloatField name="cam-rot-z" label="Z" class="field-third" /> <xer:FloatField name="cam-rot-z" label="Z" class="field-third" />
</ui:VisualElement> </ui:VisualElement>
<ui:Button name="cam-fit" text="框住面片" class="field-full" /> <ui:VisualElement class="field-row">
<ui:Button name="cam-fit" text="框住面片" class="field-half" />
<ui:Button name="cam-selftest" text="管线自检" class="field-half" />
</ui:VisualElement>
<ui:Label name="selftest-note" class="field-note"
text="自检:用不依赖贴图与光照的内置纯色 shader 按同一套矩阵画一次,用来分清是渲染管线的问题还是被测 shader 本身的问题" />
</ui:VisualElement> </ui:VisualElement>
</ui:VisualElement> </ui:VisualElement>
+31 -1
View File
@@ -38,6 +38,10 @@ namespace XericUI.ShaderBake.Editor
private Vector2 m_DragStart; private Vector2 m_DragStart;
private Vector2 m_ScrollStart; private Vector2 m_ScrollStart;
/// <summary> 上一次渲染的不透明像素占比,-1 = 还没测过 </summary>
private float m_CoverageRatio = -1f;
private Color m_CoverageColor = Color.clear;
/// <summary> 当前缩放倍率(1 = 一个像素对应屏幕一个点) </summary> /// <summary> 当前缩放倍率(1 = 一个像素对应屏幕一个点) </summary>
public float zoom { get { return m_Zoom; } } public float zoom { get { return m_Zoom; } }
@@ -137,9 +141,21 @@ namespace XericUI.ShaderBake.Editor
m_FaceOverlayLabel.text = label; m_FaceOverlayLabel.text = label;
} }
/// <summary>
/// 报告这次结果里有多少像素不是全透明。看图时最先要确认的就是"到底画没画出来",
/// 而棋盘格背景会让"没画"和"画了个透明的"看起来完全一样。
/// </summary>
public void SetCoverage(float opaqueRatio, Color averageColor)
{
m_CoverageRatio = opaqueRatio;
m_CoverageColor = averageColor;
UpdateReadout();
}
public void Clear() public void Clear()
{ {
m_PixelSize = Vector2Int.zero; m_PixelSize = Vector2Int.zero;
m_CoverageRatio = -1f;
m_Image.style.backgroundImage = new StyleBackground(StyleKeyword.None); m_Image.style.backgroundImage = new StyleBackground(StyleKeyword.None);
UpdateReadout(); UpdateReadout();
} }
@@ -187,7 +203,21 @@ namespace XericUI.ShaderBake.Editor
return; return;
} }
m_Readout.text = m_PixelSize.x + " × " + m_PixelSize.y + " px " + m_Readout.text = m_PixelSize.x + " × " + m_PixelSize.y + " px " +
(m_Zoom * 100f).ToString("0.#") + "%"; (m_Zoom * 100f).ToString("0.#") + "%" + CoverageText();
// 全透明是"这次什么都没画出来"的信号,值得比别的读数更抢眼一点
m_Readout.style.color = new StyleColor(m_PixelSize.x > 0 && m_CoverageRatio <= 0.001f
? new Color(0.98f, 0.51f, 0.41f)
: new Color(0.86f, 0.86f, 0.86f));
}
/// <summary> 覆盖率后缀;没测过就不占字数 </summary>
private string CoverageText()
{
if (m_CoverageRatio < 0f)
return string.Empty;
if (m_CoverageRatio <= 0.001f)
return " 全透明(没画出像素)";
return " 不透明 " + Mathf.RoundToInt(m_CoverageRatio * 100f) + "%";
} }
private void OnViewportGeometry(GeometryChangedEvent evt) private void OnViewportGeometry(GeometryChangedEvent evt)
@@ -140,6 +140,49 @@ namespace XericUI.ShaderBake.Editor
m_Container.Clear(); m_Container.Clear();
} }
/// <summary>
/// 修一处脚本造材质的老坑:贴图属性的 Tiling 为 0 时,shader 里的 <c>uv * _MainTex_ST</c>
/// 会把四个顶点全乘成同一个点——整片只剩一个颜色,看上去就像"UV 没设置"。
/// 只动这张临时副本,顺手把"没指定贴图"的数量数出来给界面当提示。
/// </summary>
public static string RepairTextureScale(Shader shader, Material material)
{
if (shader == null || material == null)
return string.Empty;
int normalized = 0;
int missing = 0;
int count = ShaderUtil.GetPropertyCount(shader);
for (int i = 0; i < count; i++)
{
if ((ShaderPropertyType)(int)ShaderUtil.GetPropertyType(shader, i) != ShaderPropertyType.Texture)
continue;
string name = ShaderUtil.GetPropertyName(shader, i);
if (material.GetTexture(name) == null)
missing++;
string scaleOffset = name + "_ST";
if (!material.HasProperty(scaleOffset))
continue;
Vector4 st = material.GetVector(scaleOffset);
if (st.x != 0f && st.y != 0f)
continue;
material.SetVector(scaleOffset, new Vector4(
st.x == 0f ? 1f : st.x, st.y == 0f ? 1f : st.y, st.z, st.w));
normalized++;
}
var note = new System.Text.StringBuilder();
if (normalized > 0)
note.Append(normalized + " 项贴图 Tiling 为 0,已归一为 1");
if (missing > 0)
{
if (note.Length > 0)
note.Append(" · ");
note.Append(missing + " 项贴图未指定(采样为空,渲出来会是透明)");
}
return note.ToString();
}
// ── 建行 ──────────────────────────────────────────────── // ── 建行 ────────────────────────────────────────────────
private Row CreateRow(int propIndex) private Row CreateRow(int propIndex)
+56
View File
@@ -78,6 +78,62 @@ namespace XericUI.ShaderBake
return flattened; return flattened;
} }
/// <summary>
/// 结果统计:把目标降采样到 64×64 再读回,算出"有不透明像素的比例"和它们的平均颜色。
///
/// <para><b>为什么值得花这一次读回</b>:离屏烘焙最常见的两种失败——"什么都没画出来"(剔除、
/// pass、相机框不住)与"画出来了但 alpha 是 0"(贴图没指定、混合模式吃掉颜色)——在预览里
/// 长得一模一样,都是棋盘格。有一个数字就能把它们分开。</para>
/// </summary>
public static bool MeasureCoverage(RenderTexture source, out float opaqueRatio, out Color averageColor)
{
opaqueRatio = 0f;
averageColor = Color.clear;
if (source == null || !source.IsCreated())
return false;
const int side = 64;
RenderTexture previous = RenderTexture.active;
RenderTexture small = RenderTexture.GetTemporary(side, side, 0,
RenderTextureFormat.ARGB32, RenderTextureReadWrite.Linear);
var probe = new Texture2D(side, side, TextureFormat.RGBA32, false, true)
{
hideFlags = HideFlags.DontSave
};
try
{
// 用 GetTemporary 而不是自己建:省掉一次显存分配,也躲开"目标正在被显示"的占用冲突
Graphics.Blit(source, small);
RenderTexture.active = small;
probe.ReadPixels(new Rect(0, 0, side, side), 0, 0, false);
probe.Apply(false);
Color32[] pixels = probe.GetPixels32();
int opaque = 0;
float r = 0f, g = 0f, b = 0f;
for (int i = 0; i < pixels.Length; i++)
{
// 阈值 8/255:线性插值边缘那一圈极淡的像素不该算成"画出来了"
if (pixels[i].a <= 8)
continue;
opaque++;
r += pixels[i].r;
g += pixels[i].g;
b += pixels[i].b;
}
opaqueRatio = (float)opaque / pixels.Length;
if (opaque > 0)
averageColor = new Color(r / opaque / 255f, g / opaque / 255f, b / opaque / 255f, 1f);
return true;
}
finally
{
RenderTexture.active = previous;
RenderTexture.ReleaseTemporary(small);
ShaderBakeRenderer.ReleaseTempObject(probe);
}
}
/// <summary> /// <summary>
/// 把一张纹理/RT 画成 Sprite。注意 Sprite 不拥有纹理:纹理销毁了 Sprite 就空了, /// 把一张纹理/RT 画成 Sprite。注意 Sprite 不拥有纹理:纹理销毁了 Sprite 就空了,
/// 所以调用方要么留着纹理,要么连纹理一起作为资产存下来。 /// 所以调用方要么留着纹理,要么连纹理一起作为资产存下来。