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
@@ -0,0 +1,140 @@
using System;
using UnityEngine;
namespace XericUI.ShaderBake
{
/// <summary>
/// 输出目标设置:决定"烘出来那张 RenderTexture 长什么样"。
///
/// <para><b>为什么 flipY 要摊开给用户</b>:这里走的是 CommandBuffer + 自建投影矩阵的离屏渲染,
/// 没有相机帮你做 API 相关的 Y 翻转,于是同一段代码在 D3D 与 OpenGL/Metal 上读回来的像素是上下相反的。
/// 与其替用户猜一个方向,不如把开关留在界面上(规范:一次调用不出结果时先怀疑方向,再怀疑内容)。</para>
/// </summary>
[Serializable]
public class ShaderBakeOutputSettings
{
/// <summary> 边长下限 </summary>
public const int kMinDimension = 1;
/// <summary>
/// 边长上限:4096² 的 RGBA32 读回是 64MB 内存,ARGBFloat 是 256MB。
/// 再往上就不是"烘焙一张图"而是"烘一张图集"了,交给调用方自己决定要不要冒险。
/// </summary>
public const int kMaxDimension = 4096;
[Tooltip("导出图片的宽(像素)")]
public int width = 512;
[Tooltip("导出图片的高(像素)")]
public int height = 512;
[Tooltip("HDR:目标改用 ARGBFloat。开这项时请配 EXR 导出,PNG/JPG 存不下超过 1 的分量")]
public bool hdr;
[Tooltip("多重采样,只能是 1 / 2 / 4 / 8;渲染完会自动解析回普通纹理再读回")]
public int antiAliasing = 1;
[Tooltip("深度位数。只渲一张面片填 0 就够,渲模型(有多层遮挡)要留 24")]
public int depthBuffer = 24;
[Tooltip("目标按 sRGB 存储。关掉=线性,通常配 HDR + EXR 自己走色彩管理")]
public bool sRGB = true;
[Tooltip("背景色。alpha 留 0 才能导出带透明通道的图;导 JPG 时这个颜色会被压进图里")]
public Color clearColor = new Color(0f, 0f, 0f, 0f);
[Tooltip("翻转投影 Y:画面上下颠倒时打开(不同图形 API 的读回方向不一样)")]
public bool flipY;
[Tooltip("subShader 的 pass 下标,-1=所有 pass 叠加渲染")]
public int shaderPass = -1;
[Tooltip("目标纹理的过滤方式")]
public FilterMode filterMode = FilterMode.Bilinear;
[Tooltip("目标纹理的寻址方式")]
public TextureWrapMode wrapMode = TextureWrapMode.Clamp;
/// <summary> 目标的 RenderTexture 格式 </summary>
public RenderTextureFormat format
{
get { return hdr ? RenderTextureFormat.ARGBFloat : RenderTextureFormat.ARGB32; }
}
/// <summary> 目标的色彩存储方式(HDR 只能线性) </summary>
public RenderTextureReadWrite renderTextureColorSpace
{
get { return hdr || !sRGB ? RenderTextureReadWrite.Linear : RenderTextureReadWrite.sRGB; }
}
/// <summary> 读回成 Texture2D 时用的像素格式 </summary>
public TextureFormat textureFormat
{
get { return hdr ? TextureFormat.RGBAFloat : TextureFormat.RGBA32; }
}
/// <summary> 读回来的 Texture2D 是否按线性解释 </summary>
public bool isLinearTexture
{
get { return hdr || !sRGB; }
}
/// <summary> 目标纹理的有效宽高(读回、贴图、算尺寸都走这个,别各自再算一遍) </summary>
public Vector2Int size
{
get { return new Vector2Int(width, height); }
}
/// <summary>
/// 把用户敲进来的数值收进合法区间。非法值不报错、只归位——界面上每改一次都走这里,
/// 报错会把输入框变成打字障碍。
/// </summary>
public void Clamp()
{
width = Mathf.Clamp(width, kMinDimension, kMaxDimension);
height = Mathf.Clamp(height, kMinDimension, kMaxDimension);
depthBuffer = Mathf.Clamp(depthBuffer, 0, 32);
// HDR 浮点目标基本没有平台支持 MSAA,硬开着只会得到一张黑图
if (hdr)
antiAliasing = 1;
else
antiAliasing = SnapAntiAliasing(antiAliasing);
}
/// <summary> 距离最近的一个合法采样倍数(1/2/4/8) </summary>
public static int SnapAntiAliasing(int requested)
{
if (requested <= 1) return 1;
if (requested <= 2) return 2;
if (requested <= 4) return 4;
return 8;
}
/// <summary>
/// 目标设置指纹:变了就要重建 RenderTexture。尺寸、格式、采样、深度都会换掉显存布局。
/// </summary>
public string GetTargetSignature()
{
return width + "x" + height + "_" + (hdr ? "f" : "l") + "_" + antiAliasing + "_" + depthBuffer + "_" + (sRGB ? "s" : "l");
}
/// <summary>
/// 按当前设置造一张未被使用过的 RenderTexture(调用方负责销毁)。
/// </summary>
public RenderTexture CreateRenderTexture(string name = "ShaderBakeTarget")
{
Clamp();
var rt = new RenderTexture(width, height, depthBuffer, format, renderTextureColorSpace)
{
name = name,
filterMode = filterMode,
wrapMode = wrapMode,
antiAliasing = antiAliasing,
hideFlags = HideFlags.DontSave
};
// 显式 Create:antiAliasing 只有在初始化之前赋值才生效,靠第一次使用时自动建就丢了
rt.Create();
return rt;
}
}
}