feat(ShaderBake): runtime 侧把 shader 渲成 RT/Texture2D/Sprite/文件字节

离屏渲染走 CommandBuffer + 自建视图投影矩阵,不往场景塞相机和 GameObject,
代价是 API 相关的 Y 翻转要露成一个开关(output.flipY);灯光/雾/阴影不参与,
所以光照类 shader 会渲成无灯效果,这一点写在注释里而不是假装支持。

外部网格一律复制到新网格再改 UV:直接改 MeshFilter.sharedMesh 等于改了项目资产。
This commit is contained in:
2026-11-05 15:59:02 +08:00
parent a311c417be
commit 63173c6ec2
10 changed files with 1361 additions and 0 deletions
+268
View File
@@ -0,0 +1,268 @@
using System;
using UnityEngine;
using UnityEngine.Rendering;
namespace XericUI.ShaderBake
{
/// <summary>
/// 把材质渲染成图的执行者。<b>运行时与编辑器都能用</b>:全程不碰 UnityEditor,
/// 不往场景里放相机或 GameObject——离屏渲染靠 CommandBuffer 自带视图/投影矩阵。
///
/// <para><b>用法</b>:<c>using (var r = new ShaderBakeRenderer(mat)) { var tex = r.RenderToTexture2D(); ... }</c>,
/// 或者常驻一个实例反复改 <see cref="settings"/> 再 <see cref="Render"/>(预览就是这条路)。</para>
///
/// <para><b>已知的渲染环境限制</b>:没有真实相机,于是灯光、雾、环境光、阴影都不参与——
/// Unlit 类 shader 效果一致,Surface/光照类 shader 会渲成"无灯"。要带光照请改用场景相机截帧,
/// 那是另一条路,这里不假装支持。</para>
/// </summary>
public sealed class ShaderBakeRenderer : IDisposable
{
/// <summary> 怎么渲。外部可以直接改这个对象里的字段,改完调用 Render 就会跟着生效。 </summary>
public ShaderBakeSettings settings = ShaderBakeSettings.CreateDefault();
/// <summary> 渲什么。允许为 null(此时 Render 返回 null 并留一条 lastError)。 </summary>
public Material material;
/// <summary> 最近一次失败的原因;成功时清空。给界面状态栏用,不让用户去 Console 里找。 </summary>
public string lastError = string.Empty;
private Mesh m_Geometry;
private string m_GeometrySignature = string.Empty;
private RenderTexture m_OwnedTarget;
private string m_TargetSignature = string.Empty;
private RenderTexture m_MultiSampleSource;
private CommandBuffer m_Buffer;
/// <summary> 当前这次烘焙用的网格(只读用途,外部别销毁) </summary>
public Mesh geometry { get { return m_Geometry; } }
/// <summary> 上一次渲染留下的目标(可能为 null)。预览直接拿它显示,省一次重建。 </summary>
public RenderTexture target { get { return m_OwnedTarget; } }
/// <summary> 面片在世界空间的包围盒(相机框位用) </summary>
public Bounds geometryBounds
{
get { return ShaderBakeGeometryBuilder.GetWorldBounds(m_Geometry, settings.surface.localMatrix); }
}
/// <summary> 参数变了但还没重画:界面用它决定状态栏写"待刷新"还是"已渲染" </summary>
public bool isDirty
{
get { return m_TargetSignature != settings.output.GetTargetSignature() || m_GeometrySignature != settings.surface.GetGeometrySignature(); }
}
/// <summary>
/// 渲一次。<paramref name="target"/> 为空时用内部缓存的目标(尺寸变了自动重建),
/// 非空时渲进调用方那张(要求宽高与 settings.output 一致,否则 Unity 只会画一部分)。
/// 返回真正写入了结果的那张 RT,可能是传入的那张,也可能是内部那张。
/// </summary>
public RenderTexture Render(RenderTexture target = null)
{
lastError = string.Empty;
if (material == null)
{
lastError = "没有材质:先给一个 Shader 或 Material";
return null;
}
if (material.shader == null)
{
lastError = "材质上的 shader 丢了";
return null;
}
settings.ClampAll();
EnsureGeometry();
if (m_Geometry == null)
{
lastError = "几何构建失败";
return null;
}
RenderTexture dest = target ?? EnsureOwnedTarget();
if (dest == null)
{
lastError = "目标纹理创建失败(尺寸或格式超出显卡限制)";
return null;
}
// MSAA 目标不能直接被 ReadPixels 读到解析后的像素,所以先画进采样目标,再 Blit 回普通目标
bool needResolve = settings.output.antiAliasing > 1 && target == null && m_MultiSampleSource != null;
RenderTexture drawn = needResolve ? m_MultiSampleSource : dest;
DrawInto(drawn);
if (needResolve)
Graphics.Blit(m_MultiSampleSource, dest);
return dest;
}
/// <summary> 渲成可读 Texture2D(调用方负责销毁)。导出文件与存资产都从这里出发。 </summary>
public Texture2D RenderToTexture2D(bool generateMips = false)
{
RenderTexture rt = Render();
if (rt == null)
return null;
var texture = ShaderBakeReadback.ToTexture2D(rt, settings.output.textureFormat, settings.output.isLinearTexture, generateMips);
texture.name = material != null ? material.name : "ShaderBakeResult";
return texture;
}
/// <summary>
/// 渲成 Sprite。返回的 Sprite 持有那张纹理,<b>别去销毁 sprite.texture</b>;
/// 默认轴心在正中、100 像素=1 单位,和 Unity 新建 Sprite 的默认值一致。
/// </summary>
public Sprite RenderToSprite(float pixelsPerUnit = 100f, float pivotX = 0.5f, float pivotY = 0.5f)
{
Texture2D texture = RenderToTexture2D(false);
if (texture == null)
return null;
return ShaderBakeReadback.ToSprite(texture, new Vector2(pivotX, pivotY), Mathf.Max(pixelsPerUnit, 0.01f), texture.name);
}
/// <summary> 渲成图片文件的字节。textureToKeep 非空时把中间纹理交出去由调用方销毁,否则就地销毁。 </summary>
public byte[] RenderToBytes(ShaderBakeImageFormat format, out Texture2D textureToKeep)
{
textureToKeep = null;
Texture2D texture = RenderToTexture2D(false);
if (texture == null)
return null;
if (format.NeedsFloatSource() && !settings.output.hdr)
Debug.LogWarning("[ShaderBake] EXR 建议配 HDR 输出,否则值域被截到 0~1");
byte[] bytes = format.Encode(texture, settings.output.clearColor);
textureToKeep = texture;
return bytes;
}
/// <summary> 渲成图片文件的字节(中间纹理自动回收) </summary>
public byte[] RenderToBytes(ShaderBakeImageFormat format, bool destroyTexture = true)
{
Texture2D texture;
byte[] bytes = RenderToBytes(format, out texture);
if (destroyTexture && texture != null)
ReleaseTempObject(texture);
return bytes;
}
/// <summary> 把相机挪到刚好框住面片。改了尺寸/位置之后按一下就回到"看得见"的状态。 </summary>
public void FitCameraToGeometry()
{
EnsureGeometry();
if (m_Geometry == null)
return;
settings.camera.FrameBounds(geometryBounds, settings.aspect);
}
/// <summary> 网格与相机指纹都记下来,界面据此判断要不要重建 </summary>
public string stateSignature
{
get { return settings.output.GetTargetSignature() + "|" + settings.surface.GetGeometrySignature() + "|" + settings.camera.GetCameraSignature(); }
}
/// <summary>
/// 只重建网格(面片参数变了)。渲染路径本来就会在签名不符时重建,这里给界面留个显式入口。
/// </summary>
public void InvalidateGeometry()
{
m_GeometrySignature = string.Empty;
}
private void EnsureGeometry()
{
string signature = settings.surface.GetGeometrySignature();
if (m_Geometry != null && signature == m_GeometrySignature)
return;
ReleaseTempObject(m_Geometry);
m_Geometry = ShaderBakeGeometryBuilder.Build(settings.surface);
m_GeometrySignature = signature;
}
private RenderTexture EnsureOwnedTarget()
{
string signature = settings.output.GetTargetSignature();
if (m_OwnedTarget != null && signature == m_TargetSignature)
return m_OwnedTarget;
ReleaseTempObject(m_OwnedTarget);
ReleaseTempObject(m_MultiSampleSource);
m_OwnedTarget = settings.output.CreateRenderTexture("ShaderBakeTarget");
m_TargetSignature = m_OwnedTarget != null ? signature : string.Empty;
if (settings.output.antiAliasing > 1 && m_OwnedTarget != null)
m_MultiSampleSource = settings.output.CreateRenderTexture("ShaderBakeMultiSample");
return m_OwnedTarget;
}
private void DrawInto(RenderTexture rt)
{
if (m_Buffer == null)
{
m_Buffer = new CommandBuffer { name = "XericUI.ShaderBake" };
}
Matrix4x4 projection = settings.camera.GetProjectionMatrix(settings.aspect);
if (settings.output.flipY)
projection = Matrix4x4.Scale(new Vector3(1f, -1f, 1f)) * projection;
m_Buffer.Clear();
m_Buffer.SetRenderTarget(rt, 0, CubemapFace.Unknown, 0);
m_Buffer.ClearRenderTarget(true, true, settings.output.clearColor, 1f);
m_Buffer.SetViewProjectionMatrices(settings.camera.viewMatrix, projection);
m_Buffer.DrawMesh(m_Geometry, settings.surface.localMatrix, material,
Mathf.Max(settings.surface.meshSubMesh, 0), settings.output.shaderPass);
Graphics.ExecuteCommandBuffer(m_Buffer);
m_Buffer.Clear();
}
/// <summary>
/// 回收一次性对象。运行时要走 <c>Destroy</c>(当帧不能立即销毁),编辑器里请传
/// <paramref name="immediate"/> 让 <c>DestroyImmediate</c> 立刻放掉显存——导一批图时差别很大。
/// </summary>
public static void ReleaseTempObject(UnityEngine.Object obj)
{
ReleaseTempObject(obj, false);
}
internal static void ReleaseTempObject(UnityEngine.Object obj, bool immediate)
{
if (obj == null)
return;
#if UNITY_EDITOR
if (immediate || !Application.isPlaying)
UnityEngine.Object.DestroyImmediate(obj);
else
UnityEngine.Object.Destroy(obj);
#else
UnityEngine.Object.Destroy(obj);
#endif
}
public void Dispose()
{
Dispose(false);
}
/// <summary> 编辑器里关窗口时传 immediate,显存和网格内存当场还回去 </summary>
public void Dispose(bool immediate)
{
if (m_Buffer != null)
{
m_Buffer.Release();
m_Buffer.Dispose();
m_Buffer = null;
}
ReleaseTempObject(m_MultiSampleSource, immediate);
ReleaseTempObject(m_OwnedTarget, immediate);
ReleaseTempObject(m_Geometry, immediate);
m_MultiSampleSource = null;
m_OwnedTarget = null;
m_Geometry = null;
m_TargetSignature = string.Empty;
m_GeometrySignature = string.Empty;
}
}
}