feat(ShaderBake): 不透明覆盖率读数、管线自检与贴图 ST 归位
"画面是棋盘格"这件事有两种完全不同的成因——什么都没画出来,和画出来但 alpha 为 0, 以前只能靠猜。现在: - 每次渲染后降采样测一次不透明占比,写进预览读数和状态栏; - 「管线自检」用 Unlit/Color 按同一套面片/相机/pass 再画一次,把问题分到管线还是被测 shader; - 脚本造的临时材质里 Tiling 为 0 的贴图属性会被归位为 1(那等于把四个顶点 UV 乘成同一个点), 并在属性表提示还有几张贴图没指定。
This commit is contained in:
@@ -69,6 +69,12 @@ namespace XericUI.ShaderBake.Editor
|
||||
|
||||
private bool m_RenderPending;
|
||||
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;
|
||||
|
||||
[MenuItem(XericRegistrationPaths.ToolBar + "/Bake Shader As Image", false, 20)]
|
||||
@@ -138,6 +144,7 @@ namespace XericUI.ShaderBake.Editor
|
||||
if (m_Preview != null)
|
||||
m_Preview.Dispose();
|
||||
// 临时材质一定要还:它挂着的是 shader,不销毁就是每次开关窗口漏一份
|
||||
ReleaseSelfTestTarget();
|
||||
if (m_Source != null) m_Source.Dispose(true);
|
||||
if (m_Renderer != null) m_Renderer.Dispose(true);
|
||||
m_Source = null;
|
||||
@@ -410,11 +417,16 @@ namespace XericUI.ShaderBake.Editor
|
||||
if (m_PropertyTable == null)
|
||||
return;
|
||||
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");
|
||||
if (note != null)
|
||||
{
|
||||
note.text = m_Source.shader == null
|
||||
? "未指定 shader"
|
||||
: (m_PropertyTable.rowCount + " 项可编辑属性(隐藏属性不列出)");
|
||||
if (!string.IsNullOrEmpty(textureHint))
|
||||
note.text += "\n" + textureHint;
|
||||
}
|
||||
// 只有"来源是材质"才有可写回/可回读的原资产
|
||||
SetApplyRevertEnabled(m_Source.sourceMaterial != null);
|
||||
}
|
||||
@@ -635,12 +647,30 @@ namespace XericUI.ShaderBake.Editor
|
||||
{
|
||||
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);
|
||||
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)
|
||||
{
|
||||
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);
|
||||
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-double-sided", () => m_Renderer.settings.surface.doubleSided, v => m_Renderer.settings.surface.doubleSided = v);
|
||||
|
||||
ObjectField meshField = rootVisualElement.Q<ObjectField>("surf-mesh");
|
||||
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-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-selftest", RunPipelineSelfTest);
|
||||
}
|
||||
|
||||
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("相机已框住面片");
|
||||
}
|
||||
|
||||
/// <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()
|
||||
@@ -1004,6 +1123,8 @@ namespace XericUI.ShaderBake.Editor
|
||||
m_RenderPending = false;
|
||||
if (m_Renderer == null || m_Preview == null)
|
||||
return;
|
||||
// 真实结果回来了,自检那张临时图就该退场
|
||||
ReleaseSelfTestTarget();
|
||||
|
||||
double start = EditorApplication.timeSinceStartup;
|
||||
RenderTexture rt = m_Renderer.Render();
|
||||
@@ -1018,6 +1139,11 @@ namespace XericUI.ShaderBake.Editor
|
||||
}
|
||||
|
||||
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();
|
||||
UpdateSizeReadout();
|
||||
if (string.IsNullOrEmpty(m_StatusMessage.text) || m_StatusMessage.text.StartsWith("导出"))
|
||||
@@ -1042,7 +1168,17 @@ namespace XericUI.ShaderBake.Editor
|
||||
return;
|
||||
if (m_StatusMessage.text.StartsWith("导出") || m_StatusMessage.text.StartsWith("参数已改"))
|
||||
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)
|
||||
|
||||
@@ -154,6 +154,7 @@
|
||||
<xer:IntegerField name="surf-submesh" label="SubMesh" class="field-full" />
|
||||
<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-double-sided" label="双面绘制" class="field-toggle" />
|
||||
<ui:VisualElement class="field-row">
|
||||
<ui:Button name="surf-reset" 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-z" label="Z" class="field-third" />
|
||||
</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>
|
||||
|
||||
|
||||
@@ -38,6 +38,10 @@ namespace XericUI.ShaderBake.Editor
|
||||
private Vector2 m_DragStart;
|
||||
private Vector2 m_ScrollStart;
|
||||
|
||||
/// <summary> 上一次渲染的不透明像素占比,-1 = 还没测过 </summary>
|
||||
private float m_CoverageRatio = -1f;
|
||||
private Color m_CoverageColor = Color.clear;
|
||||
|
||||
/// <summary> 当前缩放倍率(1 = 一个像素对应屏幕一个点) </summary>
|
||||
public float zoom { get { return m_Zoom; } }
|
||||
|
||||
@@ -137,9 +141,21 @@ namespace XericUI.ShaderBake.Editor
|
||||
m_FaceOverlayLabel.text = label;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 报告这次结果里有多少像素不是全透明。看图时最先要确认的就是"到底画没画出来",
|
||||
/// 而棋盘格背景会让"没画"和"画了个透明的"看起来完全一样。
|
||||
/// </summary>
|
||||
public void SetCoverage(float opaqueRatio, Color averageColor)
|
||||
{
|
||||
m_CoverageRatio = opaqueRatio;
|
||||
m_CoverageColor = averageColor;
|
||||
UpdateReadout();
|
||||
}
|
||||
|
||||
public void Clear()
|
||||
{
|
||||
m_PixelSize = Vector2Int.zero;
|
||||
m_CoverageRatio = -1f;
|
||||
m_Image.style.backgroundImage = new StyleBackground(StyleKeyword.None);
|
||||
UpdateReadout();
|
||||
}
|
||||
@@ -187,7 +203,21 @@ namespace XericUI.ShaderBake.Editor
|
||||
return;
|
||||
}
|
||||
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)
|
||||
|
||||
@@ -140,6 +140,49 @@ namespace XericUI.ShaderBake.Editor
|
||||
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)
|
||||
|
||||
@@ -78,6 +78,62 @@ namespace XericUI.ShaderBake
|
||||
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>
|
||||
/// 把一张纹理/RT 画成 Sprite。注意 Sprite 不拥有纹理:纹理销毁了 Sprite 就空了,
|
||||
/// 所以调用方要么留着纹理,要么连纹理一起作为资产存下来。
|
||||
|
||||
Reference in New Issue
Block a user