feat(ShaderBake): 时间轴参数与序列导出(宫格图 / 视频 / Texture3D)

离屏渲染没有"当前帧",同一套参数连渲两次必须得到同一张图,否则序列是花的、
问题也没法复现。新增 ShaderBakeTimeSettings(时间 / 每帧时间 / 帧数 / 宫格列):
渲染时把 _Time、_SinTime、_CosTime、unity_DeltaTime 灌进引擎全局量,画完交还
当前时钟;单张导出同样用这个固定时间。

导出菜单新增三项,共用这组时间参数:
- 序列·宫格图:逐帧渲进一张 RT,用 SetViewport + Blit 拼贴,只在最后读回一次;
  单张上限 8192,列数 0 时按帧数取近似正方形。
- 序列·视频:MediaEncoder 写 mp4(H.264,无 alpha)或 webm(VP8,带 alpha),
  帧率由每帧时间反推,宽高要求偶数。
- 序列·Texture3D:每帧一层,深度=帧数,存成 .asset。
This commit is contained in:
2026-11-09 09:55:07 +08:00
parent 8262d5a5b7
commit b1648b5397
9 changed files with 373 additions and 9 deletions
+232 -4
View File
@@ -1,7 +1,9 @@
using System;
using System.IO;
using UnityEditor;
using UnityEditor.Media;
using UnityEngine;
using UnityEngine.Rendering;
namespace XericUI.ShaderBake.Editor
{
@@ -36,6 +38,11 @@ namespace XericUI.ShaderBake.Editor
menu.AddItem(new GUIContent("TGA 文件…"), false, () => SaveFile(ShaderBakeImageFormat.Tga, name));
menu.AddItem(new GUIContent("EXR 文件…"), false, () => SaveFile(ShaderBakeImageFormat.Exr, name));
menu.AddSeparator(string.Empty);
menu.AddItem(new GUIContent("序列 · 宫格图(png)…"), false, () => SaveSpriteSheet(name));
menu.AddItem(new GUIContent("序列 · 视频(mp4 / webm)…"), false, () => SaveVideo(name));
menu.AddItem(new GUIContent("序列 · Texture3D 资产(.asset)…"), false, () => SaveTexture3D(name));
menu.AddSeparator(string.Empty);
menu.AddItem(new GUIContent("Texture2D 资产(.asset)…"), false, () => SaveTextureAsset(name));
menu.AddItem(new GUIContent("Sprite 资产(png + 导入设置)…"), false, () => SaveSpriteAsset(name));
@@ -50,7 +57,7 @@ namespace XericUI.ShaderBake.Editor
public void SaveFile(ShaderBakeImageFormat format, string suggestedName)
{
Texture2D texture = m_Renderer.RenderToTexture2D(false);
Texture2D texture = m_Renderer.RenderToTexture2D(false, m_Renderer.settings.time.seconds);
if (texture == null)
{
Fail(m_Renderer.lastError);
@@ -105,7 +112,7 @@ namespace XericUI.ShaderBake.Editor
public void SaveTextureAsset(string suggestedName)
{
Texture2D texture = m_Renderer.RenderToTexture2D(false);
Texture2D texture = m_Renderer.RenderToTexture2D(false, m_Renderer.settings.time.seconds);
if (texture == null)
{
Fail(m_Renderer.lastError);
@@ -140,7 +147,7 @@ namespace XericUI.ShaderBake.Editor
if (string.IsNullOrEmpty(path))
return;
Texture2D texture = m_Renderer.RenderToTexture2D(false);
Texture2D texture = m_Renderer.RenderToTexture2D(false, m_Renderer.settings.time.seconds);
if (texture == null)
{
Fail(m_Renderer.lastError);
@@ -177,7 +184,7 @@ namespace XericUI.ShaderBake.Editor
// 存成资产要能被别处直接采样/读回,单采样即可;采样样式由烘焙设置里的 MSAA 只在预览时体现
var rt = m_Renderer.settings.output.CreateRenderTexture(Path.GetFileNameWithoutExtension(path), 1);
if (m_Renderer.Render(rt) == null)
if (m_Renderer.Render(rt, m_Renderer.settings.time.seconds) == null)
{
Fail(m_Renderer.lastError);
ShaderBakeRenderer.ReleaseTempObject(rt, true);
@@ -190,6 +197,226 @@ namespace XericUI.ShaderBake.Editor
Report("已保存 " + path);
}
// ── 序列 ────────────────────────────────────────────────
/// <summary> 宫格图单边上限:再大显卡和内存都吃不住,也不像"一张图"了 </summary>
private const int kMaxSheetSide = 8192;
/// <summary>
/// 把 N 帧按宫格拼成一张图。每帧按设置里的时间轴渲染,拼贴走 GPU(SetViewport + Blit),
/// 只在最后读回一次——逐帧读回再 SetPixels 在 32×32 这种规模上会慢到不可用。
/// </summary>
public void SaveSpriteSheet(string suggestedName)
{
ShaderBakeTimeSettings time = m_Renderer.settings.time;
ShaderBakeOutputSettings output = m_Renderer.settings.output;
int frames = time.frameCount;
int columns = time.ColumnsFor(frames);
int rows = Mathf.CeilToInt(frames / (float)columns);
int sheetWidth = columns * output.width;
int sheetHeight = rows * output.height;
if (sheetWidth > kMaxSheetSide || sheetHeight > kMaxSheetSide)
{
Fail("宫格图 " + sheetWidth + "×" + sheetHeight + " 超过单张纹理上限 " + kMaxSheetSide +
",把帧数或单帧尺寸调小");
return;
}
string path = EditorUtility.SaveFilePanel("导出宫格图", LastDir(),
suggestedName + "_" + columns + "x" + rows, "png");
if (string.IsNullOrEmpty(path))
return;
RenderTexture sheet = RenderTexture.GetTemporary(sheetWidth, sheetHeight, 0,
output.format, output.renderTextureColorSpace);
try
{
var buffer = new CommandBuffer { name = "ShaderBakeSheet" };
try
{
buffer.SetRenderTarget(sheet);
buffer.ClearRenderTarget(false, true, output.clearColor);
for (int i = 0; i < frames; i++)
{
RenderTexture frame = m_Renderer.Render(null, time.TimeOf(i));
if (frame == null)
{
Fail(m_Renderer.lastError);
return;
}
buffer.SetViewport(new Rect((i % columns) * output.width, (i / columns) * output.height,
output.width, output.height));
buffer.Blit(frame, BuiltinRenderTextureType.CurrentActive);
}
Graphics.ExecuteCommandBuffer(buffer);
}
finally
{
buffer.Release();
}
Texture2D texture = ShaderBakeReadback.ToTexture2D(sheet, output.textureFormat,
output.isLinearTexture, false);
try
{
WritePng(path, texture);
}
finally
{
ShaderBakeRenderer.ReleaseTempObject(texture, true);
}
}
finally
{
RenderTexture.ReleaseTemporary(sheet);
}
}
/// <summary>
/// 把 N 帧写成一段视频。帧率由"每帧时间"反推(步长 1/30 就是 30fps),
/// .webm 走 VP8 带 alpha,.mp4 走 H.264 不带 alpha——H.264 没有透明通道,这点没得选。
/// </summary>
public void SaveVideo(string suggestedName)
{
ShaderBakeTimeSettings time = m_Renderer.settings.time;
ShaderBakeOutputSettings output = m_Renderer.settings.output;
if (output.width % 2 != 0 || output.height % 2 != 0)
{
Fail("视频宽高必须是偶数(现在是 " + output.width + "×" + output.height + ")");
return;
}
string path = EditorUtility.SaveFilePanel("导出序列视频", LastDir(), suggestedName, "mp4");
if (string.IsNullOrEmpty(path))
return;
bool withAlpha = path.EndsWith(".webm", StringComparison.OrdinalIgnoreCase);
int fps = Mathf.Clamp(Mathf.RoundToInt(1f / Mathf.Max(time.frameStep, 0.0001f)), 1, 120);
var attributes = new VideoTrackAttributes
{
frameRate = new MediaRational(fps, 1),
width = (uint)output.width,
height = (uint)output.height,
includeAlpha = withAlpha,
bitRateMode = VideoBitrateMode.High
};
try
{
using (var encoder = new MediaEncoder(path, attributes))
{
for (int i = 0; i < time.frameCount; i++)
{
Texture2D frame = m_Renderer.RenderToTexture2D(false, time.TimeOf(i));
if (frame == null)
{
Fail(m_Renderer.lastError);
return;
}
try
{
encoder.AddFrame(frame);
}
finally
{
ShaderBakeRenderer.ReleaseTempObject(frame, true);
}
}
}
}
catch (Exception e)
{
Fail("视频写入失败:" + e.Message);
return;
}
RememberDir(path);
Report("已导出 " + path + "(" + time.frameCount + " 帧 / " + fps + "fps)");
}
/// <summary> 每帧一层,第 0 层是最早的那一帧;深度就是帧数 </summary>
public void SaveTexture3D(string suggestedName)
{
ShaderBakeTimeSettings time = m_Renderer.settings.time;
ShaderBakeOutputSettings output = m_Renderer.settings.output;
int depth = time.frameCount;
int width = output.width;
int height = output.height;
long total = (long)width * height * depth;
if (total > 64L * 1024 * 1024)
{
Fail("Texture3D " + width + "×" + height + "×" + depth + " 太大(约 " +
(total * 16 / (1024 * 1024)) + " MB),把帧数或单帧尺寸调小");
return;
}
string path = EditorUtility.SaveFilePanelInProject("保存 Texture3D 资产", suggestedName, "asset",
"每一帧是这张 3D 纹理的一层,按时间顺序从第 0 层往上排");
if (string.IsNullOrEmpty(path))
return;
var volume = new Texture3D(width, height, depth, output.textureFormat, false)
{
name = Path.GetFileNameWithoutExtension(path),
wrapMode = output.wrapMode,
filterMode = output.filterMode,
hideFlags = HideFlags.None
};
var colors = new Color[(int)total];
int sliceSize = width * height;
for (int i = 0; i < depth; i++)
{
Texture2D frame = m_Renderer.RenderToTexture2D(false, time.TimeOf(i));
if (frame == null)
{
Fail(m_Renderer.lastError);
ShaderBakeRenderer.ReleaseTempObject(volume, true);
return;
}
Color[] slice = frame.GetPixels();
Array.Copy(slice, 0, colors, i * sliceSize, slice.Length);
ShaderBakeRenderer.ReleaseTempObject(frame, true);
}
volume.SetPixels(colors);
volume.Apply(false, false);
AssetDatabase.CreateAsset(volume, path);
AssetDatabase.SaveAssets();
RememberDir(path);
Report("已保存 " + path + "(" + depth + " 层)");
}
private void WritePng(string path, Texture2D texture)
{
byte[] bytes = ShaderBakeImageFormat.Png.Encode(texture, m_Renderer.settings.output.clearColor);
if (bytes == null || bytes.Length == 0)
{
Fail("PNG 编码失败");
return;
}
try
{
Directory.CreateDirectory(Path.GetDirectoryName(path));
File.WriteAllBytes(path, bytes);
}
catch (Exception e)
{
Fail("写入失败:" + e.Message);
return;
}
RememberDir(path);
string assetPath = ToAssetPath(path);
if (assetPath != null)
{
ImportAndConfigure(assetPath, false);
Report("已导出 " + assetPath);
}
else
{
Report("已导出 " + path);
}
}
// ── 参数搬运 ────────────────────────────────────────────
private void CopySettingsJson()
@@ -211,6 +438,7 @@ namespace XericUI.ShaderBake.Editor
m_Renderer.settings.surface = parsed.surface;
m_Renderer.settings.camera = parsed.camera;
m_Renderer.settings.globals = parsed.globals;
m_Renderer.settings.time = parsed.time;
Report("烘焙参数已从剪贴板替换");
Action apply = settingsReplaced;
if (apply != null)