From 63173c6ec2be6228ef26cdd0a9b6fdb2c40cea07 Mon Sep 17 00:00:00 2001 From: LiRuoChen <571244399@qq.com> Date: Thu, 5 Nov 2026 15:59:02 +0800 Subject: [PATCH] =?UTF-8?q?feat(ShaderBake):=20runtime=20=E4=BE=A7?= =?UTF-8?q?=E6=8A=8A=20shader=20=E6=B8=B2=E6=88=90=20RT/Texture2D/Sprite/?= =?UTF-8?q?=E6=96=87=E4=BB=B6=E5=AD=97=E8=8A=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 离屏渲染走 CommandBuffer + 自建视图投影矩阵,不往场景塞相机和 GameObject, 代价是 API 相关的 Y 翻转要露成一个开关(output.flipY);灯光/雾/阴影不参与, 所以光照类 shader 会渲成无灯效果,这一点写在注释里而不是假装支持。 外部网格一律复制到新网格再改 UV:直接改 MeshFilter.sharedMesh 等于改了项目资产。 --- Runtime/ShaderBake/ShaderBake.cs | 124 ++++++++ .../ShaderBake/ShaderBakeCameraSettings.cs | 100 +++++++ .../ShaderBake/ShaderBakeGeometryBuilder.cs | 228 +++++++++++++++ Runtime/ShaderBake/ShaderBakeImageFormat.cs | 89 ++++++ .../ShaderBake/ShaderBakeMaterialSource.cs | 144 ++++++++++ .../ShaderBake/ShaderBakeOutputSettings.cs | 140 +++++++++ Runtime/ShaderBake/ShaderBakeReadback.cs | 95 +++++++ Runtime/ShaderBake/ShaderBakeRenderer.cs | 268 ++++++++++++++++++ Runtime/ShaderBake/ShaderBakeSettings.cs | 65 +++++ .../ShaderBake/ShaderBakeSurfaceSettings.cs | 108 +++++++ 10 files changed, 1361 insertions(+) create mode 100644 Runtime/ShaderBake/ShaderBake.cs create mode 100644 Runtime/ShaderBake/ShaderBakeCameraSettings.cs create mode 100644 Runtime/ShaderBake/ShaderBakeGeometryBuilder.cs create mode 100644 Runtime/ShaderBake/ShaderBakeImageFormat.cs create mode 100644 Runtime/ShaderBake/ShaderBakeMaterialSource.cs create mode 100644 Runtime/ShaderBake/ShaderBakeOutputSettings.cs create mode 100644 Runtime/ShaderBake/ShaderBakeReadback.cs create mode 100644 Runtime/ShaderBake/ShaderBakeRenderer.cs create mode 100644 Runtime/ShaderBake/ShaderBakeSettings.cs create mode 100644 Runtime/ShaderBake/ShaderBakeSurfaceSettings.cs diff --git a/Runtime/ShaderBake/ShaderBake.cs b/Runtime/ShaderBake/ShaderBake.cs new file mode 100644 index 0000000..6937fab --- /dev/null +++ b/Runtime/ShaderBake/ShaderBake.cs @@ -0,0 +1,124 @@ +using System; +using UnityEngine; + +namespace XericUI.ShaderBake +{ + /// + /// 一次性调用的门面:给"我就是要把这个 shader 烘成一张图/一个文件"的运行时代码用。 + /// 需要在帧之间反复改参数重画(比如编辑器预览)请直接用 , + /// 它会把目标纹理和网格留着复用。 + /// + public static class ShaderBake + { + /// + /// 渲进一张新建的 RenderTexture。返回的纹理由调用方销毁(用 + /// 就行)。失败返回 null,原因写在 lastError。 + /// + public static RenderTexture BakeToRenderTexture(Material material, ShaderBakeSettings settings, out string lastError) + { + lastError = null; + using (var renderer = CreateRenderer(material, settings, out lastError)) + { + if (renderer == null) + return null; + RenderTexture rt = renderer.Render(); + lastError = renderer.lastError; + if (rt == null) + return null; + + // renderer.Dispose 会把内部那张一起销毁,所以交出去的是按同一套参数另建的一张 + var effective = settings != null ? settings : ShaderBakeSettings.CreateDefault(); + var copy = effective.output.CreateRenderTexture("ShaderBakeResult"); + Graphics.Blit(rt, copy); + return copy; + } + } + + /// 渲成可读 Texture2D。调用方负责销毁。 + public static Texture2D BakeToTexture2D(Material material, ShaderBakeSettings settings, bool generateMips = false) + { + string lastError; + using (var renderer = CreateRenderer(material, settings, out lastError)) + { + if (renderer == null) + { + Debug.LogError("[ShaderBake] " + lastError); + return null; + } + return renderer.RenderToTexture2D(generateMips); + } + } + + /// 渲成 Sprite(连同它持有的纹理一起交给调用方)。 + public static Sprite BakeToSprite(Material material, ShaderBakeSettings settings, float pixelsPerUnit = 100f) + { + string lastError; + using (var renderer = CreateRenderer(material, settings, out lastError)) + { + if (renderer == null) + { + Debug.LogError("[ShaderBake] " + lastError); + return null; + } + return renderer.RenderToSprite(pixelsPerUnit); + } + } + + /// + /// 渲成图片文件字节(PNG / JPG / TGA / EXR)。 + /// 为 null 时用默认 512×512 那套。 + /// + public static byte[] BakeToBytes(Material material, ShaderBakeImageFormat format, ShaderBakeSettings settings = null) + { + string lastError; + using (var renderer = CreateRenderer(material, settings, out lastError)) + { + if (renderer == null) + { + Debug.LogError("[ShaderBake] " + lastError); + return null; + } + Texture2D keep; + byte[] bytes = renderer.RenderToBytes(format, out keep); + if (keep != null) + ShaderBakeRenderer.ReleaseTempObject(keep); + return bytes; + } + } + + /// 从 Shader 直接烘一份(内部建临时材质并在用完后销毁) + public static byte[] BakeToBytes(Shader shader, ShaderBakeImageFormat format, ShaderBakeSettings settings = null) + { + if (shader == null) + { + Debug.LogError("[ShaderBake] shader 为空"); + return null; + } + var temp = new Material(shader) { hideFlags = HideFlags.DontSave }; + try + { + return BakeToBytes(temp, format, settings); + } + finally + { + ShaderBakeRenderer.ReleaseTempObject(temp); + } + } + + /// 把参数与材质装进一个新渲染器;材质为空时返回 null 并写好 lastError + public static ShaderBakeRenderer CreateRenderer(Material material, ShaderBakeSettings settings, out string lastError) + { + if (material == null) + { + lastError = "没有材质"; + return null; + } + lastError = string.Empty; + return new ShaderBakeRenderer + { + material = material, + settings = settings != null ? settings : ShaderBakeSettings.CreateDefault() + }; + } + } +} diff --git a/Runtime/ShaderBake/ShaderBakeCameraSettings.cs b/Runtime/ShaderBake/ShaderBakeCameraSettings.cs new file mode 100644 index 0000000..e742d46 --- /dev/null +++ b/Runtime/ShaderBake/ShaderBakeCameraSettings.cs @@ -0,0 +1,100 @@ +using System; +using UnityEngine; + +namespace XericUI.ShaderBake +{ + /// + /// 离屏"摄像机"参数。这里没有真的 Camera——投影与视口矩阵是自己算出来塞进 CommandBuffer 的, + /// 好处是不往场景里塞任何临时物体,坏处是 API 相关的 Y 翻转要自己管(见 output.flipY)。 + /// + [Serializable] + public class ShaderBakeCameraSettings + { + [Tooltip("正交(默认):面片不会因为透视而变形,适合贴图类 shader")] + public bool orthographic = true; + + [Tooltip("正交半高(世界单位):实际能看到的竖向范围是它的两倍")] + public float orthographicSize = 0.6f; + + [Tooltip("透视相机的竖向视野角(度),正交时忽略")] + public float fieldOfView = 60f; + + [Tooltip("近裁剪面")] + public float nearClipPlane = 0.01f; + + [Tooltip("远裁剪面")] + public float farClipPlane = 100f; + + [Tooltip("相机位置:正交时只有朝向影响画面,位置决定远近")] + public Vector3 position = new Vector3(0f, 0f, -10f); + + [Tooltip("相机旋转(欧拉角,度):默认朝 +Z 看,即看着放在原点、面朝 -Z 的面片")] + public Vector3 eulerAngles; + + /// 视口(世界 → 相机)矩阵 + public Matrix4x4 viewMatrix + { + get { return Matrix4x4.TRS(position, Quaternion.Euler(eulerAngles), Vector3.one).inverse; } + } + + /// + /// 投影矩阵。正交时宽高按 aspect 分配(半宽 = 半高 × aspect),与 Unity 相机一致。 + /// + public Matrix4x4 GetProjectionMatrix(float aspect) + { + if (aspect <= 0f) aspect = 1f; + if (orthographic) + { + float halfHeight = Mathf.Max(orthographicSize, 0.0001f); + float halfWidth = halfHeight * aspect; + return Matrix4x4.Ortho(-halfWidth, halfWidth, -halfHeight, halfHeight, + Mathf.Max(nearClipPlane, 0.0001f), Mathf.Max(farClipPlane, nearClipPlane + 0.0001f)); + } + return Matrix4x4.Perspective(Mathf.Clamp(fieldOfView, 1f, 179f), aspect, + Mathf.Max(nearClipPlane, 0.0001f), Mathf.Max(farClipPlane, nearClipPlane + 0.0001f)); + } + + /// + /// 把包围盒框进画面:正交改半高,透视改距离;同时把远近裁剪面推到包围盒外侧, + /// 免得贴脸的大面片被近裁剪面削掉一块。 + /// + public void FrameBounds(Bounds bounds, float aspect, float padding = 1.15f) + { + Vector3 extents = bounds.extents; + float radius = extents.magnitude; + if (radius < 0.0001f) radius = 0.0001f; + if (aspect <= 0f) aspect = 1f; + + if (orthographic) + { + // 横向不够宽时以横向为准:半高 = 半宽 / aspect + float halfFromHeight = extents.y; + float halfFromWidth = extents.x / aspect; + orthographicSize = Mathf.Max(halfFromHeight, halfFromWidth) * Mathf.Max(padding, 1f); + } + else + { + float halfFov = Mathf.Clamp(fieldOfView, 1f, 179f) * 0.5f * Mathf.Deg2Rad; + float verticalFit = extents.y; + float horizontalFit = extents.x / aspect; + float neededHalfHeight = Mathf.Max(verticalFit, horizontalFit) * Mathf.Max(padding, 1f); + float distance = radius + neededHalfHeight / Mathf.Max(Mathf.Tan(halfFov), 0.0001f); + + // 沿当前朝向平移,不改朝向——转着找角度是用户的事,这里只负责"离远一点" + Vector3 dir = Quaternion.Euler(eulerAngles) * Vector3.forward; + position = bounds.center - dir * Mathf.Max(distance, radius + 0.0001f); + } + + float distanceFromCamera = Vector3.Distance(position, bounds.center); + nearClipPlane = Mathf.Max(0.0001f, distanceFromCamera - radius * 3f); + farClipPlane = distanceFromCamera + radius * 3f; + } + + /// 摄像机指纹:变了不需要重建网格,只需要重画 + public string GetCameraSignature() + { + return orthographic + "_" + orthographicSize + "_" + fieldOfView + "_" + + nearClipPlane + "_" + farClipPlane + "_" + position + "_" + eulerAngles; + } + } +} diff --git a/Runtime/ShaderBake/ShaderBakeGeometryBuilder.cs b/Runtime/ShaderBake/ShaderBakeGeometryBuilder.cs new file mode 100644 index 0000000..05bedc2 --- /dev/null +++ b/Runtime/ShaderBake/ShaderBakeGeometryBuilder.cs @@ -0,0 +1,228 @@ +using System.Collections.Generic; +using UnityEngine; +using UnityEngine.Rendering; + +namespace XericUI.ShaderBake +{ + /// + /// 按 造出这次烘焙要画的那张网格。 + /// + /// 外部网格一定要复制:UV 偏移/重复是写进顶点数据的,直接改 + /// MeshFilter.sharedMesh 等于改了项目里的资产。这里把顶点搬到一张新网格上, + /// 蒙皮信息不带过来(烘焙用不到,带过来反而要把骨骼矩阵一起搬)。 + /// + public static class ShaderBakeGeometryBuilder + { + /// 造一张新网格(调用方负责销毁)。kind 为外部网格但没有指定网格时退回单片四边形。 + public static Mesh Build(ShaderBakeSurfaceSettings surface) + { + if (surface == null) + return null; + surface.Clamp(); + + switch (surface.kind) + { + case ShaderBakeSurfaceKind.Plane: + return BuildGrid(surface, Mathf.Max(surface.segments.x, 1), Mathf.Max(surface.segments.y, 1)); + case ShaderBakeSurfaceKind.Mesh when surface.sourceMesh != null: + return BuildFromMesh(surface); + default: + return BuildGrid(surface, 1, 1); + } + } + + /// + /// 世界空间的包围盒:网格局部包围盒乘面片变换。给"框住面片"用,所以要在外面算, + /// 免得网格和变换的耦合漏进几何构建里。 + /// + public static Bounds GetWorldBounds(Mesh mesh, Matrix4x4 matrix) + { + if (mesh == null) + return new Bounds(Vector3.zero, Vector3.one); + if (matrix.isIdentity) + return mesh.bounds; + + Bounds b = mesh.bounds; + Vector3 min = b.min, max = b.max; + Vector3 worldMin = matrix.MultiplyPoint(min); + Vector3 worldMax = worldMin; + + // 旋转过之后轴对齐盒子的八个角才是新盒子的候选极值,只转两个角会得到一个歪掉的框 + for (int i = 0; i < 8; i++) + { + Vector3 corner = matrix.MultiplyPoint(new Vector3( + (i & 1) == 0 ? min.x : max.x, + (i & 2) == 0 ? min.y : max.y, + (i & 4) == 0 ? min.z : max.z)); + worldMin = Vector3.Min(worldMin, corner); + worldMax = Vector3.Max(worldMax, corner); + } + + var bounds = new Bounds(); + bounds.SetMinMax(worldMin, worldMax); + return bounds; + } + + /// 网格在自身变换之后、相机之前的最大分量跨度,用于决定要不要走 uint32 索引 + private static Mesh BuildGrid(ShaderBakeSurfaceSettings surface, int columns, int rows) + { + float halfWidth = surface.size.x * 0.5f; + float halfHeight = surface.size.y * 0.5f; + + int vertexCount = (columns + 1) * (rows + 1); + var vertices = new List(vertexCount); + var normals = new List(vertexCount); + var uvs = new List(vertexCount); + var triangles = new List(columns * rows * 6); + + for (int y = 0; y <= rows; y++) + { + float ty = rows == 0 ? 0f : (float)y / rows; + for (int x = 0; x <= columns; x++) + { + float tx = columns == 0 ? 0f : (float)x / columns; + vertices.Add(new Vector3( + Mathf.Lerp(-halfWidth, halfWidth, tx), + Mathf.Lerp(-halfHeight, halfHeight, ty), + 0f)); + normals.Add(Vector3.back); // 面朝 -Z,即默认相机(朝 +Z 看)看到的正面 + uvs.Add(RemapUv(new Vector2(tx, ty), surface)); + } + } + + int stride = columns + 1; + for (int y = 0; y < rows; y++) + for (int x = 0; x < columns; x++) + { + int bottomLeft = y * stride + x; + int bottomRight = bottomLeft + 1; + int topLeft = bottomLeft + stride; + int topRight = topLeft + 1; + // 绕序按"从 -Z 往 +Z 看是顺时针"排;翻转投影时靠 output.flipY 修,不靠这里换绕序 + triangles.Add(bottomLeft); + triangles.Add(bottomRight); + triangles.Add(topLeft); + triangles.Add(bottomRight); + triangles.Add(topRight); + triangles.Add(topLeft); + } + + var mesh = NewMesh("ShaderBakeQuad"); + mesh.SetVertices(vertices); + mesh.SetNormals(normals); + mesh.SetUVs(0, uvs); + mesh.SetTriangles(triangles, 0); + Upload(mesh); + return mesh; + } + + /// + /// 复制外部网格的第 0 套 UV(没有就按位置做平面投影),再套上偏移/重复。 + /// + private static Mesh BuildFromMesh(ShaderBakeSurfaceSettings surface) + { + Mesh source = surface.sourceMesh; + int subMesh = Mathf.Min(surface.meshSubMesh, Mathf.Max(source.subMeshCount - 1, 0)); + + var vertices = new List(); + source.GetVertices(vertices); + if (vertices.Count == 0) + { + Debug.LogWarning("[ShaderBake] 外部网格没有顶点数据(可能是只读网格),退回单片四边形"); + return BuildGrid(surface, 1, 1); + } + + var normals = new List(); + if (source.HasVertexAttribute(VertexAttribute.Normal)) + source.GetNormals(normals); + + var tangents = new List(); + if (source.HasVertexAttribute(VertexAttribute.Tangent)) + source.GetTangents(tangents); + + var uvs = new List(); + if (source.HasVertexAttribute(VertexAttribute.TexCoord0)) + source.GetUVs(0, uvs); + if (uvs.Count != vertices.Count) + uvs = BuildPlanarUv(vertices); + + // UV 是"面片的贴图坐标",不该被模型的尺寸归一化影响,所以先 remap 再缩放顶点 + for (int i = 0; i < uvs.Count; i++) + uvs[i] = RemapUv(uvs[i], surface); + + var mesh = NewMesh("ShaderBakeMesh"); + if (vertices.Count > 65000) + mesh.indexFormat = IndexFormat.UInt32; + + Bounds srcBounds = source.bounds; + Vector3 normalizeScale = surface.normalizeMeshSize ? FitScale(srcBounds.size, surface.size) : Vector3.one; + + for (int i = 0; i < vertices.Count; i++) + vertices[i] = Vector3.Scale(vertices[i] - srcBounds.center, normalizeScale); + + mesh.SetVertices(vertices); + if (normals.Count == vertices.Count) mesh.SetNormals(normals); else mesh.RecalculateNormals(); + if (tangents.Count == vertices.Count) mesh.SetTangents(tangents); + mesh.SetUVs(0, uvs); + + // 只搬到选中的那一层:后面的层不该跟着画出来,但 subMesh 之前的层要一起画(多层模型常有共用材质球的分层) + int layerCount = subMesh + 1; + mesh.subMeshCount = layerCount; + for (int i = 0; i < layerCount; i++) + mesh.SetTriangles(source.GetTriangles(i), i); + + Upload(mesh); + mesh.RecalculateBounds(); + return mesh; + } + + /// 把源尺寸装进目标尺寸:x/y 各自贴合,z 跟 x/y 的平均倍率走以免模型被压扁成纸片 + private static Vector3 FitScale(Vector3 sourceSize, Vector2 targetSize) + { + float sx = sourceSize.x > 0.0001f ? targetSize.x / sourceSize.x : 1f; + float sy = sourceSize.y > 0.0001f ? targetSize.y / sourceSize.y : 1f; + float sz = sourceSize.z > 0.0001f ? (sx + sy) * 0.5f : 1f; + return new Vector3(sx, sy, sz); + } + + /// 网格没带 UV 时的兜底:拿 x/y 位置做一次平面投影,至少贴图有坐标可用 + private static List BuildPlanarUv(List vertices) + { + var min = new Vector3(float.MaxValue, float.MaxValue, 0f); + var max = new Vector3(float.MinValue, float.MinValue, 0f); + foreach (Vector3 v in vertices) + { + min = Vector3.Min(min, v); + max = Vector3.Max(max, v); + } + + float rangeX = Mathf.Max(max.x - min.x, 0.0001f); + float rangeY = Mathf.Max(max.y - min.y, 0.0001f); + + var uvs = new List(vertices.Count); + foreach (Vector3 v in vertices) + uvs.Add(new Vector2((v.x - min.x) / rangeX, (v.y - min.y) / rangeY)); + return uvs; + } + + private static Vector2 RemapUv(Vector2 uv, ShaderBakeSurfaceSettings surface) + { + return Vector2.Scale(uv, surface.uvTiling) + surface.uvOffset; + } + + private static Mesh NewMesh(string name) + { + return new Mesh + { + name = name, + hideFlags = HideFlags.DontSave + }; + } + + /// 上传为只读以外的可变网格(false):重建时还要读回顶点,别让 Unity 把它锁掉 + private static void Upload(Mesh mesh) + { + mesh.UploadMeshData(false); + } + } +} diff --git a/Runtime/ShaderBake/ShaderBakeImageFormat.cs b/Runtime/ShaderBake/ShaderBakeImageFormat.cs new file mode 100644 index 0000000..92ddd60 --- /dev/null +++ b/Runtime/ShaderBake/ShaderBakeImageFormat.cs @@ -0,0 +1,89 @@ +using System; +using UnityEngine; + +namespace XericUI.ShaderBake +{ + /// + /// 可导出的图片文件编码。全部走 Unity 自己的 ImageConversion 扩展方法,不引第三方编码器。 + /// + public enum ShaderBakeImageFormat + { + /// PNG:带 alpha,无损 + Png, + + /// JPG:无 alpha,导出前会把透明压到背景色上 + Jpg, + + /// TGA:无压缩、带 alpha,Photoshop / 老管线常用 + Tga, + + /// EXR:浮点 HDR,配 output.hdr 用 + Exr + } + + /// + /// 编码分派。注意这几个函数都要求纹理是可读的、且是非压缩格式—— + /// 所以入口只接 造出来的 RGBA32 / RGBAFloat,别把导入的资源塞进来。 + /// + public static class ShaderBakeImageFormatExtensions + { + public static string GetExtension(this ShaderBakeImageFormat format) + { + switch (format) + { + case ShaderBakeImageFormat.Jpg: return "jpg"; + case ShaderBakeImageFormat.Tga: return "tga"; + case ShaderBakeImageFormat.Exr: return "exr"; + default: return "png"; + } + } + + /// 这个格式能不能存 alpha + public static bool SupportsAlpha(this ShaderBakeImageFormat format) + { + return format != ShaderBakeImageFormat.Jpg; + } + + /// + /// 编码成文件字节。 只给 JPG 用:它没有 alpha 通道, + /// 直接把 RGBA 交上去会得到一圈发黑的边,所以先按这个颜色把透明压平(顺带把浮点截到 0~1)。 + /// + public static byte[] Encode(this ShaderBakeImageFormat format, Texture2D texture, Color flattenBackground) + { + if (texture == null) + throw new ArgumentNullException(nameof(texture)); + + if (format == ShaderBakeImageFormat.Jpg) + { + var flattened = ShaderBakeReadback.FlattenOntoBackground(texture, flattenBackground); + try + { + return flattened.EncodeToJPG(); + } + finally + { + UnityEngine.Object.Destroy(flattened); + } + } + + switch (format) + { + case ShaderBakeImageFormat.Tga: + return texture.EncodeToTGA(); + case ShaderBakeImageFormat.Exr: + return texture.EncodeToEXR(Texture2D.EXRFlags.None); + default: + return texture.EncodeToPNG(); + } + } + + /// + /// EXR 要求浮点纹理才能存下超过 1 的分量;非 HDR 的源用 RGBA32 烘,导 EXR 时格式仍合法但值域被截断, + /// 这里给个提示而不是报错。 + /// + public static bool NeedsFloatSource(this ShaderBakeImageFormat format) + { + return format == ShaderBakeImageFormat.Exr; + } + } +} diff --git a/Runtime/ShaderBake/ShaderBakeMaterialSource.cs b/Runtime/ShaderBake/ShaderBakeMaterialSource.cs new file mode 100644 index 0000000..d1c4cd2 --- /dev/null +++ b/Runtime/ShaderBake/ShaderBakeMaterialSource.cs @@ -0,0 +1,144 @@ +using System; +using UnityEngine; + +namespace XericUI.ShaderBake +{ + /// + /// 把"用户给的 Shader 或 Material"归一成一张可渲染的材质,并管好这张材质的生死。 + /// + /// 为什么 Shader 入口要自己造材质:渲染路径只认材质,而 Shader 资产本身不能被修改 + /// (属性默认值存在 Shader 里、不在任何实例上)。造一张临时材质是唯一能就地调参数的路子, + /// 代价是它不属于任何资产——所以用完必须还,见 。 + /// + /// Material 入口不动原资产:直接编辑传进来的材质资产等于改了项目里的文件, + /// 用户点一下颜色滑块就写脏了一个 .mat。这里也造一份副本,改坏了指望不了别人替你记。 + /// + public sealed class ShaderBakeMaterialSource : IDisposable + { + /// 渲染实际用的材质(可能是临时造的副本) + public Material material { get; private set; } + + /// 这份材质是不是自己造的,决定 Dispose 时要不要销毁它 + public bool ownsMaterial { get; private set; } + + /// 用户给的 Shader 入口,用于界面显示与材质属性列表 + public Shader sourceShader { get; private set; } + + /// 用户给的 Material 入口,副本的参数就按它初始化 + public Material sourceMaterial { get; private set; } + + /// 当前生效的 shader(两个入口最终都落到它上面) + public Shader shader + { + get + { + if (sourceShader != null) return sourceShader; + return material != null ? material.shader : null; + } + } + + /// 给界面看的来源说明:Shader 入口写"临时材质",Material 入口写"副本" + public string description + { + get + { + if (sourceShader != null) return sourceShader.name + "(临时材质)"; + if (material != null) return material.name + "(副本)"; + return "未指定"; + } + } + + /// Shader 入口:建一张临时材质。传 null 表示清空。 + public void Assign(Shader shader) + { + ReleaseOwned(); + sourceShader = shader; + sourceMaterial = null; + if (shader == null) + { + material = null; + return; + } + material = new Material(shader) + { + name = shader.name + " (Bake)", + hideFlags = HideFlags.DontSave + }; + ownsMaterial = true; + } + + /// Material 入口:复制一张临时材质,参数与来源一致。传 null 表示清空。 + public void Assign(Material source) + { + ReleaseOwned(); + sourceShader = null; + sourceMaterial = source; + if (source == null) + { + material = null; + return; + } + material = new Material(source) + { + name = source.name + " (Bake)", + hideFlags = HideFlags.DontSave + }; + ownsMaterial = true; + } + + /// 把副本当前的参数写回来源材质(用户显式按"应用"才走这里) + public bool ApplyToSource() + { + if (material == null || sourceMaterial == null) + return false; + // CopyPropertiesFromMaterial 只搬它认得的属性,材质整体替换反而会把 hideFlags 带过来 + sourceMaterial.CopyPropertiesFromMaterial(material); + return true; + } + + /// 丢弃副本上的改动,回到来源材质的参数 + public bool RevertToSource() + { + if (sourceMaterial == null) + return false; + Assign(sourceMaterial); + return true; + } + + /// 换 shader 名/属性列表之后要把副本丢干净 + public void Clear() + { + ReleaseOwned(); + sourceShader = null; + sourceMaterial = null; + material = null; + ownsMaterial = false; + } + + private void ReleaseOwned(bool immediate) + { + if (ownsMaterial && material != null) + ShaderBakeRenderer.ReleaseTempObject(material, immediate); + material = null; + ownsMaterial = false; + } + + private void ReleaseOwned() + { + ReleaseOwned(false); + } + + /// 编辑器里退出窗口时按 immediate 释放,显存当场就还回去了 + public void Dispose(bool immediate) + { + ReleaseOwned(immediate); + sourceShader = null; + sourceMaterial = null; + } + + public void Dispose() + { + Dispose(false); + } + } +} diff --git a/Runtime/ShaderBake/ShaderBakeOutputSettings.cs b/Runtime/ShaderBake/ShaderBakeOutputSettings.cs new file mode 100644 index 0000000..94a573a --- /dev/null +++ b/Runtime/ShaderBake/ShaderBakeOutputSettings.cs @@ -0,0 +1,140 @@ +using System; +using UnityEngine; + +namespace XericUI.ShaderBake +{ + /// + /// 输出目标设置:决定"烘出来那张 RenderTexture 长什么样"。 + /// + /// 为什么 flipY 要摊开给用户:这里走的是 CommandBuffer + 自建投影矩阵的离屏渲染, + /// 没有相机帮你做 API 相关的 Y 翻转,于是同一段代码在 D3D 与 OpenGL/Metal 上读回来的像素是上下相反的。 + /// 与其替用户猜一个方向,不如把开关留在界面上(规范:一次调用不出结果时先怀疑方向,再怀疑内容)。 + /// + [Serializable] + public class ShaderBakeOutputSettings + { + /// 边长下限 + public const int kMinDimension = 1; + + /// + /// 边长上限:4096² 的 RGBA32 读回是 64MB 内存,ARGBFloat 是 256MB。 + /// 再往上就不是"烘焙一张图"而是"烘一张图集"了,交给调用方自己决定要不要冒险。 + /// + 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; + + /// 目标的 RenderTexture 格式 + public RenderTextureFormat format + { + get { return hdr ? RenderTextureFormat.ARGBFloat : RenderTextureFormat.ARGB32; } + } + + /// 目标的色彩存储方式(HDR 只能线性) + public RenderTextureReadWrite renderTextureColorSpace + { + get { return hdr || !sRGB ? RenderTextureReadWrite.Linear : RenderTextureReadWrite.sRGB; } + } + + /// 读回成 Texture2D 时用的像素格式 + public TextureFormat textureFormat + { + get { return hdr ? TextureFormat.RGBAFloat : TextureFormat.RGBA32; } + } + + /// 读回来的 Texture2D 是否按线性解释 + public bool isLinearTexture + { + get { return hdr || !sRGB; } + } + + /// 目标纹理的有效宽高(读回、贴图、算尺寸都走这个,别各自再算一遍) + public Vector2Int size + { + get { return new Vector2Int(width, height); } + } + + /// + /// 把用户敲进来的数值收进合法区间。非法值不报错、只归位——界面上每改一次都走这里, + /// 报错会把输入框变成打字障碍。 + /// + 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); + } + + /// 距离最近的一个合法采样倍数(1/2/4/8) + public static int SnapAntiAliasing(int requested) + { + if (requested <= 1) return 1; + if (requested <= 2) return 2; + if (requested <= 4) return 4; + return 8; + } + + /// + /// 目标设置指纹:变了就要重建 RenderTexture。尺寸、格式、采样、深度都会换掉显存布局。 + /// + public string GetTargetSignature() + { + return width + "x" + height + "_" + (hdr ? "f" : "l") + "_" + antiAliasing + "_" + depthBuffer + "_" + (sRGB ? "s" : "l"); + } + + /// + /// 按当前设置造一张未被使用过的 RenderTexture(调用方负责销毁)。 + /// + 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; + } + } +} diff --git a/Runtime/ShaderBake/ShaderBakeReadback.cs b/Runtime/ShaderBake/ShaderBakeReadback.cs new file mode 100644 index 0000000..9db20e3 --- /dev/null +++ b/Runtime/ShaderBake/ShaderBakeReadback.cs @@ -0,0 +1,95 @@ +using System; +using UnityEngine; + +namespace XericUI.ShaderBake +{ + /// + /// RenderTexture → 可读 Texture2D,以及透明压平。 + /// + /// 为什么用 ReadPixels 而不是 AsyncGPUReadback:后者要等帧,回调里的数据这一轮就拿不到, + /// 而"点导出→拿到文件"这条链要的是同步返回。烘焙一张图本来就是离线动作, stall 一帧无所谓。 + /// + public static class ShaderBakeReadback + { + /// + /// 把目标读回成可读纹理。 决定纹理按线性还是 sRGB 解释, + /// 必须和生成它的那张 RenderTexture 一致,否则同一张图在编辑器和文件里会差一层 gamma。 + /// + public static Texture2D ToTexture2D(RenderTexture source, TextureFormat format, bool linear, bool mipChain = false) + { + if (source == null) + throw new ArgumentNullException(nameof(source)); + + var texture = new Texture2D(source.width, source.height, format, mipChain, linear) + { + name = source.name, + hideFlags = HideFlags.DontSave + }; + CopyInto(source, texture); + return texture; + } + + /// + /// 读进一张已存在的纹理(尺寸要和 source 一致;不一致 Unity 只会填左上角,剩下留黑)。 + /// 走 RenderTexture.active + ReadPixels,MSAA 目标已被调用方解析过,这里读到的是解析后的像素。 + /// + public static void CopyInto(RenderTexture source, Texture2D destination) + { + RenderTexture previous = RenderTexture.active; + try + { + RenderTexture.active = source; + destination.ReadPixels(new Rect(0, 0, source.width, source.height), 0, 0, false); + destination.Apply(false); + } + finally + { + RenderTexture.active = previous; + } + } + + /// + /// 把浮点/带 alpha 的纹理压成 RGB24:透明部分按 混合, + /// 分量截到 0~1。JPG 没有 alpha 通道,直接用原图编码会得到一圈发黑的边。 + /// + public static Texture2D FlattenOntoBackground(Texture2D source, Color background) + { + int width = source.width; + int height = source.height; + var flattened = new Texture2D(width, height, TextureFormat.RGB24, false, false) + { + name = source.name, + hideFlags = HideFlags.DontSave + }; + + Color[] pixels = source.GetPixels(); + for (int i = 0; i < pixels.Length; i++) + { + Color p = pixels[i]; + float a = Mathf.Clamp01(p.a); + pixels[i] = new Color( + Mathf.Lerp(background.r, p.r, a), + Mathf.Lerp(background.g, p.g, a), + Mathf.Lerp(background.b, p.b, a), + 1f); + } + flattened.SetPixels(pixels); + flattened.Apply(false); + return flattened; + } + + /// + /// 把一张纹理/RT 画成 Sprite。注意 Sprite 不拥有纹理:纹理销毁了 Sprite 就空了, + /// 所以调用方要么留着纹理,要么连纹理一起作为资产存下来。 + /// + public static Sprite ToSprite(Texture2D texture, Vector2 pivot, float pixelsPerUnit, string name = null) + { + if (texture == null) + throw new ArgumentNullException(nameof(texture)); + var sprite = Sprite.Create(texture, new Rect(0, 0, texture.width, texture.height), pivot, pixelsPerUnit); + if (!string.IsNullOrEmpty(name)) + sprite.name = name; + return sprite; + } + } +} diff --git a/Runtime/ShaderBake/ShaderBakeRenderer.cs b/Runtime/ShaderBake/ShaderBakeRenderer.cs new file mode 100644 index 0000000..e4b541a --- /dev/null +++ b/Runtime/ShaderBake/ShaderBakeRenderer.cs @@ -0,0 +1,268 @@ +using System; +using UnityEngine; +using UnityEngine.Rendering; + +namespace XericUI.ShaderBake +{ + /// + /// 把材质渲染成图的执行者。运行时与编辑器都能用:全程不碰 UnityEditor, + /// 不往场景里放相机或 GameObject——离屏渲染靠 CommandBuffer 自带视图/投影矩阵。 + /// + /// 用法:using (var r = new ShaderBakeRenderer(mat)) { var tex = r.RenderToTexture2D(); ... }, + /// 或者常驻一个实例反复改 再 (预览就是这条路)。 + /// + /// 已知的渲染环境限制:没有真实相机,于是灯光、雾、环境光、阴影都不参与—— + /// Unlit 类 shader 效果一致,Surface/光照类 shader 会渲成"无灯"。要带光照请改用场景相机截帧, + /// 那是另一条路,这里不假装支持。 + /// + public sealed class ShaderBakeRenderer : IDisposable + { + /// 怎么渲。外部可以直接改这个对象里的字段,改完调用 Render 就会跟着生效。 + public ShaderBakeSettings settings = ShaderBakeSettings.CreateDefault(); + + /// 渲什么。允许为 null(此时 Render 返回 null 并留一条 lastError)。 + public Material material; + + /// 最近一次失败的原因;成功时清空。给界面状态栏用,不让用户去 Console 里找。 + 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; + + /// 当前这次烘焙用的网格(只读用途,外部别销毁) + public Mesh geometry { get { return m_Geometry; } } + + /// 上一次渲染留下的目标(可能为 null)。预览直接拿它显示,省一次重建。 + public RenderTexture target { get { return m_OwnedTarget; } } + + /// 面片在世界空间的包围盒(相机框位用) + public Bounds geometryBounds + { + get { return ShaderBakeGeometryBuilder.GetWorldBounds(m_Geometry, settings.surface.localMatrix); } + } + + /// 参数变了但还没重画:界面用它决定状态栏写"待刷新"还是"已渲染" + public bool isDirty + { + get { return m_TargetSignature != settings.output.GetTargetSignature() || m_GeometrySignature != settings.surface.GetGeometrySignature(); } + } + + /// + /// 渲一次。 为空时用内部缓存的目标(尺寸变了自动重建), + /// 非空时渲进调用方那张(要求宽高与 settings.output 一致,否则 Unity 只会画一部分)。 + /// 返回真正写入了结果的那张 RT,可能是传入的那张,也可能是内部那张。 + /// + 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; + } + + /// 渲成可读 Texture2D(调用方负责销毁)。导出文件与存资产都从这里出发。 + 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; + } + + /// + /// 渲成 Sprite。返回的 Sprite 持有那张纹理,别去销毁 sprite.texture; + /// 默认轴心在正中、100 像素=1 单位,和 Unity 新建 Sprite 的默认值一致。 + /// + 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); + } + + /// 渲成图片文件的字节。textureToKeep 非空时把中间纹理交出去由调用方销毁,否则就地销毁。 + 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; + } + + /// 渲成图片文件的字节(中间纹理自动回收) + public byte[] RenderToBytes(ShaderBakeImageFormat format, bool destroyTexture = true) + { + Texture2D texture; + byte[] bytes = RenderToBytes(format, out texture); + if (destroyTexture && texture != null) + ReleaseTempObject(texture); + return bytes; + } + + /// 把相机挪到刚好框住面片。改了尺寸/位置之后按一下就回到"看得见"的状态。 + public void FitCameraToGeometry() + { + EnsureGeometry(); + if (m_Geometry == null) + return; + settings.camera.FrameBounds(geometryBounds, settings.aspect); + } + + /// 网格与相机指纹都记下来,界面据此判断要不要重建 + public string stateSignature + { + get { return settings.output.GetTargetSignature() + "|" + settings.surface.GetGeometrySignature() + "|" + settings.camera.GetCameraSignature(); } + } + + /// + /// 只重建网格(面片参数变了)。渲染路径本来就会在签名不符时重建,这里给界面留个显式入口。 + /// + 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(); + } + + /// + /// 回收一次性对象。运行时要走 Destroy(当帧不能立即销毁),编辑器里请传 + /// 让 DestroyImmediate 立刻放掉显存——导一批图时差别很大。 + /// + 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); + } + + /// 编辑器里关窗口时传 immediate,显存和网格内存当场还回去 + 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; + } + } +} diff --git a/Runtime/ShaderBake/ShaderBakeSettings.cs b/Runtime/ShaderBake/ShaderBakeSettings.cs new file mode 100644 index 0000000..3c7ad53 --- /dev/null +++ b/Runtime/ShaderBake/ShaderBakeSettings.cs @@ -0,0 +1,65 @@ +using System; +using UnityEngine; + +namespace XericUI.ShaderBake +{ + /// + /// 一次烘焙所需的全部参数:输出 / 面片 / 离屏相机三组。 + /// 材质不进这里——材质是"内容",会换、会被就地编辑,而这一份是"怎么渲",可以存下来复用。 + /// + [Serializable] + public class ShaderBakeSettings + { + [Tooltip("输出目标")] + public ShaderBakeOutputSettings output = new ShaderBakeOutputSettings(); + + [Tooltip("被渲染的面片")] + public ShaderBakeSurfaceSettings surface = new ShaderBakeSurfaceSettings(); + + [Tooltip("离屏相机")] + public ShaderBakeCameraSettings camera = new ShaderBakeCameraSettings(); + + /// 画面宽高比 + public float aspect + { + get + { + if (output.height <= 0 || output.width <= 0) return 1f; + return (float)output.width / output.height; + } + } + + /// 三组参数各自归位 + public void ClampAll() + { + output.Clamp(); + surface.Clamp(); + } + + /// 复制一份(编辑器窗口拿它当工作副本,改坏了不至于污染存下来的那份) + public ShaderBakeSettings Clone() + { + return FromJson(ToJson()); + } + + /// JsonUtility 只吃 [Serializable] 的类,这里三组都满足;Mesh / 材质引用序列化成实例ID,读回来时由界面重新指派 + public string ToJson() + { + return JsonUtility.ToJson(this); + } + + public static ShaderBakeSettings FromJson(string json) + { + if (string.IsNullOrEmpty(json)) return CreateDefault(); + var s = new ShaderBakeSettings(); + JsonUtility.FromJsonOverwrite(json, s); + s.ClampAll(); + return s; + } + + public static ShaderBakeSettings CreateDefault() + { + return new ShaderBakeSettings(); + } + } +} diff --git a/Runtime/ShaderBake/ShaderBakeSurfaceSettings.cs b/Runtime/ShaderBake/ShaderBakeSurfaceSettings.cs new file mode 100644 index 0000000..45927bd --- /dev/null +++ b/Runtime/ShaderBake/ShaderBakeSurfaceSettings.cs @@ -0,0 +1,108 @@ +using System; +using UnityEngine; + +namespace XericUI.ShaderBake +{ + /// 被烘焙的几何面片是哪一种 + public enum ShaderBakeSurfaceKind + { + /// 单片四边形:两个三角面,UV 从 uvOffset 起、按 uvTiling 铺 + Quad, + + /// 细分平面:顶点数量由 segments 决定,给"在顶点着色器里挪顶点"的 shader 留出梯度 + Plane, + + /// 外部网格:模型(导入的或场景里挑的),UV 沿用网格自己的第 0 套再乘偏移缩放 + Mesh + } + + /// + /// 面片设置:形状、UV 变换与面片自身的变换("面片编辑"就是这一组数值)。 + /// + /// UV 变换落在网格上而不是材质上:这样 shader 里怎么写 uv 就怎么收到结果, + /// 不会被 _MainTex_ST 之类的第二层缩放重复一遍。需要走 ST 的那类 shader 用 + /// 单独开。 + /// + [Serializable] + public class ShaderBakeSurfaceSettings + { + /// 细分上限:单边 512 段=26 万顶点,再多就是把手抖拖进卡顿 + public const int kMaxSegments = 512; + + [Tooltip("面片种类:单片四边形 / 细分平面 / 外部网格")] + public ShaderBakeSurfaceKind kind = ShaderBakeSurfaceKind.Quad; + + [Tooltip("面片尺寸(世界单位)。四边形与细分平面用它的 x/y;外部网格只在 normalizeSize 打开时用它缩放")] + public Vector2 size = Vector2.one; + + [Tooltip("细分平面的行列段数。只有需要顶点插值的 shader 才要调大,四边形恒为 1x1")] + public Vector2Int segments = Vector2Int.one; + + [Tooltip("UV 起点偏移:把贴图的哪一块挪到面片左下角")] + public Vector2 uvOffset; + + [Tooltip("UV 重复次数(缩放):x/y 各铺几遍")] + public Vector2 uvTiling = Vector2.one; + + [Tooltip("外部网格(kind = 外部网格 时生效)")] + public Mesh sourceMesh; + + [Tooltip("外部网格用第几个 subMesh")] + public int meshSubMesh; + + [Tooltip("把外部网格归一化到 size 指定的尺寸(关掉就按模型原始米数渲,可能只占画面一角)")] + public bool normalizeMeshSize = true; + + [Tooltip("面片位置偏移")] + public Vector3 position; + + [Tooltip("面片旋转(欧拉角,度)")] + public Vector3 eulerAngles; + + [Tooltip("面片额外缩放(与 size 相乘,外部网格用它做整体缩放)")] + public Vector3 scale = Vector3.one; + + [Tooltip("把 UV 偏移/重复同时写进 _MainTex_ST:给 Standard / Unlit 那类靠 ST 做缩放的 shader 用")] + public bool applyUvToMainTexST; + + /// 面片自己的局部变换矩阵(DrawMesh 用的那个 model 矩阵) + public Matrix4x4 localMatrix + { + get { return Matrix4x4.TRS(position, Quaternion.Euler(eulerAngles), scale); } + } + + /// + /// 收拢非法数值。段数与 subMesh 都可能被敲成负数或超出网格实际层数,这里一次归位。 + /// + public void Clamp() + { + size = new Vector2( + Mathf.Max(size.x, 0.0001f), + Mathf.Max(size.y, 0.0001f)); + segments = new Vector2Int( + Mathf.Clamp(segments.x, 1, kMaxSegments), + Mathf.Clamp(segments.y, 1, kMaxSegments)); + scale = new Vector3( + FixZero(scale.x), + FixZero(scale.y), + FixZero(scale.z)); + if (uvTiling.x == 0f) uvTiling.x = 1f; + if (uvTiling.y == 0f) uvTiling.y = 1f; + meshSubMesh = Mathf.Max(meshSubMesh, 0); + } + + private static float FixZero(float v) + { + return Mathf.Abs(v) < 0.0001f ? 1f : v; + } + + /// 几何指纹:变了就要重建网格 + public string GetGeometrySignature() + { + var meshId = sourceMesh != null ? sourceMesh.GetInstanceID().ToString() : "none"; + return kind + "_" + size + "_" + segments + "_" + uvOffset + "_" + uvTiling + + "_" + position + "_" + eulerAngles + "_" + scale + "_" + meshId + "_" + meshSubMesh + + "_" + normalizeMeshSize; + } + } +}