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
@@ -0,0 +1,50 @@
using System;
using UnityEngine;
namespace XericUI.ShaderBake
{
/// <summary>
/// 时间轴:单张渲染注入的 <c>_Time</c>,以及序列导出(视频 / 宫格图 / Texture3D)的帧数与步长。
///
/// <para><b>为什么要把时间做成参数</b>:离屏渲染没有"当前帧"这回事,
/// 同一套参数连渲两次必须得到同一张图,否则导出的序列是花的、复现问题也没法对齐。
/// 所以时间由这里显式给定,渲染时注入、渲染完还原,不跟着编辑器的帧走。</para>
/// </summary>
[Serializable]
public class ShaderBakeTimeSettings
{
[Tooltip("注入的 _Time(秒)。单张导出与序列的第一帧都用它")]
public float seconds;
[Tooltip("序列每帧前进多少秒:它同时就是时间倍率,把动画放慢/加快都靠它")]
public float frameStep = 1f / 30f;
[Tooltip("序列帧数(视频帧数 / 宫格图格数 / 3D 纹理深度)")]
public int frameCount = 64;
[Tooltip("宫格图每行多少列,0=按帧数自动取近似正方形")]
public int sheetColumns;
public const int kMaxFrames = 4096;
public void Clamp()
{
frameCount = Mathf.Clamp(frameCount, 1, kMaxFrames);
sheetColumns = Mathf.Clamp(sheetColumns, 0, 256);
}
/// <summary> 第 <paramref name="frame"/> 帧渲染用的时间 </summary>
public float TimeOf(int frame)
{
return seconds + frameStep * frame;
}
/// <summary> 宫格图的列数:填了就用填的,0 时取能排成正接近正方形的列数 </summary>
public int ColumnsFor(int frames)
{
if (sheetColumns > 0)
return Mathf.Min(sheetColumns, frames);
return Mathf.Max(1, Mathf.CeilToInt(Mathf.Sqrt(frames)));
}
}
}