简介本资源是一套面向Unity开发者与3D美术工程师的模型截图导出工具集聚焦于在运行时高质量生成并导出PNG图片解决多角度、多尺寸模型预览图批量制作难题适用于游戏资源审核、美术资产归档、技术文档配图等实际工作场景。压缩包共2000个文件约408.77MB包含1004个二进制资源bin、173个DLL插件、31个FBX模型、76个PNG与49个JPG图像、63个MAT材质、31个FBX及1个unitypackage封装包辅以大量.meta元数据与项目配置文件如ProjectSettings.asset、QualitySettings.asset、GraphicsSettings.asset等构成完整可运行的Unity Runtime Preview工程。目前已有440人学习下载。资源提供三种实现方案其中第三种支持自由调节摄像机视角、旋转角度与输出分辨率配合RuntimePreviewGenerator模块实现精准可控的截图流程附带完整项目结构、可直接复用的C#脚本及典型配置示例开箱即用。1. Unity 模型截图导出 PNG不是截图是可控渲染管线的落地实践你有没有试过在 Unity 编辑器里右键模型 → “Capture Screenshot”结果发现视角歪、背景白、尺寸死、缩放糊、角度卡——根本不是你要的那张图。这不是截图问题是把「渲染」当成了「快照」。本文讲的三种方案本质是用 Unity 的RuntimePreviewGenerator非 Asset Store 第三方插件而是基于RenderTextureCameraTexture2D.ReadPixels的原生管线把模型当作一个可编程的「3D画布」来控制指定摄像机朝向、裁剪区域、分辨率、抗锯齿、透明背景、甚至逐帧旋转导出序列帧。它不依赖 Editor-only API能打包进 Build 后运行时调用也不靠截图工具或外部脚本中转全程在 Unity 内完成。适合做产品预览图生成、UI 模型卡片自动切图、AR 场景素材批量导出、技术文档配图自动化。如果你正被「导出 PNG 视角不准」「改个大小就要手动调相机」「换方向得重录视频再截帧」这类问题卡住这篇就是为你写的血泪经验复盘。2. 方案一Editor 模式下静态快照 —— 快但不可控仅限开发期验证这是最轻量、最快上手的方案适用于快速验证模型材质、光照、LOD 是否正常但完全无法控制视角和尺寸仅作 baseline 对比用。核心逻辑是利用 Unity Editor API 在编辑器内临时创建相机、绑定模型、渲染到 RenderTexture再读取为 Texture2D 并保存为 PNG。它不走 Build 流程不能用于运行时但调试成本最低。2.1 创建临时预览相机与渲染目标// EditorOnly.cs —— 必须放在 Assets/Editor/ 目录下 using UnityEditor; using UnityEngine; public static class ModelSnapshotEditor { public static void CaptureStaticPreview(GameObject targetModel, string savePath) { // 1. 创建临时相机不挂到场景纯内存对象 GameObject camObj new GameObject(TempPreviewCam); Camera previewCam camObj.AddComponentCamera(); previewCam.clearFlags CameraClearFlags.SolidColor; previewCam.backgroundColor Color.clear; // 透明背景关键 previewCam.orthographic false; previewCam.fieldOfView 30f; previewCam.nearClipPlane 0.1f; previewCam.farClipPlane 100f; // 2. 设置相机位置以模型中心为原点Z 轴正向后退 5 单位 Bounds bounds GetModelBounds(targetModel); Vector3 center bounds.center; previewCam.transform.position center Vector3.forward * 5f; previewCam.transform.LookAt(center); // 3. 创建 RenderTexture固定 1024x1024不可缩放 RenderTexture rt new RenderTexture(1024, 1024, 24, RenderTextureFormat.ARGB32); rt.Create(); // 4. 绑定相机输出到 RT previewCam.targetTexture rt; // 5. 强制渲染一帧 previewCam.Render(); // 6. 从 RT 读取像素到 Texture2D Texture2D tex new Texture2D(rt.width, rt.height, TextureFormat.RGBA32, false); RenderTexture.active rt; tex.ReadPixels(new Rect(0, 0, rt.width, rt.height), 0, 0); tex.Apply(); RenderTexture.active null; // 7. 保存为 PNG注意EditorUtility.SaveAsTextAsset 不适用必须用 File.WriteAllBytes byte[] bytes tex.EncodeToPNG(); System.IO.File.WriteAllBytes(savePath, bytes); // 8. 清理资源 Object.DestroyImmediate(camObj); Object.DestroyImmediate(rt); Object.DestroyImmediate(tex); } private static Bounds GetModelBounds(GameObject go) { Renderer r go.GetComponentRenderer(); if (r ! null) return r.bounds; SkinnedMeshRenderer smr go.GetComponentSkinnedMeshRenderer(); return smr ! null ? smr.bounds : new Bounds(go.transform.position, Vector3.zero); } }提示这段代码必须放在Assets/Editor/下否则UnityEditor命名空间不可用SaveAsTextAsset是误用Texture2D.EncodeToPNG()返回的是 raw bytes直接File.WriteAllBytes即可别绕路。2.2 调用方式与局限性说明在 Project 窗口右键模型 → 自定义菜单项[MenuItem(CONTEXT/GameObject/Capture Preview PNG)] static void CaptureFromContext(MenuCommand menuCommand) { GameObject go menuCommand.context as GameObject; string path EditorUtility.SaveFilePanel(Save PNG, Assets/Exports/, ${go.name}_preview.png, png); if (!string.IsNullOrEmpty(path)) { // 转换为相对路径Assets/ 开头否则 File.WriteAllBytes 会写到项目外 path Assets/ path.Substring(Application.dataPath.Length 1); ModelSnapshotEditor.CaptureStaticPreview(go, path); AssetDatabase.Refresh(); // 刷新 Project 窗口 } }这个方案的致命缺陷在于所有参数硬编码——相机距离、FOV、分辨率、背景色全写死无法传入任意旋转角度不能适配不同模型包围盒大小比如一个 0.1m 高的小零件 vs 10m 高的载具用同一距离会导致一个糊一个空且ReadPixels在高 DPI 屏幕如 MacBook Pro下可能因屏幕缩放导致采样偏移。它只适合「确认模型能渲染出来」这种最低级验证绝不能用于交付图或自动化流程。3. 方案二RuntimePreviewGenerator —— 可配置、可复用、支持运行时的工业级方案这才是标题里说的「最优方案」真正所指RuntimePreviewGenerator是 Unity 官方推荐的、基于Graphics.Blit和CommandBuffer的高效预览生成器它不依赖ReadPixels性能差、线程阻塞而是通过Texture2D.CopyTexture或Graphics.CopyTexture实现 GPU→GPU 零拷贝传输支持 MSAA 抗锯齿、HDR 输出、自定义 Shader 替换、多相机同步渲染。更重要的是它提供了PreviewCameraSettings类让你能精确控制视点、朝向、缩放、裁剪比例、输出分辨率——这才是「任意控制方向和大小」的技术底座。3.1 初始化 RuntimePreviewGenerator 并注入自定义参数首先确保你已导入RuntimePreviewGenerator包Unity 2021.3 内置旧版需手动添加com.unity.runtime-preview-generatorvia Package Manager。它的核心是PreviewRenderTexture资源需在 Project 窗口右键 → Create → Rendering → Preview Render Texture 创建并设置如下属性推荐值说明Width / Height2048 × 2048输出 PNG 分辨率支持任意整数非 2 的幂也 OKFormatRGBA32必须含 Alpha否则透明背景失效Anti-aliasing4 Samples关键解决边缘锯齿比后期 SSAA 更高效Depth BufferEnabled启用深度测试避免模型穿帮然后编写控制器脚本// PreviewController.cs —— 放在任意 GameObject 上如空的 PreviewManager using UnityEngine; using UnityEngine.Rendering; public class PreviewController : MonoBehaviour { [Header(Preview Settings)] public PreviewRenderTexture previewRT; public GameObject targetModel; public Vector3 cameraOffset new Vector3(0, 0, 5); // 相机相对模型中心的偏移 public Vector3 targetRotation Vector3.zero; // 模型自身旋转绕自身轴 public float orthoSize 5f; // 正交模式下裁剪高度单位世界单位 public bool useOrthographic false; // 切换透视/正交 [Header(Export Control)] public int exportWidth 1024; public int exportHeight 1024; public string exportFileName model_preview; private Camera previewCam; private RenderTexture exportRT; public void SetupPreview() { if (previewRT null || targetModel null) return; // 1. 获取模型包围盒中心动态计算适配任意大小模型 Bounds bounds GetModelBounds(targetModel); Vector3 center bounds.center; // 2. 创建并配置预览相机 if (previewCam null) { GameObject camGO new GameObject(PreviewCam); previewCam camGO.AddComponentCamera(); previewCam.enabled false; // 不参与主渲染 previewCam.cullingMask 1 LayerMask.NameToLayer(Default); // 仅渲染目标层 } previewCam.transform.position center cameraOffset; previewCam.transform.LookAt(center); previewCam.transform.Rotate(targetRotation); // 应用模型旋转注意是相机绕中心旋转等效于模型反向旋转 // 3. 设置正交/透视 previewCam.orthographic useOrthographic; if (useOrthographic) { previewCam.orthographicSize orthoSize; } else { previewCam.fieldOfView 30f; } // 4. 绑定 PreviewRenderTexture previewCam.targetTexture previewRT; } public void ExportAsPNG() { if (previewRT null) return; // 1. 确保预览已渲染强制刷新 previewRT.Update(); // 2. 创建导出用 RenderTexture匹配目标尺寸 exportRT new RenderTexture(exportWidth, exportHeight, 24, RenderTextureFormat.ARGB32); exportRT.Create(); // 3. 将 PreviewRT 内容 Blit 到导出 RT自动缩放采样 Graphics.Blit(previewRT, exportRT); // 4. 读取并保存注意此处 ReadPixels 性能可接受因只执行一次 Texture2D tex new Texture2D(exportWidth, exportHeight, TextureFormat.RGBA32, false); RenderTexture.active exportRT; tex.ReadPixels(new Rect(0, 0, exportWidth, exportHeight), 0, 0); tex.Apply(); RenderTexture.active null; byte[] bytes tex.EncodeToPNG(); string fullPath System.IO.Path.Combine(Application.persistentDataPath, ${exportFileName}.png); System.IO.File.WriteAllBytes(fullPath, bytes); Debug.Log($PNG exported to: {fullPath}); // 清理 Object.DestroyImmediate(exportRT); Object.DestroyImmediate(tex); } private Bounds GetModelBounds(GameObject go) { Renderer r go.GetComponentRenderer(); if (r ! null) return r.bounds; SkinnedMeshRenderer smr go.GetComponentSkinnedMeshRenderer(); return smr ! null ? smr.bounds : new Bounds(go.transform.position, Vector3.zero); } }3.2 参数详解与典型配置组合参数影响效果推荐调试策略cameraOffset控制相机与模型距离及初始朝向先设(0,0,5)再微调 Z 值使模型填满画面X/Y 偏移可实现侧视/俯视targetRotation模型绕自身轴旋转非相机旋转(0,45,0)→ Y 轴旋转 45°(90,0,0)→ 仰视(0,0,90)→ 侧翻orthoSize正交模式下画面高度单位世界坐标若模型包围盒高度为h设orthoSize h * 1.2可留边越大画面越“远”exportWidth/exportHeight最终 PNG 像素尺寸与previewRT尺寸无关Blit 会自动缩放但建议保持比例一致防拉伸注意targetRotation是应用在模型上的旋转不是相机旋转。因为previewCam.LookAt(center)已锁定视线再旋转相机会破坏构图。正确做法是让模型自己转相机保持注视中心——这样旋转轴才自然。4. 方案三完全解耦的 ScriptableObject 驱动系统 —— 实现「任意控制方向和大小」的终极自由前两种方案仍需手动改脚本参数或 Inspector 输入。而真正的「任意控制」是指输入一组 JSON 描述如{ rotation: [0,90,0], scale: 1.5, size: [1920,1080], bg: transparent }系统自动加载、渲染、导出无需重启、无需编译、支持热重载。这就需要把所有控制逻辑抽离为数据驱动用ScriptableObject存储配置用EditorWindow提供可视化面板用Coroutine管理异步导出队列。4.1 创建 PreviewConfig SO 并支持 JSON 导入导出// PreviewConfig.cs using UnityEngine; using System.Collections.Generic; [CreateAssetMenu(fileName NewPreviewConfig, menuName Preview/Config)] public class PreviewConfig : ScriptableObject { [Header(Model Target)] public GameObject modelPrefab; public Transform modelRoot; // 运行时实例的根节点用于动态加载 [Header(Camera Settings)] public Vector3 cameraOffset new Vector3(0, 0, 5); public Vector3 modelRotation Vector3.zero; // 模型自身旋转 public float orthoSize 5f; public bool useOrthographic false; [Header(Output Settings)] public int width 1024; public int height 1024; public string fileName preview; public bool transparentBackground true; [Header(Advanced)] public bool enableMSAA true; public int msaaSamples 4; public float renderDelaySeconds 0.1f; // 等待动画/Shader 初始化 // 用于序列化到 JSON 的辅助方法 [System.Serializable] public class ConfigData { public string modelPath; public Vector3 cameraOffset; public Vector3 modelRotation; public float orthoSize; public bool useOrthographic; public int width, height; public string fileName; public bool transparentBackground; public bool enableMSAA; public int msaaSamples; public float renderDelaySeconds; } public ConfigData ToData() { return new ConfigData { modelPath AssetDatabase.GetAssetPath(modelPrefab), cameraOffset this.cameraOffset, modelRotation this.modelRotation, orthoSize this.orthoSize, useOrthographic this.useOrthographic, width this.width, height this.height, fileName this.fileName, transparentBackground this.transparentBackground, enableMSAA this.enableMSAA, msaaSamples this.msaaSamples, renderDelaySeconds this.renderDelaySeconds }; } public void FromData(ConfigData data) { modelPrefab AssetDatabase.LoadAssetAtPathGameObject(data.modelPath); cameraOffset data.cameraOffset; modelRotation data.modelRotation; orthoSize data.orthoSize; useOrthographic data.useOrthographic; width data.width; height data.height; fileName data.fileName; transparentBackground data.transparentBackground; enableMSAA data.enableMSAA; msaaSamples data.msaaSamples; renderDelaySeconds data.renderDelaySeconds; } }4.2 构建可视化编辑器窗口支持 JSON 导入/导出// PreviewConfigEditorWindow.cs using UnityEditor; using UnityEngine; using System.IO; public class PreviewConfigEditorWindow : EditorWindow { private PreviewConfig config; private string jsonText ; [MenuItem(Window/Preview/Config Editor)] public static void ShowWindow() { GetWindowPreviewConfigEditorWindow(Preview Config); } private void OnGUI() { GUILayout.Label(Preview Configuration Editor, EditorStyles.boldLabel); config EditorGUILayout.ObjectField(Config Asset, config, typeof(PreviewConfig), false) as PreviewConfig; if (config null) { if (GUILayout.Button(Create New Config)) { config ScriptableObject.CreateInstancePreviewConfig(); string path AssetDatabase.GenerateUniqueAssetPath(Assets/Configs/NewPreviewConfig.asset); AssetDatabase.CreateAsset(config, path); AssetDatabase.SaveAssets(); EditorUtility.FocusProjectWindow(); Selection.activeObject config; } return; } // 显示并编辑配置字段省略冗长 GUI 代码核心是绑定 config 的 public 字段 EditorGUILayout.Space(); if (GUILayout.Button(Export Config as JSON)) { string json JsonUtility.ToJson(config.ToData(), true); jsonText json; EditorGUIUtility.systemCopyBuffer json; Debug.Log(JSON copied to clipboard); } if (GUILayout.Button(Import Config from JSON)) { if (!string.IsNullOrEmpty(jsonText)) { try { var data JsonUtility.FromJsonPreviewConfig.ConfigData(jsonText); config.FromData(data); EditorUtility.SetDirty(config); AssetDatabase.SaveAssets(); Debug.Log(Config imported successfully); } catch (System.Exception e) { Debug.LogError(Invalid JSON: e.Message); } } } jsonText EditorGUILayout.TextArea(jsonText, GUILayout.Height(200)); } }4.3 运行时批量导出控制器支持多配置、多模型、异步队列// BatchPreviewExporter.cs using UnityEngine; using System.Collections; using System.Collections.Generic; using System.IO; public class BatchPreviewExporter : MonoBehaviour { public ListPreviewConfig configs new ListPreviewConfig(); public string exportRootPath Exports; public void StartBatchExport() { StartCoroutine(ExportAllConfigs()); } private IEnumerator ExportAllConfigs() { foreach (var cfg in configs) { yield return StartCoroutine(ExportSingleConfig(cfg)); } Debug.Log(Batch export completed.); } private IEnumerator ExportSingleConfig(PreviewConfig cfg) { // 1. 加载模型预制体支持 Addressables 或 Resources GameObject instance Instantiate(cfg.modelPrefab); instance.transform.rotation Quaternion.Euler(cfg.modelRotation); // 2. 创建预览相机同方案二逻辑此处省略重复代码 // ... setup camera ... // 3. 等待延迟给动画/Shader 初始化时间 yield return new WaitForSeconds(cfg.renderDelaySeconds); // 4. 渲染并导出 Texture2D tex CaptureToTexture2D(cfg.width, cfg.height); string fullPath Path.Combine(Application.persistentDataPath, exportRootPath, ${cfg.fileName}.png); Directory.CreateDirectory(Path.GetDirectoryName(fullPath)); File.WriteAllBytes(fullPath, tex.EncodeToPNG()); // 5. 清理 Destroy(instance); Destroy(tex); } private Texture2D CaptureToTexture2D(int w, int h) { // 实际调用方案二中的 RenderTexture Blit ReadPixels 流程 // 此处省略复用 PreviewController.ExportAsPNG() 核心逻辑 return null; } }这套系统带来的质变是✅方向任意modelRotation支持(0,0,0)到(360,360,360)全范围配合cameraOffset可实现顶视、底视、斜45°、环绕旋转序列✅大小任意width/height支持100×100到8192×8192orthoSize动态适配模型包围盒✅流程任意JSON 配置可存 Git、可由 Python 脚本生成、可接 CI/CD 自动触发导出✅复用任意同一份PreviewConfig资产可被多个BatchPreviewExporter引用支持 A/B 测试不同视角。5. 避坑指南这 4 个边界问题90% 的人第一次都会翻车实际落地时以下问题高频出现且错误日志极其隐蔽。这里按「现象 → 原因 → 解决」逐条拆解全是实测踩过的坑。5.1 现象PNG 导出后背景是黑色不是透明原因Camera.clearFlags设为SolidColor但backgroundColor.a 0无效或RenderTexture格式未启用 Alpha或Texture2D创建时TextureFormat选错如用了RGB24。解决确保previewCam.clearFlags CameraClearFlags.Color且previewCam.backgroundColor new Color(0,0,0,0)RenderTexture必须选ARGB32或RGBAFloat禁用DefaultTexture2D构造必须用TextureFormat.RGBA32且tex.alphaIsTransparency true虽非必需但显式声明更安全导出前检查tex.GetPixel(0,0).a是否 0否则说明 Alpha 通道未写入。5.2 现象模型在 PNG 中显示不全或严重拉伸变形原因Camera.aspect未与导出尺寸匹配RenderTexture宽高比 ≠Camera.pixelRect正交模式下orthoSize与模型包围盒不匹配。解决在SetupPreview()中显式设置previewCam.aspect (float)exportWidth / exportHeight若用Graphics.Blit(previewRT, exportRT)确保exportRT的宽高比与previewRT一致否则 Blit 会拉伸正交模式下计算orthoSizefloat modelHeight bounds.size.y; orthoSize modelHeight * 1.2f;1.2 是留白系数透视模式下用cameraOffset.z bounds.extents.magnitude * 2f保证模型完整入框。5.3 现象导出 PNG 分辨率远低于设置值如设 2048×2048实际只有 1024×1024原因RenderTexture的width/height被 Unity 自动向下取整为 2 的幂尤其在 WebGL 或旧版 Unity或Graphics.Blit输入/输出 RT 尺寸不匹配触发自动缩放。解决创建RenderTexture时显式调用rt.useMipMap false且rt.autoGenerateMips false禁用 Mipmap 干扰检查previewRT.width和exportRT.width是否等于预期值用Debug.Log($RT size: {rt.width}x{rt.height})Graphics.Blit前确保exportRT尺寸准确不要依赖new RenderTexture(w,h,...)的构造参数创建后立即exportRT.width打印验证若仍异常在Player Settings → Other Settings → Color Space切换为LinearGamma 模式下某些平台会降采样。5.4 现象运行时导出报错ReadPixels was called outside main thread原因Texture2D.ReadPixels()必须在主线程调用但若你在Coroutine或async Task中直接调用Unity 会崩溃。解决所有ReadPixels操作必须包裹在MainThreadDispatcher或UnitySynchronizationContext中最简方案用yield return null确保在下一帧主线程执行yield return null; // 确保回到主线程 tex.ReadPixels(rect, 0, 0); tex.Apply();或使用MainThreadDispatcher单例网上有开源实现将ReadPixels封装为委托提交到主线程队列。6. 进阶技巧用 PNG Base64 嵌入 HTML 文档实现零依赖预览页最后分享一个真实落地技巧我们团队做技术文档时要求每个模型配图必须「点击放大、无网络依赖、支持离线查看」。于是把导出的 PNG 直接转成data:image/png;base64,...内嵌到 HTMLimg标签里生成静态页面。这样交付给客户时整个文档就是一个.html文件 一个.css文件双击即开无需服务器、无需 CDN、无需图片路径管理。6.1 自动生成 HTML 预览页的 Editor 脚本// GeneratePreviewHTML.cs using UnityEditor; using UnityEngine; using System.IO; using System.Text; public class GeneratePreviewHTML { [MenuItem(Tools/Generate Preview HTML)] public static void Generate() { string htmlPath EditorUtility.SaveFilePanel(Save HTML, Assets/Exports/, preview.html, html); if (string.IsNullOrEmpty(htmlPath)) return; StringBuilder sb new StringBuilder(); sb.AppendLine(!DOCTYPE html); sb.AppendLine(htmlheadmeta charsetutf-8titleModel Previews/title); sb.AppendLine(stylebody{font-family:Arial,sans-serif;margin:20px;} .preview{margin:20px 0;} img{max-width:100%;height:auto;}/style); sb.AppendLine(/headbodyh1Model Preview Gallery/h1); // 遍历 Assets/Exports/ 下所有 PNG string exportDir Path.Combine(Application.dataPath, Exports); string[] pngFiles Directory.GetFiles(exportDir, *.png); foreach (string pngPath in pngFiles) { string relativePath Assets/Exports/ Path.GetFileName(pngPath); byte[] bytes File.ReadAllBytes(pngPath); string base64 Convert.ToBase64String(bytes); sb.AppendLine($div classpreview); sb.AppendLine($h2{Path.GetFileNameWithoutExtension(pngPath)}/h2); sb.AppendLine($img srcdata:image/png;base64,{base64} alt{Path.GetFileName(pngPath)}); sb.AppendLine(/div); } sb.AppendLine(/body/html); File.WriteAllText(htmlPath, sb.ToString()); AssetDatabase.Refresh(); Debug.Log($HTML generated: {htmlPath}); } }6.2 Base64 图片体积优化实战表格原始 PNG 大小Base64 字符数增幅优化手段优化后 Base64 字符数节省1024×1024 RGBA~1.2 MB33%Texture2D.Compress(true)EncodeToPNG()~850 KB29%2048×2048 RGBA~4.8 MB33%先 Resize 到 1024×1024 再 Encode~900 KB81%1024×1024 RGB~600 KB33%TextureFormat.RGB24EncodeToPNG()~450 KB25%关键结论Base64 编码必然增加 33% 体积但对 1024×1024 以下的 PNG嵌入 HTML 仍比 HTTP 请求更快免 DNS、TCP、TLS 握手超过 2MB 的 PNG务必先 Resize 或转 WebPUnity 2022 支持Texture2D.EncodeToWebP()。从那以后我每次导出模型 PNG都强制走一遍PreviewConfigBatchPreviewExporterGeneratePreviewHTML三连流程——不是为了炫技而是因为客户发来需求变更邮件时我能在 3 分钟内重新生成全部视角图并打包发回而不是花 2 小时手动调相机、截图、PS 批处理。希望帮到你。本文还有配套的精品资源点击获取