feat(ShaderBake): 新增 Bake Shader As Image 编辑器窗口(UI Toolkit + UXML)

- 左侧缩放/拖拽预览 + 透明底棋盘,右侧可折叠参数区与材质属性表
- 界面结构全部落在 BakeShaderWindow.uxml / BakeShaderPropertyRow.uxml,代码只做接线
- 来源支持 Shader(临时材质,关窗口销毁)与 Material(副本,可写回/丢弃)
- 导出下拉接入 PNG/JPG/TGA/EXR 与 Texture2D / Sprite / RenderTexture 资产
- 面片参数含 UV 偏移/重复、尺寸、变换;支持取场景网格或导入外部模型
- 参数以 JSON 存 EditorPrefs,并支持复制/粘贴整套烘焙参数
This commit is contained in:
2026-11-05 16:56:32 +08:00
parent a769cbac00
commit 1555ef658d
8 changed files with 2690 additions and 0 deletions
@@ -0,0 +1,892 @@
using System;
using System.Collections.Generic;
using System.IO;
using UnityEditor;
using UnityEditor.UIElements;
using UnityEngine;
using UnityEngine.UIElements;
using XericUI.Core;
namespace XericUI.ShaderBake.Editor
{
/// <summary>
/// Bake Shader As Image 窗口:把 shader / 材质渲成图,右侧调参数与材质属性,左侧实时看结果,
/// 顶部导出成文件或 Unity 资产。
///
/// <para><b>界面结构在 UXML,这里只做接线</b>:控件按名字取,每个绑定同时登记一个
/// "把设置里的值写回这个控件"的同步动作(<see cref="SyncUiFromSettings"/>)。
/// 参数每次提交后都走一遍 Clamp 再整体回写,所以界面显示的永远是真正生效的那个值,
/// 而不是用户敲进去的那个数——这条性质只在"同步动作和绑定一起登记"时保得住。</para>
///
/// <para><b>材质永远是一张临时副本</b>(见 <see cref="ShaderBakeMaterialSource"/>):
/// 调滑块不该把项目里的 .mat 改脏,想留下改动请按"写回原材质"。</para>
/// </summary>
public sealed class BakeShaderAsImageWindow : EditorWindow
{
private const string kUxmlPath = "Packages/com.lrss3.xericuiactionvessel/Editor/ShaderBake/BakeShaderWindow.uxml";
private const string kUssPath = "Packages/com.lrss3.xericuiactionvessel/Editor/ShaderBake/BakeShaderWindow.uss";
private const string kRowUxmlPath = "Packages/com.lrss3.xericuiactionvessel/Editor/ShaderBake/BakeShaderPropertyRow.uxml";
private const string kPrefSettings = "XericUI.ShaderBake.Settings";
private const string kPrefAutoRefresh = "XericUI.ShaderBake.AutoRefresh";
private const string kPrefChecker = "XericUI.ShaderBake.Checker";
private const string kPrefDetailWidth = "XericUI.ShaderBake.DetailWidth";
private const string kPrefSource = "XericUI.ShaderBake.SourceAsset";
private const float kDefaultDetailWidth = 340f;
private static readonly string[] kAntiAliasingChoices = { "1", "2", "4", "8" };
private ShaderBakeMaterialSource m_Source;
private ShaderBakeRenderer m_Renderer;
private ShaderBakePreviewPane m_Preview;
private ShaderBakePropertyTable m_PropertyTable;
private ShaderBakeExporter m_Exporter;
private ObjectField m_ShaderField;
private ObjectField m_MaterialField;
private Label m_SourceNote;
private Button m_ExportButton;
private ToolbarToggle m_AutoRefreshToggle;
private ToolbarToggle m_CheckerToggle;
private Label m_StatusMessage;
private Label m_StatusSize;
private Label m_StatusTime;
private Label m_StatusSource;
private VisualElement m_DetailPane;
private VisualElement m_DetailSplit;
private readonly List<Action> m_Syncers = new List<Action>();
private bool m_RenderPending;
private double m_LastRenderMs = -1;
[MenuItem(XericRegistrationPaths.ToolBar + "/Bake Shader As Image", false, 20)]
private static void OpenFromMenu()
{
BakeShaderAsImageWindow window = GetWindow<BakeShaderAsImageWindow>();
window.titleContent = new GUIContent("Bake Shader");
window.minSize = new Vector2(640f, 380f);
}
private void CreateGUI()
{
VisualTreeAsset tree = LoadAsset<VisualTreeAsset>(kUxmlPath, "BakeShaderWindow");
if (tree == null)
{
Debug.LogError("[ShaderBake] 找不到界面文件 " + kUxmlPath + ",窗口无法构建");
return;
}
rootVisualElement.Clear();
tree.CloneTree(rootVisualElement);
StyleSheet sheet = LoadAsset<StyleSheet>(kUssPath, "BakeShaderWindow");
if (sheet != null)
rootVisualElement.styleSheets.Add(sheet);
m_Source = new ShaderBakeMaterialSource();
m_Renderer = new ShaderBakeRenderer();
m_Exporter = new ShaderBakeExporter(m_Renderer, SetStatus);
m_Exporter.settingsReplaced += OnSettingsReplaced;
try
{
m_Preview = new ShaderBakePreviewPane(rootVisualElement);
}
catch (InvalidOperationException e)
{
Debug.LogError("[ShaderBake] " + e.Message);
return;
}
CollectReferences();
BuildPropertyTable();
BindToolbar();
BindSections();
BindSettings();
BindDetailSplit();
RestorePrefs();
SyncUiFromSettings();
AdoptSelectionIfEmpty();
AssignSource(m_Source.sourceShader, m_Source.sourceMaterial, true);
DoRender();
}
private void OnDisable()
{
SavePrefs();
if (m_Exporter != null)
m_Exporter.settingsReplaced -= OnSettingsReplaced;
if (m_PropertyTable != null)
m_PropertyTable.Dispose();
if (m_Preview != null)
m_Preview.Dispose();
// 临时材质一定要还:它挂着的是 shader,不销毁就是每次开关窗口漏一份
if (m_Source != null) m_Source.Dispose(true);
if (m_Renderer != null) m_Renderer.Dispose(true);
m_Source = null;
m_Renderer = null;
m_Preview = null;
m_PropertyTable = null;
m_Syncers.Clear();
}
private void OnFocus()
{
AdoptSelectionIfEmpty();
}
/// <summary> 参数被整块换掉(粘贴 JSON)后:回写界面并重画,否则预览和右侧数字对不上 </summary>
private void OnSettingsReplaced()
{
SyncUiFromSettings();
RequestRender();
}
// ── 引用收集 ────────────────────────────────────────────
private void CollectReferences()
{
m_ShaderField = Require<ObjectField>("src-shader");
m_MaterialField = Require<ObjectField>("src-material");
m_SourceNote = Require<Label>("src-note");
m_ExportButton = Require<ToolbarButton>("export-menu");
m_AutoRefreshToggle = Require<ToolbarToggle>("auto-refresh");
m_CheckerToggle = Require<ToolbarToggle>("show-checker");
m_StatusMessage = Require<Label>("status-message");
m_StatusSize = Require<Label>("status-size");
m_StatusTime = Require<Label>("status-time");
m_StatusSource = Require<Label>("status-source");
m_DetailPane = Require<VisualElement>("detail-pane");
m_DetailSplit = Require<VisualElement>("detail-split");
}
private T Require<T>(string name) where T : VisualElement
{
T element = rootVisualElement.Q<T>(name);
if (element == null)
Debug.LogError("[ShaderBake] UXML 里缺节点 " + name + ",对应功能不可用");
return element;
}
private void BuildPropertyTable()
{
VisualTreeAsset rowTemplate = LoadAsset<VisualTreeAsset>(kRowUxmlPath, "BakeShaderPropertyRow");
if (rowTemplate == null)
{
Debug.LogError("[ShaderBake] 找不到属性行模板 " + kRowUxmlPath);
return;
}
m_PropertyTable = new ShaderBakePropertyTable(rootVisualElement, rowTemplate);
m_PropertyTable.changed += OnMaterialChanged;
}
// ── 工具栏 ──────────────────────────────────────────────
private void BindToolbar()
{
if (m_ExportButton != null)
m_ExportButton.clicked += ShowExportMenu;
ToolbarButton render = rootVisualElement.Q<ToolbarButton>("render-now");
if (render != null)
render.clicked += DoRender;
if (m_AutoRefreshToggle != null)
m_AutoRefreshToggle.RegisterValueChangedCallback(evt => { SavePrefs(); });
if (m_CheckerToggle != null)
m_CheckerToggle.RegisterValueChangedCallback(evt =>
{
if (m_Preview != null) m_Preview.SetCheckerVisible(evt.newValue);
SavePrefs();
});
Click("zoom-in", () => { if (m_Preview != null) { m_Preview.autoFit = false; m_Preview.ZoomIn(); } });
Click("zoom-out", () => { if (m_Preview != null) { m_Preview.autoFit = false; m_Preview.ZoomOut(); } });
Click("zoom-fit", () => { if (m_Preview != null) m_Preview.FitToView(); });
Click("zoom-actual", () => { if (m_Preview != null) m_Preview.ActualSize(); });
Click("reset-settings", ResetSettings);
}
// 普通按钮和工具栏按钮都走这里:Q<Button> 取不到 ToolbarButton,Q<ToolbarButton> 也取不到普通按钮
private void Click(string name, Action action)
{
Button button = rootVisualElement.Q<Button>(name);
if (button == null)
{
Debug.LogError("[ShaderBake] UXML 里缺按钮 " + name);
return;
}
button.clicked += action;
}
private void ShowExportMenu()
{
GenericMenu menu = new GenericMenu();
m_Exporter.BuildMenu(menu, SuggestedExportName());
if (m_ExportButton != null)
menu.DropDown(m_ExportButton.worldBound);
else
menu.ShowAsContext();
}
private string SuggestedExportName()
{
if (m_Source.sourceMaterial != null)
return m_Source.sourceMaterial.name;
if (m_Source.sourceShader != null)
{
string[] parts = m_Source.sourceShader.name.Split('/');
return parts[parts.Length - 1];
}
return "BakedImage";
}
// ── 分组折叠 ────────────────────────────────────────────
private void BindSections()
{
Collapsible("sec-source", "sec-source-body");
Collapsible("sec-output", "sec-output-body");
Collapsible("sec-surface", "sec-surface-body");
Collapsible("sec-camera", "sec-camera-body");
Collapsible("sec-props", "sec-props-body");
}
private void Collapsible(string headName, string bodyName)
{
Toggle head = rootVisualElement.Q<Toggle>(headName);
VisualElement body = rootVisualElement.Q<VisualElement>(bodyName);
if (head == null || body == null)
{
Debug.LogError("[ShaderBake] 分组节点不成对:" + headName + " / " + bodyName);
return;
}
body.style.display = head.value ? DisplayStyle.Flex : DisplayStyle.None;
head.RegisterValueChangedCallback(evt =>
body.style.display = evt.newValue ? DisplayStyle.Flex : DisplayStyle.None);
}
// ── 输入源 ──────────────────────────────────────────────
private void BindSettings()
{
// 两个入口互斥:填了一个另一个必须清空,否则界面会显示"两个来源"而实际用其中一张
if (m_ShaderField != null)
{
m_ShaderField.objectType = typeof(Shader);
m_ShaderField.allowSceneObjects = false;
m_ShaderField.RegisterValueChangedCallback(evt =>
{
var shader = evt.newValue as Shader;
if (shader != null)
AssignSource(shader, null, false);
else if (m_MaterialField != null && m_MaterialField.value == null)
AssignSource(null, null, false);
});
}
if (m_MaterialField != null)
{
m_MaterialField.objectType = typeof(Material);
m_MaterialField.allowSceneObjects = true;
m_MaterialField.RegisterValueChangedCallback(evt =>
{
var material = evt.newValue as Material;
if (material != null)
AssignSource(null, material, false);
else if (m_ShaderField != null && m_ShaderField.value == null)
AssignSource(null, null, false);
});
}
Button apply = rootVisualElement.Q<Button>("src-apply");
if (apply != null)
apply.clicked += ApplyToSource;
Button revert = rootVisualElement.Q<Button>("src-revert");
if (revert != null)
revert.clicked += RevertToSource;
BindOutput();
BindSurface();
BindCamera();
}
/// <summary>
/// 指定来源。shader 与 material 只能有一个非空,另一个会被清掉。
/// <paramref name="keepFields"/> 为真时不改对象字段(从存档恢复时用,字段已经在别处填好)。
/// </summary>
private void AssignSource(Shader shader, Material material, bool keepFields)
{
if (shader != null)
m_Source.Assign(shader);
else if (material != null)
m_Source.Assign(material);
else
m_Source.Clear();
m_Renderer.material = m_Source.material;
if (!keepFields)
{
if (m_ShaderField != null) m_ShaderField.SetValueWithoutNotify(shader);
if (m_MaterialField != null) m_MaterialField.SetValueWithoutNotify(material);
}
SetSourceNote();
RefreshPropertyTable();
DoRender();
}
private void SetSourceNote()
{
if (m_SourceNote == null)
return;
m_SourceNote.text = m_Source.description;
if (m_StatusSource != null)
m_StatusSource.text = m_Source.description;
}
private void RefreshPropertyTable()
{
if (m_PropertyTable == null)
return;
m_PropertyTable.SetTarget(m_Source.shader, m_Source.material);
Label note = rootVisualElement.Q<Label>("props-note");
if (note != null)
note.text = m_Source.shader == null
? "未指定 shader"
: (m_PropertyTable.rowCount + " 项可编辑属性(隐藏属性不列出)");
// 只有"来源是材质"才有可写回/可回读的原资产
SetApplyRevertEnabled(m_Source.sourceMaterial != null);
}
private void SetApplyRevertEnabled(bool enabled)
{
Button apply = rootVisualElement.Q<Button>("src-apply");
Button revert = rootVisualElement.Q<Button>("src-revert");
if (apply != null) apply.SetEnabled(enabled);
if (revert != null) revert.SetEnabled(enabled);
}
private void ApplyToSource()
{
if (!m_Source.ApplyToSource())
{
SetStatus("没有原材质可写(来源是 Shader)");
return;
}
EditorUtility.SetDirty(m_Source.sourceMaterial);
SetStatus("已把参数写回 " + m_Source.sourceMaterial.name);
DoRender();
}
private void RevertToSource()
{
if (!m_Source.RevertToSource())
{
SetStatus("没有原材质可回读");
return;
}
m_Renderer.material = m_Source.material;
RefreshPropertyTable();
SetStatus("已丢弃改动,副本回到原材质参数");
DoRender();
}
private void OnMaterialChanged()
{
RequestRender();
}
// ── 输出 ────────────────────────────────────────────────
private void BindOutput()
{
BindInt("out-width", () => m_Renderer.settings.output.width, v => m_Renderer.settings.output.width = v);
BindInt("out-height", () => m_Renderer.settings.output.height, v => m_Renderer.settings.output.height = v);
BindInt("out-depth", () => m_Renderer.settings.output.depthBuffer, v => m_Renderer.settings.output.depthBuffer = v);
BindInt("out-pass", () => m_Renderer.settings.output.shaderPass, v => m_Renderer.settings.output.shaderPass = v);
BindBool("out-hdr", () => m_Renderer.settings.output.hdr, v => m_Renderer.settings.output.hdr = v);
BindBool("out-srgb", () => m_Renderer.settings.output.sRGB, v => m_Renderer.settings.output.sRGB = v);
BindBool("out-flip", () => m_Renderer.settings.output.flipY, v => m_Renderer.settings.output.flipY = v);
BindColor("out-clear", () => m_Renderer.settings.output.clearColor, v => m_Renderer.settings.output.clearColor = v);
DropdownField msaa = rootVisualElement.Q<DropdownField>("out-msaa");
if (msaa != null)
{
msaa.choices = new List<string>(kAntiAliasingChoices);
m_Syncers.Add(() => msaa.SetValueWithoutNotify(
ShaderBakeOutputSettings.SnapAntiAliasing(m_Renderer.settings.output.antiAliasing).ToString()));
msaa.RegisterValueChangedCallback(evt =>
{
m_Renderer.settings.output.antiAliasing = int.Parse(evt.newValue);
Commit();
});
}
}
// ── 面片 ────────────────────────────────────────────────
private void BindSurface()
{
EnumField kind = rootVisualElement.Q<EnumField>("surf-kind");
if (kind != null)
{
// 2022.1 的 EnumField 只认一个默认值,挡位表由枚举本身提供
kind.Init(ShaderBakeSurfaceKind.Quad);
m_Syncers.Add(() => kind.SetValueWithoutNotify(m_Renderer.settings.surface.kind));
kind.RegisterValueChangedCallback(evt =>
{
m_Renderer.settings.surface.kind = (ShaderBakeSurfaceKind)evt.newValue;
Commit();
});
}
BindFloat("surf-size-x", () => m_Renderer.settings.surface.size.x, v => SetSizeX(v));
BindFloat("surf-size-y", () => m_Renderer.settings.surface.size.y, v => SetSizeY(v));
BindInt("surf-seg-x", () => m_Renderer.settings.surface.segments.x, v => SetSegmentX(v));
BindInt("surf-seg-y", () => m_Renderer.settings.surface.segments.y, v => SetSegmentY(v));
BindFloat("surf-uv-off-x", () => m_Renderer.settings.surface.uvOffset.x, v => SetUvOffsetX(v));
BindFloat("surf-uv-off-y", () => m_Renderer.settings.surface.uvOffset.y, v => SetUvOffsetY(v));
BindFloat("surf-uv-tile-x", () => m_Renderer.settings.surface.uvTiling.x, v => SetUvTileX(v));
BindFloat("surf-uv-tile-y", () => m_Renderer.settings.surface.uvTiling.y, v => SetUvTileY(v));
BindFloat("surf-pos-x", () => m_Renderer.settings.surface.position.x, v => SetPos(v, m_Renderer.settings.surface.position.y, m_Renderer.settings.surface.position.z));
BindFloat("surf-pos-y", () => m_Renderer.settings.surface.position.y, v => SetPos(m_Renderer.settings.surface.position.x, v, m_Renderer.settings.surface.position.z));
BindFloat("surf-pos-z", () => m_Renderer.settings.surface.position.z, v => SetPos(m_Renderer.settings.surface.position.x, m_Renderer.settings.surface.position.y, v));
BindFloat("surf-rot-x", () => m_Renderer.settings.surface.eulerAngles.x, v => SetRot(v, m_Renderer.settings.surface.eulerAngles.y, m_Renderer.settings.surface.eulerAngles.z));
BindFloat("surf-rot-y", () => m_Renderer.settings.surface.eulerAngles.y, v => SetRot(m_Renderer.settings.surface.eulerAngles.x, v, m_Renderer.settings.surface.eulerAngles.z));
BindFloat("surf-rot-z", () => m_Renderer.settings.surface.eulerAngles.z, v => SetRot(m_Renderer.settings.surface.eulerAngles.x, m_Renderer.settings.surface.eulerAngles.y, v));
BindFloat("surf-scale-x", () => m_Renderer.settings.surface.scale.x, v => SetScale(v, m_Renderer.settings.surface.scale.y, m_Renderer.settings.surface.scale.z));
BindFloat("surf-scale-y", () => m_Renderer.settings.surface.scale.y, v => SetScale(m_Renderer.settings.surface.scale.x, v, m_Renderer.settings.surface.scale.z));
BindFloat("surf-scale-z", () => m_Renderer.settings.surface.scale.z, v => SetScale(m_Renderer.settings.surface.scale.x, m_Renderer.settings.surface.scale.y, v));
BindInt("surf-submesh", () => m_Renderer.settings.surface.meshSubMesh, v => m_Renderer.settings.surface.meshSubMesh = v);
BindBool("surf-normalize", () => m_Renderer.settings.surface.normalizeMeshSize, v => m_Renderer.settings.surface.normalizeMeshSize = v);
BindBool("surf-uv-st", () => m_Renderer.settings.surface.applyUvToMainTexST, v => m_Renderer.settings.surface.applyUvToMainTexST = v);
ObjectField meshField = rootVisualElement.Q<ObjectField>("surf-mesh");
if (meshField != null)
{
meshField.objectType = typeof(Mesh);
meshField.allowSceneObjects = true;
m_Syncers.Add(() => meshField.SetValueWithoutNotify(m_Renderer.settings.surface.sourceMesh));
meshField.RegisterValueChangedCallback(evt =>
{
m_Renderer.settings.surface.sourceMesh = evt.newValue as Mesh;
if (m_Renderer.settings.surface.sourceMesh != null && m_Renderer.settings.surface.kind != ShaderBakeSurfaceKind.Mesh)
m_Renderer.settings.surface.kind = ShaderBakeSurfaceKind.Mesh;
Commit();
});
}
Click("surf-reset", ResetSurface);
Click("surf-pick-scene", PickSceneMesh);
Click("surf-rot-90", () => { m_Renderer.settings.surface.eulerAngles += new Vector3(0f, 0f, 90f); Commit(); });
Click("surf-flip-u", () => FlipUv(true));
Click("surf-flip-v", () => FlipUv(false));
Button importModel = rootVisualElement.Q<Button>("surf-import-model");
if (importModel != null)
importModel.clicked += ImportModel;
}
// 面片那些"改一个分量"的写法摊成方法,绑定处只留一行,读起来不至于全是三元组
private void SetSizeX(float v) { Vector2 s = m_Renderer.settings.surface.size; s.x = v; m_Renderer.settings.surface.size = s; }
private void SetSizeY(float v) { Vector2 s = m_Renderer.settings.surface.size; s.y = v; m_Renderer.settings.surface.size = s; }
private void SetSegmentX(int v) { Vector2Int s = m_Renderer.settings.surface.segments; s.x = v; m_Renderer.settings.surface.segments = s; }
private void SetSegmentY(int v) { Vector2Int s = m_Renderer.settings.surface.segments; s.y = v; m_Renderer.settings.surface.segments = s; }
private void SetUvOffsetX(float v) { Vector2 u = m_Renderer.settings.surface.uvOffset; u.x = v; m_Renderer.settings.surface.uvOffset = u; }
private void SetUvOffsetY(float v) { Vector2 u = m_Renderer.settings.surface.uvOffset; u.y = v; m_Renderer.settings.surface.uvOffset = u; }
private void SetUvTileX(float v) { Vector2 u = m_Renderer.settings.surface.uvTiling; u.x = v; m_Renderer.settings.surface.uvTiling = u; }
private void SetUvTileY(float v) { Vector2 u = m_Renderer.settings.surface.uvTiling; u.y = v; m_Renderer.settings.surface.uvTiling = u; }
private void SetPos(float x, float y, float z) { m_Renderer.settings.surface.position = new Vector3(x, y, z); }
private void SetRot(float x, float y, float z) { m_Renderer.settings.surface.eulerAngles = new Vector3(x, y, z); }
private void SetScale(float x, float y, float z) { m_Renderer.settings.surface.scale = new Vector3(x, y, z); }
private void FlipUv(bool horizontal)
{
// 镜像后覆盖范围必须和原来一样,否则图会被推出画面。
// uv = uv01 * t + o 的取值范围是 [o, o+t];取 t' = -t、o' = o+t 后范围变成 [o+t, o],正好还是同一段
ShaderBakeSurfaceSettings s = m_Renderer.settings.surface;
if (horizontal)
{
s.uvOffset.x += s.uvTiling.x;
s.uvTiling.x = -s.uvTiling.x;
}
else
{
s.uvOffset.y += s.uvTiling.y;
s.uvTiling.y = -s.uvTiling.y;
}
Commit();
}
private void ResetSurface()
{
m_Renderer.settings.surface = new ShaderBakeSurfaceSettings();
Commit();
SetStatus("面片参数已归位");
}
private void PickSceneMesh()
{
string note;
Mesh mesh = ShaderBakeModelSource.PickFromSelection(out note);
if (mesh == null)
{
SetStatus(note);
return;
}
m_Renderer.settings.surface.sourceMesh = mesh;
m_Renderer.settings.surface.kind = ShaderBakeSurfaceKind.Mesh;
m_Renderer.settings.surface.meshSubMesh = 0;
Commit();
SetStatus(note);
}
private void ImportModel()
{
string note;
Mesh mesh = ShaderBakeModelSource.ImportFromFile(out note);
if (mesh == null)
{
SetStatus(note);
return;
}
m_Renderer.settings.surface.sourceMesh = mesh;
m_Renderer.settings.surface.kind = ShaderBakeSurfaceKind.Mesh;
m_Renderer.settings.surface.meshSubMesh = 0;
Commit();
SetStatus(note);
}
// ── 相机 ────────────────────────────────────────────────
private void BindCamera()
{
BindBool("cam-ortho", () => m_Renderer.settings.camera.orthographic, v => m_Renderer.settings.camera.orthographic = v);
BindFloat("cam-ortho-size", () => m_Renderer.settings.camera.orthographicSize, v => m_Renderer.settings.camera.orthographicSize = v);
BindFloat("cam-fov", () => m_Renderer.settings.camera.fieldOfView, v => m_Renderer.settings.camera.fieldOfView = v);
BindFloat("cam-near", () => m_Renderer.settings.camera.nearClipPlane, v => m_Renderer.settings.camera.nearClipPlane = v);
BindFloat("cam-far", () => m_Renderer.settings.camera.farClipPlane, v => m_Renderer.settings.camera.farClipPlane = v);
BindFloat("cam-pos-x", () => m_Renderer.settings.camera.position.x, v => SetCamPos(v, m_Renderer.settings.camera.position.y, m_Renderer.settings.camera.position.z));
BindFloat("cam-pos-y", () => m_Renderer.settings.camera.position.y, v => SetCamPos(m_Renderer.settings.camera.position.x, v, m_Renderer.settings.camera.position.z));
BindFloat("cam-pos-z", () => m_Renderer.settings.camera.position.z, v => SetCamPos(m_Renderer.settings.camera.position.x, m_Renderer.settings.camera.position.y, v));
BindFloat("cam-rot-x", () => m_Renderer.settings.camera.eulerAngles.x, v => SetCamRot(v, m_Renderer.settings.camera.eulerAngles.y, m_Renderer.settings.camera.eulerAngles.z));
BindFloat("cam-rot-y", () => m_Renderer.settings.camera.eulerAngles.y, v => SetCamRot(m_Renderer.settings.camera.eulerAngles.x, v, m_Renderer.settings.camera.eulerAngles.z));
BindFloat("cam-rot-z", () => m_Renderer.settings.camera.eulerAngles.z, v => SetCamRot(m_Renderer.settings.camera.eulerAngles.x, m_Renderer.settings.camera.eulerAngles.y, v));
Click("cam-fit", FitCamera);
}
private void SetCamPos(float x, float y, float z) { m_Renderer.settings.camera.position = new Vector3(x, y, z); }
private void SetCamRot(float x, float y, float z) { m_Renderer.settings.camera.eulerAngles = new Vector3(x, y, z); }
private void FitCamera()
{
m_Renderer.FitCameraToGeometry();
Commit();
SetStatus("相机已框住面片");
}
// ── 右侧细节栏宽度 ──────────────────────────────────────
private void BindDetailSplit()
{
if (m_DetailSplit == null || m_DetailPane == null)
return;
float dragStartX = 0f, startWidth = 0f;
bool dragging = false;
m_DetailSplit.RegisterCallback<PointerDownEvent>(evt =>
{
dragging = true;
dragStartX = evt.position.x;
startWidth = m_DetailPane.resolvedStyle.width;
m_DetailSplit.CapturePointer(evt.pointerId);
evt.StopPropagation();
});
m_DetailSplit.RegisterCallback<PointerMoveEvent>(evt =>
{
if (!dragging)
return;
m_DetailPane.style.width = Mathf.Clamp(startWidth - (evt.position.x - dragStartX), 240f, 720f);
});
m_DetailSplit.RegisterCallback<PointerUpEvent>(evt =>
{
dragging = false;
m_DetailSplit.ReleasePointer(evt.pointerId);
SavePrefs();
});
}
// ── 通用绑定 ────────────────────────────────────────────
private void BindFloat(string name, Func<float> get, Action<float> set)
{
FloatField field = rootVisualElement.Q<FloatField>(name);
if (field == null)
{
Debug.LogError("[ShaderBake] UXML 里缺控件 " + name);
return;
}
// 延迟提交:一边打字一边回写会把光标和"0."这类中间输入搅乱,等回车/失焦再收
field.isDelayed = true;
m_Syncers.Add(() => field.SetValueWithoutNotify(get()));
field.RegisterValueChangedCallback(evt =>
{
set(evt.newValue);
Commit();
});
}
private void BindInt(string name, Func<int> get, Action<int> set)
{
IntegerField field = rootVisualElement.Q<IntegerField>(name);
if (field == null)
{
Debug.LogError("[ShaderBake] UXML 里缺控件 " + name);
return;
}
field.isDelayed = true;
m_Syncers.Add(() => field.SetValueWithoutNotify(get()));
field.RegisterValueChangedCallback(evt =>
{
set(evt.newValue);
Commit();
});
}
private void BindBool(string name, Func<bool> get, Action<bool> set)
{
Toggle field = rootVisualElement.Q<Toggle>(name);
if (field == null)
{
Debug.LogError("[ShaderBake] UXML 里缺控件 " + name);
return;
}
m_Syncers.Add(() => field.SetValueWithoutNotify(get()));
field.RegisterValueChangedCallback(evt =>
{
set(evt.newValue);
Commit();
});
}
private void BindColor(string name, Func<Color> get, Action<Color> set)
{
ColorField field = rootVisualElement.Q<ColorField>(name);
if (field == null)
{
Debug.LogError("[ShaderBake] UXML 里缺控件 " + name);
return;
}
m_Syncers.Add(() => field.SetValueWithoutNotify(get()));
field.RegisterValueChangedCallback(evt =>
{
set(evt.newValue);
Commit();
});
}
/// <summary>
/// 一次参数提交的固定顺序:收拢数值 → 整体回写界面 → 请求重画。
/// 顺序反了就会出现"界面显示 8192、实际渲 4096"这种对不上账的情况。
/// </summary>
private void Commit()
{
m_Renderer.settings.ClampAll();
m_Renderer.InvalidateGeometry();
SyncUiFromSettings();
RequestRender();
}
private void SyncUiFromSettings()
{
foreach (Action sync in m_Syncers)
sync();
}
private void ResetSettings()
{
m_Renderer.settings = ShaderBakeSettings.CreateDefault();
Commit();
if (m_Preview != null)
m_Preview.FitToView();
SetStatus("参数已重置");
}
// ── 渲染 ────────────────────────────────────────────────
private void RequestRender()
{
if (m_AutoRefreshToggle != null && !m_AutoRefreshToggle.value)
{
SetStatus("参数已改,按「重新渲染」出图");
return;
}
if (m_RenderPending)
return;
m_RenderPending = true;
// 一帧里可能连着收到好几个控件的提交(拖滑块尤其明显),全部并进同一次渲染
EditorApplication.delayCall += RenderDelayed;
}
private void RenderDelayed()
{
if (this == null || !m_RenderPending)
return;
DoRender();
}
private void DoRender()
{
m_RenderPending = false;
if (m_Renderer == null || m_Preview == null)
return;
double start = EditorApplication.timeSinceStartup;
RenderTexture rt = m_Renderer.Render();
m_LastRenderMs = (EditorApplication.timeSinceStartup - start) * 1000.0;
if (rt == null)
{
m_Preview.Clear();
SetStatus(string.IsNullOrEmpty(m_Renderer.lastError) ? "渲染失败" : m_Renderer.lastError);
UpdateSizeReadout();
return;
}
m_Preview.SetResult(rt, m_Renderer.settings.output.size);
UpdateSizeReadout();
if (string.IsNullOrEmpty(m_StatusMessage.text) || m_StatusMessage.text.StartsWith("导出"))
SetStatus("已渲染");
SavePrefs();
}
private void UpdateSizeReadout()
{
if (m_StatusSize != null)
m_StatusSize.text = m_Renderer.settings.output.width + "×" + m_Renderer.settings.output.height;
if (m_StatusTime != null)
m_StatusTime.text = m_LastRenderMs < 0.0 ? "-" : m_LastRenderMs.ToString("0.0") + " ms";
UpdateMeshReadout();
}
private void UpdateMeshReadout()
{
// 顶点数只在状态栏出现:它决定细分够不够用,但不值得占一行界面
Mesh mesh = m_Renderer != null ? m_Renderer.geometry : null;
if (mesh == null || m_StatusMessage == null)
return;
if (m_StatusMessage.text.StartsWith("导出") || m_StatusMessage.text.StartsWith("参数已改"))
return;
m_StatusMessage.text = "已渲染 · " + mesh.vertexCount + " 顶点";
}
private void SetStatus(string message)
{
if (m_StatusMessage != null)
m_StatusMessage.text = message;
}
// ── 存取界面状态 ────────────────────────────────────────
private void RestorePrefs()
{
m_Renderer.settings = ShaderBakeSettings.FromJson(EditorPrefs.GetString(kPrefSettings, string.Empty));
if (m_AutoRefreshToggle != null)
m_AutoRefreshToggle.SetValueWithoutNotify(EditorPrefs.GetBool(kPrefAutoRefresh, true));
if (m_CheckerToggle != null)
{
bool checker = EditorPrefs.GetBool(kPrefChecker, true);
m_CheckerToggle.SetValueWithoutNotify(checker);
if (m_Preview != null) m_Preview.SetCheckerVisible(checker);
}
if (m_DetailPane != null)
m_DetailPane.style.width = EditorPrefs.GetFloat(kPrefDetailWidth, kDefaultDetailWidth);
string assetPath = EditorPrefs.GetString(kPrefSource, string.Empty);
if (!string.IsNullOrEmpty(assetPath))
{
UnityEngine.Object asset = AssetDatabase.LoadAssetAtPath<UnityEngine.Object>(assetPath);
if (asset is Shader shader)
{
if (m_ShaderField != null) m_ShaderField.SetValueWithoutNotify(shader);
m_Source.Assign(shader);
}
else if (asset is Material material)
{
if (m_MaterialField != null) m_MaterialField.SetValueWithoutNotify(material);
m_Source.Assign(material);
}
}
}
private void SavePrefs()
{
if (m_Renderer == null)
return;
EditorPrefs.SetString(kPrefSettings, m_Renderer.settings.ToJson());
if (m_AutoRefreshToggle != null)
EditorPrefs.SetBool(kPrefAutoRefresh, m_AutoRefreshToggle.value);
if (m_CheckerToggle != null)
EditorPrefs.SetBool(kPrefChecker, m_CheckerToggle.value);
if (m_DetailPane != null && m_DetailPane.resolvedStyle.width > 1f)
EditorPrefs.SetFloat(kPrefDetailWidth, m_DetailPane.resolvedStyle.width);
EditorPrefs.SetString(kPrefSource, SourceAssetPath() ?? string.Empty);
}
private string SourceAssetPath()
{
if (m_Source == null)
return null;
UnityEngine.Object asset = (UnityEngine.Object)m_Source.sourceShader ?? m_Source.sourceMaterial;
return asset != null ? AssetDatabase.GetAssetPath(asset) : null;
}
/// <summary> 没填来源时,把当前选中的 Shader / Material 接下来当来源 </summary>
private void AdoptSelectionIfEmpty()
{
if (m_Renderer != null && m_Renderer.material != null)
return;
UnityEngine.Object active = Selection.activeObject;
if (active is Shader shader)
{
if (m_ShaderField != null) m_ShaderField.SetValueWithoutNotify(shader);
AssignSource(shader, null, false);
}
else if (active is Material material)
{
if (m_MaterialField != null) m_MaterialField.SetValueWithoutNotify(material);
AssignSource(null, material, false);
}
}
// ── 资源加载 ────────────────────────────────────────────
/// <summary>
/// 按 Packages 路径取,取不到再按名字搜。
/// 这个包既能以 Packages/ 引用进来,也可能被拷进 Assets 里调试,写死一条路径会在后者上直接白屏。
/// </summary>
private static T LoadAsset<T>(string path, string assetName) where T : UnityEngine.Object
{
T asset = AssetDatabase.LoadAssetAtPath<T>(path);
if (asset != null)
return asset;
string[] guids = AssetDatabase.FindAssets(assetName);
foreach (string guid in guids)
{
string candidate = AssetDatabase.GUIDToAssetPath(guid);
if (!Path.GetFileNameWithoutExtension(candidate).Equals(assetName, StringComparison.Ordinal))
continue;
asset = AssetDatabase.LoadAssetAtPath<T>(candidate);
if (asset != null)
return asset;
}
return null;
}
}
}
@@ -0,0 +1,29 @@
<ui:UXML xmlns:ui="UnityEngine.UIElements" xmlns:x="UnityEditor.UIElements">
<!--
材质属性表的一行模板:结构写在这里,控件种类摊开成兄弟节点,
BakeShaderPropertyTable.cs 负责"留哪一个、其余收起来"。
行里的 name 会在多行之间重复,所以取控件一律在克隆出来的行内查(row.Q),不查全局。
样式跟着窗口根上的 BakeShaderWindow.uss 走,这里不重复挂样式表。
-->
<ui:VisualElement name="prop-row" class="prop-row">
<ui:Label name="prop-label" class="prop-label" text="属性" />
<ui:VisualElement name="prop-field" class="prop-field">
<ui:FloatField name="prop-float" class="prop-inline" />
<ui:IntegerField name="prop-int" class="prop-inline" />
<ui:Toggle name="prop-toggle" class="prop-inline" />
<ui:DropdownField name="prop-enum" class="prop-inline" />
<x:ColorField name="prop-color" class="prop-inline" />
<x:ObjectField name="prop-texture" class="prop-inline" />
<ui:VisualElement name="prop-range" class="prop-range">
<ui:Slider name="prop-slider" class="prop-slider" />
<ui:FloatField name="prop-range-value" class="prop-range-value" />
</ui:VisualElement>
<ui:VisualElement name="prop-vector" class="prop-vector">
<ui:FloatField name="prop-vec-x" label="X" class="prop-vec-part" />
<ui:FloatField name="prop-vec-y" label="Y" class="prop-vec-part" />
<ui:FloatField name="prop-vec-z" label="Z" class="prop-vec-part" />
<ui:FloatField name="prop-vec-w" label="W" class="prop-vec-part" />
</ui:VisualElement>
</ui:VisualElement>
</ui:VisualElement>
</ui:UXML>
+271
View File
@@ -0,0 +1,271 @@
/* ============================================================
Bake Shader As Image 窗口样式。
结构见 BakeShaderWindow.uxml,这里只放尺寸与配色;
工具栏一族(Toolbar*)自带引擎配色与高度,不要再给它设背景。
============================================================ */
.bake-root {
flex-direction: column;
flex-grow: 1;
background-color: rgb(38, 38, 38);
}
/* ── 顶部 / 底部工具栏 ── */
.main-toolbar,
.status-bar {
flex-shrink: 0;
}
.toolbar-gap {
flex-grow: 1;
}
.tool-narrow {
min-width: 26px;
width: 26px;
}
.toolbar-emphasize {
-unity-text-align: middle-center;
font-size: 12px;
}
.status-message {
font-size: 12px;
-unity-text-align: middle-left;
color: rgb(210, 210, 210);
}
.status-readout {
font-size: 11px;
-unity-text-align: middle-right;
color: rgb(160, 160, 160);
margin-left: 6px;
margin-right: 6px;
}
/* ── 中部:左浏览图 + 右细节 ── */
.main-row {
flex-direction: row;
flex-grow: 1;
min-height: 120px;
}
.preview-pane {
flex-direction: column;
flex-grow: 1;
min-width: 200px;
}
.preview-viewport {
flex-grow: 1;
background-color: rgb(48, 48, 48);
/* 浏览区是一块画布,不该有内边距把图挤到角上 */
padding: 0;
}
.preview-viewport > .unity-scroll-view__content-container {
flex-grow: 1;
}
.preview-stage {
flex-grow: 1;
align-items: center;
justify-content: center;
min-width: 100%;
}
.preview-frame {
position: relative;
margin: 12px;
border-width: 1px;
border-color: rgb(90, 90, 90);
}
.preview-checker,
.preview-image {
position: absolute;
left: 0;
top: 0;
/* 两张都按画面尺寸摆放,谁大谁小由代码算,样式不掺和 */
width: 100%;
height: 100%;
}
.preview-checker {
opacity: 0.9;
}
.preview-readout {
position: absolute;
left: 8px;
bottom: 8px;
font-size: 11px;
color: rgb(220, 220, 220);
background-color: rgba(0, 0, 0, 0.45);
padding: 1px 6px;
border-radius: 3px;
}
.detail-split {
width: 3px;
flex-shrink: 0;
background-color: rgb(60, 60, 60);
}
.detail-split:hover {
background-color: rgb(94, 142, 206);
}
.detail-pane {
width: 340px;
min-width: 240px;
flex-shrink: 0;
background-color: rgb(42, 42, 42);
border-left-width: 1px;
border-left-color: rgb(60, 60, 60);
}
.detail-pane > .unity-scroll-view__content-container {
flex-shrink: 0;
}
.detail-content {
flex-shrink: 0;
padding-bottom: 8px;
}
/* ── 分组 ── */
.section {
border-bottom-width: 1px;
border-bottom-color: rgb(52, 52, 52);
padding-top: 4px;
padding-bottom: 6px;
}
.section-head {
font-size: 12px;
margin-left: 6px;
margin-bottom: 2px;
color: rgb(225, 225, 225);
}
.section-body {
padding-left: 8px;
padding-right: 8px;
}
/* ── 控件排布 ── */
.field-row {
flex-direction: row;
align-items: center;
}
.field-full {
flex-grow: 1;
flex-shrink: 1;
min-width: 0;
}
.field-half {
flex-grow: 1;
flex-shrink: 1;
min-width: 0;
margin-right: 4px;
}
.field-third {
flex-grow: 1;
flex-shrink: 1;
min-width: 0;
margin-right: 4px;
}
.field-toggle {
font-size: 11px;
margin-top: 2px;
margin-bottom: 2px;
}
.field-note {
font-size: 10px;
color: rgb(150, 150, 150);
margin-top: 6px;
margin-bottom: 2px;
}
/* ── 材质属性行 ── */
.props-rows {
flex-shrink: 0;
}
.prop-row {
flex-direction: row;
align-items: center;
min-height: 18px;
}
.prop-label {
width: 108px;
flex-shrink: 0;
font-size: 11px;
color: rgb(200, 200, 200);
overflow: hidden;
white-space: nowrap;
}
.prop-field {
flex-grow: 1;
flex-shrink: 1;
min-width: 0;
flex-direction: row;
align-items: center;
}
.prop-inline {
flex-grow: 1;
flex-shrink: 1;
min-width: 0;
}
.prop-range {
flex-grow: 1;
flex-direction: row;
align-items: center;
min-width: 0;
}
.prop-slider {
flex-grow: 1;
min-width: 0;
}
.prop-range-value {
width: 58px;
flex-shrink: 0;
}
.prop-vector {
flex-grow: 1;
flex-direction: row;
align-items: center;
min-width: 0;
}
.prop-vec-part {
flex-grow: 1;
flex-shrink: 1;
min-width: 0;
margin-right: 2px;
}
.prop-vec-part > .unity-label {
min-width: 12px;
font-size: 10px;
}
/* 属性行里的数字框不要各自那套标题——标签已经在行首了 */
.prop-inline > .unity-label,
.prop-range-value > .unity-label {
display: none;
}
+192
View File
@@ -0,0 +1,192 @@
<ui:UXML xmlns:ui="UnityEngine.UIElements" xmlns:x="UnityEditor.UIElements">
<!--
Xeric UI Action Vessel — Bake Shader As Image 面板结构。
这一份只管"有哪些块、块里有哪些控件、叫什么名字",
数值绑定与刷新逻辑全在 BakeShaderAsImageWindow.cs;样式见 BakeShaderWindow.uss。
命名约定:
sec-* 可折叠分组(head 是那个勾,body 是内容容器)
src-/out-/surf-/cam- 分组内控件,前缀即所属分组
props-rows 材质属性表的容器(行由 BakeShaderPropertyRow.uxml 模板克隆)
-->
<!-- 样式表由窗口代码加载(包在 Packages/ 还是 Assets/ 两条路径都要兼容),这里不重复引用 -->
<ui:VisualElement name="bake-root" class="bake-root">
<!-- ── 顶部工具栏:导出 / 渲染 / 预览缩放 / 重置 ── -->
<x:Toolbar name="main-toolbar" class="main-toolbar">
<x:ToolbarButton name="export-menu" text="导出 ▾" class="toolbar-emphasize" />
<x:ToolbarButton name="render-now" text="重新渲染" />
<x:ToolbarToggle name="auto-refresh" text="实时预览" />
<x:ToolbarSpacer class="toolbar-gap" />
<x:ToolbarButton name="zoom-out" text="-" class="tool-narrow" />
<x:ToolbarButton name="zoom-fit" text="适应" />
<x:ToolbarButton name="zoom-actual" text="1:1" />
<x:ToolbarButton name="zoom-in" text="+" class="tool-narrow" />
<x:ToolbarToggle name="show-checker" text="透明底" />
<x:ToolbarSpacer class="toolbar-gap" />
<x:ToolbarButton name="reset-settings" text="重置参数" />
</x:Toolbar>
<!-- ── 中部:左边浏览图,右边细节列表 ── -->
<ui:VisualElement name="main-row" class="main-row">
<ui:VisualElement name="preview-pane" class="preview-pane">
<ui:ScrollView name="preview-viewport" class="preview-viewport" mode="Both">
<ui:VisualElement name="preview-stage" class="preview-stage">
<ui:VisualElement name="preview-frame" class="preview-frame">
<ui:Image name="preview-checker" class="preview-checker" />
<ui:Image name="preview-image" class="preview-image" />
</ui:VisualElement>
</ui:VisualElement>
</ui:ScrollView>
<!-- 读数浮在预览区左下角:缩放比与像素尺寸是看图时才关心的东西,不该占一行 -->
<ui:Label name="preview-readout" class="preview-readout" text="-" />
</ui:VisualElement>
<ui:VisualElement name="detail-split" class="detail-split" />
<ui:ScrollView name="detail-pane" class="detail-pane" mode="Vertical">
<ui:VisualElement name="detail-content" class="detail-content">
<!-- 输入源 -->
<ui:VisualElement name="sec-source" class="section">
<ui:Toggle name="sec-source-head" label="输入源" value="true" class="section-head" />
<ui:VisualElement name="sec-source-body" class="section-body">
<x:ObjectField name="src-shader" label="Shader" class="field-full" />
<x:ObjectField name="src-material" label="Material" class="field-full" />
<ui:Label name="src-note" class="field-note" text="未指定" />
<ui:VisualElement class="field-row">
<ui:Button name="src-apply" text="写回原材质" class="field-half" />
<ui:Button name="src-revert" text="丢弃改动" class="field-half" />
</ui:VisualElement>
</ui:VisualElement>
</ui:VisualElement>
<!-- 输出目标 -->
<ui:VisualElement name="sec-output" class="section">
<ui:Toggle name="sec-output-head" label="输出" value="true" class="section-head" />
<ui:VisualElement name="sec-output-body" class="section-body">
<ui:VisualElement class="field-row">
<ui:IntegerField name="out-width" label="宽" class="field-half" />
<ui:IntegerField name="out-height" label="高" class="field-half" />
</ui:VisualElement>
<ui:VisualElement class="field-row">
<ui:IntegerField name="out-depth" label="深度" class="field-half" />
<ui:DropdownField name="out-msaa" label="采样" class="field-half" />
</ui:VisualElement>
<ui:IntegerField name="out-pass" label="Pass 下标" class="field-full" />
<x:ColorField name="out-clear" label="背景色" class="field-full" />
<ui:Toggle name="out-hdr" label="HDR(浮点目标)" class="field-toggle" />
<ui:Toggle name="out-srgb" label="sRGB 存储" class="field-toggle" />
<ui:Toggle name="out-flip" label="上下翻转(读回方向不对时开)" class="field-toggle" />
</ui:VisualElement>
</ui:VisualElement>
<!-- 面片 -->
<ui:VisualElement name="sec-surface" class="section">
<ui:Toggle name="sec-surface-head" label="面片" value="true" class="section-head" />
<ui:VisualElement name="sec-surface-body" class="section-body">
<ui:EnumField name="surf-kind" label="种类" class="field-full" />
<ui:VisualElement class="field-row">
<ui:FloatField name="surf-size-x" label="宽" class="field-half" />
<ui:FloatField name="surf-size-y" label="高" class="field-half" />
</ui:VisualElement>
<ui:VisualElement class="field-row">
<ui:IntegerField name="surf-seg-x" label="列" class="field-half" />
<ui:IntegerField name="surf-seg-y" label="行" class="field-half" />
</ui:VisualElement>
<ui:Label class="field-note" text="UV" />
<ui:VisualElement class="field-row">
<ui:FloatField name="surf-uv-off-x" label="偏移X" class="field-half" />
<ui:FloatField name="surf-uv-off-y" label="偏移Y" class="field-half" />
</ui:VisualElement>
<ui:VisualElement class="field-row">
<ui:FloatField name="surf-uv-tile-x" label="重复X" class="field-half" />
<ui:FloatField name="surf-uv-tile-y" label="重复Y" class="field-half" />
</ui:VisualElement>
<ui:Label class="field-note" text="面片变换" />
<ui:VisualElement class="field-row">
<ui:FloatField name="surf-pos-x" label="X" class="field-third" />
<ui:FloatField name="surf-pos-y" label="Y" class="field-third" />
<ui:FloatField name="surf-pos-z" label="Z" class="field-third" />
</ui:VisualElement>
<ui:VisualElement class="field-row">
<ui:FloatField name="surf-rot-x" label="X" class="field-third" />
<ui:FloatField name="surf-rot-y" label="Y" class="field-third" />
<ui:FloatField name="surf-rot-z" label="Z" class="field-third" />
</ui:VisualElement>
<ui:VisualElement class="field-row">
<ui:FloatField name="surf-scale-x" label="X" class="field-third" />
<ui:FloatField name="surf-scale-y" label="Y" class="field-third" />
<ui:FloatField name="surf-scale-z" label="Z" class="field-third" />
</ui:VisualElement>
<ui:Label class="field-note" text="外部网格" />
<x:ObjectField name="surf-mesh" label="网格" class="field-full" />
<ui:IntegerField name="surf-submesh" label="SubMesh" class="field-full" />
<ui:Toggle name="surf-normalize" label="缩放到面片尺寸" class="field-toggle" />
<ui:Toggle name="surf-uv-st" label="UV 再写进 _MainTex_ST" class="field-toggle" />
<ui:VisualElement class="field-row">
<ui:Button name="surf-reset" text="面片归位" class="field-half" />
<ui:Button name="surf-pick-scene" text="取选中物体" class="field-half" />
</ui:VisualElement>
<ui:Button name="surf-import-model" text="导入模型文件…" class="field-full" />
<ui:VisualElement class="field-row">
<ui:Button name="surf-rot-90" text="绕Z转90" class="field-third" />
<ui:Button name="surf-flip-u" text="U镜像" class="field-third" />
<ui:Button name="surf-flip-v" text="V镜像" class="field-third" />
</ui:VisualElement>
</ui:VisualElement>
</ui:VisualElement>
<!-- 离屏相机 -->
<ui:VisualElement name="sec-camera" class="section">
<ui:Toggle name="sec-camera-head" label="相机" value="true" class="section-head" />
<ui:VisualElement name="sec-camera-body" class="section-body">
<ui:Toggle name="cam-ortho" label="正交" class="field-toggle" />
<ui:FloatField name="cam-ortho-size" label="正交半高" class="field-full" />
<ui:FloatField name="cam-fov" label="视野角" class="field-full" />
<ui:VisualElement class="field-row">
<ui:FloatField name="cam-near" label="近" class="field-half" />
<ui:FloatField name="cam-far" label="远" class="field-half" />
</ui:VisualElement>
<ui:Label class="field-note" text="位置" />
<ui:VisualElement class="field-row">
<ui:FloatField name="cam-pos-x" label="X" class="field-third" />
<ui:FloatField name="cam-pos-y" label="Y" class="field-third" />
<ui:FloatField name="cam-pos-z" label="Z" class="field-third" />
</ui:VisualElement>
<ui:Label class="field-note" text="旋转(欧拉角)" />
<ui:VisualElement class="field-row">
<ui:FloatField name="cam-rot-x" label="X" class="field-third" />
<ui:FloatField name="cam-rot-y" label="Y" class="field-third" />
<ui:FloatField name="cam-rot-z" label="Z" class="field-third" />
</ui:VisualElement>
<ui:Button name="cam-fit" text="框住面片" class="field-full" />
</ui:VisualElement>
</ui:VisualElement>
<!-- 材质属性表:行来自 BakeShaderPropertyRow.uxml -->
<ui:VisualElement name="sec-props" class="section">
<ui:Toggle name="sec-props-head" label="材质属性" value="true" class="section-head" />
<ui:VisualElement name="sec-props-body" class="section-body">
<ui:VisualElement name="props-rows" class="props-rows" />
<ui:Label name="props-note" class="field-note" text="未指定 shader" />
</ui:VisualElement>
</ui:VisualElement>
</ui:VisualElement>
</ui:ScrollView>
</ui:VisualElement>
<!-- ── 底部状态栏 ── -->
<x:Toolbar name="status-bar" class="status-bar">
<ui:Label name="status-message" class="status-message" text="未渲染" />
<x:ToolbarSpacer class="toolbar-gap" />
<ui:Label name="status-source" class="status-readout" text="-" />
<ui:Label name="status-size" class="status-readout" text="-" />
<ui:Label name="status-time" class="status-readout" text="-" />
</x:Toolbar>
</ui:VisualElement>
</ui:UXML>
+296
View File
@@ -0,0 +1,296 @@
using System;
using System.IO;
using UnityEditor;
using UnityEngine;
namespace XericUI.ShaderBake.Editor
{
/// <summary>
/// 导出:Unity 的图像类型(Texture2D / Sprite / RenderTexture)落成资产,
/// 或按 Texture2D 自带的编码方法写成 PNG / JPG / TGA / EXR 文件。
///
/// <para><b>文件落在工程内和工程外走两条路</b>:落在 Assets 下面时必须触发导入并写导入设置
/// (sRGB 与是否 Sprite),否则 Unity 会按默认值重新解释这张图——烘的时候是 sRGB、
/// 进引擎变成线性,是最难查的那种"颜色不对"。</para>
/// </summary>
internal sealed class ShaderBakeExporter
{
private const string kPrefLastDir = "XericUI.ShaderBake.LastDir";
private readonly ShaderBakeRenderer m_Renderer;
private readonly Action<string> m_Report;
public ShaderBakeExporter(ShaderBakeRenderer renderer, Action<string> report)
{
m_Renderer = renderer;
m_Report = report;
}
/// <summary> 把导出项灌进一个 GenericMenu(工具栏那颗按钮点开来的是它) </summary>
public void BuildMenu(GenericMenu menu, string suggestedName)
{
string name = SanitizeName(suggestedName);
menu.AddItem(new GUIContent("PNG 文件…"), false, () => SaveFile(ShaderBakeImageFormat.Png, name));
menu.AddItem(new GUIContent("JPG 文件…"), false, () => SaveFile(ShaderBakeImageFormat.Jpg, name));
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("Texture2D 资产(.asset)…"), false, () => SaveTextureAsset(name));
menu.AddItem(new GUIContent("Sprite 资产(png + 导入设置)…"), false, () => SaveSpriteAsset(name));
menu.AddItem(new GUIContent("RenderTexture 资产(.asset)…"), false, () => SaveRenderTextureAsset(name));
menu.AddSeparator(string.Empty);
menu.AddItem(new GUIContent("复制烘焙参数(JSON)"), false, CopySettingsJson);
menu.AddItem(new GUIContent("用参数 JSON 替换…"), false, PasteSettingsJson);
}
// ── 文件 ────────────────────────────────────────────────
public void SaveFile(ShaderBakeImageFormat format, string suggestedName)
{
Texture2D texture = m_Renderer.RenderToTexture2D(false);
if (texture == null)
{
Fail(m_Renderer.lastError);
return;
}
byte[] bytes;
try
{
bytes = format.Encode(texture, m_Renderer.settings.output.clearColor);
}
finally
{
ShaderBakeRenderer.ReleaseTempObject(texture, true);
}
if (bytes == null || bytes.Length == 0)
{
Fail(format + " 编码失败(这个纹理格式 Unity 的编码器不吃)");
return;
}
string path = EditorUtility.SaveFilePanel(
"导出 " + format.GetExtension().ToUpperInvariant(), LastDir(), suggestedName, format.GetExtension());
if (string.IsNullOrEmpty(path))
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);
}
}
// ── 资产 ────────────────────────────────────────────────
public void SaveTextureAsset(string suggestedName)
{
Texture2D texture = m_Renderer.RenderToTexture2D(false);
if (texture == null)
{
Fail(m_Renderer.lastError);
return;
}
string path = EditorUtility.SaveFilePanelInProject("保存 Texture2D 资产", suggestedName, "asset",
"这张图会作为可读的 Texture2D 存成 .asset(不走向器,随时可读回像素)");
if (string.IsNullOrEmpty(path))
{
ShaderBakeRenderer.ReleaseTempObject(texture, true);
return;
}
texture.name = Path.GetFileNameWithoutExtension(path);
// CreateAsset 不吃 DontSave / hideFlags 非空的对象,落盘前必须摘掉
texture.hideFlags = HideFlags.None;
AssetDatabase.CreateAsset(texture, path);
AssetDatabase.SaveAssets();
RememberDir(path);
Report("已保存 " + path);
}
/// <summary>
/// Sprite 走"写 png + 设导入器"这条路,而不是把 Sprite 对象本身存成资产:
/// Sprite.Create 出来的是一张纹理上的临时对象,直接 CreateAsset 会被当成非法资产。
/// 让 Unity 自己按 Sprite 类型导入,拿到的 Sprite 才是别处也能用的正常资产。
/// </summary>
public void SaveSpriteAsset(string suggestedName)
{
string path = EditorUtility.SaveFilePanelInProject("保存 Sprite 资产", suggestedName, "png",
"先写成 png,再把导入类型设为 Sprite(Single)");
if (string.IsNullOrEmpty(path))
return;
Texture2D texture = m_Renderer.RenderToTexture2D(false);
if (texture == null)
{
Fail(m_Renderer.lastError);
return;
}
byte[] bytes;
try
{
bytes = ShaderBakeImageFormat.Png.Encode(texture, m_Renderer.settings.output.clearColor);
}
finally
{
ShaderBakeRenderer.ReleaseTempObject(texture, true);
}
if (bytes == null)
{
Fail("PNG 编码失败");
return;
}
File.WriteAllBytes(path, bytes);
ImportAndConfigure(path, true);
RememberDir(path);
Sprite sprite = AssetDatabase.LoadAssetAtPath<Sprite>(path);
Report(sprite != null ? "已保存 Sprite " + path : "已写入 " + path + "(没拿到 Sprite,检查导入设置)");
}
public void SaveRenderTextureAsset(string suggestedName)
{
string path = EditorUtility.SaveFilePanelInProject("保存 RenderTexture 资产", suggestedName, "asset",
"RT 资产可以反复往里渲,也能被材质直接引用");
if (string.IsNullOrEmpty(path))
return;
// 存成资产要能被别处直接采样/读回,单采样即可;采样样式由烘焙设置里的 MSAA 只在预览时体现
var rt = m_Renderer.settings.output.CreateRenderTexture(Path.GetFileNameWithoutExtension(path), 1);
if (m_Renderer.Render(rt) == null)
{
Fail(m_Renderer.lastError);
ShaderBakeRenderer.ReleaseTempObject(rt, true);
return;
}
rt.hideFlags = HideFlags.None;
AssetDatabase.CreateAsset(rt, path);
AssetDatabase.SaveAssets();
RememberDir(path);
Report("已保存 " + path);
}
// ── 参数搬运 ────────────────────────────────────────────
private void CopySettingsJson()
{
EditorGUIUtility.systemCopyBuffer = m_Renderer.settings.ToJson();
Report("烘焙参数已复制到剪贴板");
}
private void PasteSettingsJson()
{
string json = EditorGUIUtility.systemCopyBuffer;
if (string.IsNullOrEmpty(json) || json.IndexOf("output", StringComparison.Ordinal) < 0)
{
Fail("剪贴板里不像是烘焙参数 JSON");
return;
}
ShaderBakeSettings parsed = ShaderBakeSettings.FromJson(json);
m_Renderer.settings.output = parsed.output;
m_Renderer.settings.surface = parsed.surface;
m_Renderer.settings.camera = parsed.camera;
Report("烘焙参数已从剪贴板替换");
Action apply = settingsReplaced;
if (apply != null)
apply.Invoke();
}
/// <summary> 参数被外部整体换掉之后,窗口要把界面数值同步回来 </summary>
public event Action settingsReplaced;
// ── 杂项 ────────────────────────────────────────────────
/// <summary>
/// 落在 Assets 下面时触发导入并设好类型。<paramref name="asSprite"/> 为真时按 Sprite 导入;
/// 否则按普通贴图,并把 sRGB 跟烘焙设置对齐。
/// </summary>
private void ImportAndConfigure(string assetPath, bool asSprite)
{
AssetDatabase.ImportAsset(assetPath, ImportAssetOptions.ForceUpdate);
var importer = AssetImporter.GetAtPath(assetPath) as TextureImporter;
if (importer == null)
return;
importer.textureType = asSprite ? TextureImporterType.Sprite : TextureImporterType.Default;
if (asSprite)
importer.spriteImportMode = SpriteImportMode.Single;
importer.sRGBTexture = m_Renderer.settings.output.sRGB && !m_Renderer.settings.output.hdr;
importer.mipmapEnabled = false;
// 浮点位深交给导入器按源文件判断(EXR 源自己带格式),这里不去设 per-platform 压缩格式
importer.SaveAndReimport();
}
/// <summary> 工程内的绝对路径换成 Assets/... 相对路径;不在工程内返回 null </summary>
private static string ToAssetPath(string absolutePath)
{
string normalized = absolutePath.Replace('\\', '/');
string dataPath = Application.dataPath.Replace('\\', '/');
if (!normalized.StartsWith(dataPath + "/", StringComparison.OrdinalIgnoreCase))
return null;
return "Assets" + normalized.Substring(dataPath.Length);
}
/// <summary> 文件名直接拿去当路径用,分隔符和非法字符要先剔掉 </summary>
private static string SanitizeName(string suggestedName)
{
if (string.IsNullOrEmpty(suggestedName))
return "BakedImage";
foreach (char invalid in Path.GetInvalidFileNameChars())
suggestedName = suggestedName.Replace(invalid, '_');
return suggestedName.Replace('/', '_').Replace('\\', '_');
}
private static string LastDir()
{
string dir = EditorPrefs.GetString(kPrefLastDir, string.Empty);
return string.IsNullOrEmpty(dir) || !Directory.Exists(dir) ? Application.dataPath : dir;
}
private static void RememberDir(string path)
{
try
{
string dir = Path.GetDirectoryName(path);
if (!string.IsNullOrEmpty(dir))
EditorPrefs.SetString(kPrefLastDir, dir);
}
catch (Exception)
{
// 记不住上次的目录不是错误,下次弹默认目录而已
}
}
private void Report(string message)
{
if (m_Report != null) m_Report(message);
Debug.Log("[ShaderBake] " + message);
}
private void Fail(string message)
{
if (m_Report != null) m_Report("导出失败:" + message);
Debug.LogError("[ShaderBake] " + message);
}
}
}
+185
View File
@@ -0,0 +1,185 @@
using System;
using System.Collections.Generic;
using System.IO;
using UnityEditor;
using UnityEngine;
namespace XericUI.ShaderBake.Editor
{
/// <summary>
/// 网格来源:从场景选中物体取网格,或把外部模型文件拉进工程再取网格。
///
/// <para><b>这里只搬网格,不搬层级</b>:烘焙是"一张网格 + 一个材质"离屏渲一次,
/// 多层物体(带骨骼、带多个材质球)在这里会被拆成"挑一个网格"。
/// 想要整棵树的效果请先把它们合到一个网格上,或者用 <c>SubMesh</c> 那一格逐层渲。</para>
/// </summary>
internal static class ShaderBakeModelSource
{
/// <summary> 外部模型文件的落点:不在工程里的文件必须先有个能导入的位置 </summary>
private const string kImportFolder = "Assets/XericShaderBakeImports";
/// <summary> 选中物体(含未激活的子物体)里三角数最多的网格 </summary>
public static Mesh PickFromSelection(out string note)
{
note = string.Empty;
GameObject selected = Selection.activeGameObject;
if (selected == null)
{
note = "场景里没选中物体";
return null;
}
Mesh best = null;
int bestCount = 0;
foreach (MeshFilter filter in selected.GetComponentsInChildren<MeshFilter>(true))
{
int count = CountTriangles(filter.sharedMesh);
if (count > bestCount)
{
best = filter.sharedMesh;
bestCount = count;
}
}
foreach (SkinnedMeshRenderer skinned in selected.GetComponentsInChildren<SkinnedMeshRenderer>(true))
{
int count = CountTriangles(skinned.sharedMesh);
if (count > bestCount)
{
best = skinned.sharedMesh;
bestCount = count;
}
}
if (best == null)
note = selected.name + " 及其子物体里没有网格";
else
note = "取自 " + selected.name + ":" + best.name + "(" + bestCount + " 三角)";
return best;
}
/// <summary>
/// 选一个模型文件导入并取网格。已经在工程里的文件不复制,只走一次导入。
/// </summary>
public static Mesh ImportFromFile(out string note)
{
note = string.Empty;
string path = EditorUtility.OpenFilePanelWithFilters(
"导入模型",
Directory.Exists(kImportFolder) ? kImportFolder : Application.dataPath,
new[] { "模型文件", "fbx,obj,dae,blend,3ds,ply,stl,glb,gltf", "所有文件", string.Empty });
if (string.IsNullOrEmpty(path))
{
note = "已取消";
return null;
}
string assetPath = ToProjectPath(path);
if (assetPath == null)
{
assetPath = CopyIntoProject(path);
if (assetPath == null)
{
note = "复制到工程失败";
return null;
}
}
AssetDatabase.ImportAsset(assetPath, ImportAssetOptions.ForceUpdate);
Mesh best = BiggestMeshAt(assetPath, out int triangleCount);
if (best == null)
note = assetPath + " 里没有可用的网格";
else
note = "已导入 " + assetPath + ":" + best.name + "(" + triangleCount + " 三角)";
return best;
}
private static int CountTriangles(Mesh mesh)
{
if (mesh == null)
return 0;
int total = 0;
for (int i = 0; i < mesh.subMeshCount; i++)
total += (int)mesh.GetIndexCount(i);
return total / 3;
}
/// <summary> 工程内的绝对路径换成 Assets/... 相对路径,不在工程内返回 null </summary>
private static string ToProjectPath(string absolutePath)
{
string normalized = absolutePath.Replace('\\', '/');
string dataPath = Application.dataPath.Replace('\\', '/');
if (!normalized.StartsWith(dataPath + "/", StringComparison.OrdinalIgnoreCase))
return null;
return "Assets" + normalized.Substring(dataPath.Length);
}
private static string CopyIntoProject(string absolutePath)
{
try
{
if (!Directory.Exists(kImportFolder))
Directory.CreateDirectory(kImportFolder);
string target = kImportFolder + "/" + Path.GetFileName(absolutePath);
File.Copy(absolutePath, target, true);
AssetDatabase.Refresh();
return target;
}
catch (Exception e)
{
Debug.LogError("[ShaderBake] 复制模型失败:" + e.Message);
return null;
}
}
/// <summary>
/// 模型里往往混着 LOD、碰撞体和皮肤网格,挑三角最多的那个通常就是用户想看的主体。
/// </summary>
private static Mesh BiggestMeshAt(string assetPath, out int triangleCount)
{
triangleCount = 0;
Mesh best = null;
var seen = new HashSet<Mesh>();
foreach (UnityEngine.Object obj in AssetDatabase.LoadAllAssetsAtPath(assetPath))
{
IEnumerable<Mesh> candidates = null;
var filter = obj as MeshFilter;
var skinned = obj as SkinnedMeshRenderer;
var prefab = obj as GameObject;
if (filter != null && filter.sharedMesh != null)
candidates = new[] { filter.sharedMesh };
else if (skinned != null && skinned.sharedMesh != null)
candidates = new[] { skinned.sharedMesh };
else if (prefab != null)
candidates = CollectFromPrefab(prefab);
if (candidates == null)
continue;
foreach (Mesh mesh in candidates)
{
if (mesh == null || !seen.Add(mesh))
continue;
int count = CountTriangles(mesh);
if (count > triangleCount)
{
best = mesh;
triangleCount = count;
}
}
}
return best;
}
private static IEnumerable<Mesh> CollectFromPrefab(GameObject prefab)
{
var list = new List<Mesh>();
foreach (MeshFilter filter in prefab.GetComponentsInChildren<MeshFilter>(true))
if (filter.sharedMesh != null) list.Add(filter.sharedMesh);
foreach (SkinnedMeshRenderer skinned in prefab.GetComponentsInChildren<SkinnedMeshRenderer>(true))
if (skinned.sharedMesh != null) list.Add(skinned.sharedMesh);
Mesh mesh = prefab.GetComponent<Mesh>();
if (mesh != null) list.Add(mesh);
return list;
}
}
}
+261
View File
@@ -0,0 +1,261 @@
using System;
using UnityEditor;
using UnityEngine;
using UnityEngine.UIElements;
namespace XericUI.ShaderBake.Editor
{
/// <summary>
/// 左侧浏览图:把渲染结果按缩放摆进滚动区,负责缩放、拖拽平移与透明底棋盘。
///
/// <para><b>为什么要把 stage 的最小尺寸钉成视口尺寸</b>:ScrollView 在 mode=Both 下不会把内容撑到
/// 视口大小,于是图小于视口时"居中"这条样式不成立,图会缩在左上角。这里显式把 min 尺寸设成视口尺寸,
/// 让居中和"图大了才出滚动条"两件事同时成立。</para>
/// </summary>
internal sealed class ShaderBakePreviewPane
{
private readonly ScrollView m_Viewport;
private readonly VisualElement m_Stage;
private readonly VisualElement m_Frame;
private readonly Image m_Checker;
private readonly Image m_Image;
private readonly Label m_Readout;
private Texture2D m_CheckerTexture;
private int m_CheckerWidth;
private int m_CheckerHeight;
private bool m_CheckerVisible;
private Vector2Int m_PixelSize = Vector2Int.zero;
private float m_Zoom = 1f;
private bool m_AutoFit = true;
private bool m_Dragging;
private Vector2 m_DragStart;
private Vector2 m_ScrollStart;
/// <summary> 当前缩放倍率(1 = 一个像素对应屏幕一个点) </summary>
public float zoom { get { return m_Zoom; } }
/// <summary> 用户手动改过缩放后就不再自动适配,免得每次渲染都把他的视图抢回去 </summary>
public bool autoFit { get { return m_AutoFit; } set { m_AutoFit = value; } }
public ShaderBakePreviewPane(VisualElement root)
{
m_Viewport = root.Q<ScrollView>("preview-viewport");
m_Stage = root.Q<VisualElement>("preview-stage");
m_Frame = root.Q<VisualElement>("preview-frame");
m_Checker = root.Q<Image>("preview-checker");
m_Image = root.Q<Image>("preview-image");
m_Readout = root.Q<Label>("preview-readout");
if (m_Viewport == null || m_Frame == null || m_Image == null)
throw new InvalidOperationException("BakeShaderWindow.uxml 缺少预览区节点");
m_Viewport.RegisterCallback<GeometryChangedEvent>(OnViewportGeometry);
m_Viewport.RegisterCallback<WheelEvent>(OnWheel);
m_Viewport.RegisterCallback<PointerDownEvent>(OnPointerDown);
m_Viewport.RegisterCallback<PointerMoveEvent>(OnPointerMove);
m_Viewport.RegisterCallback<PointerUpEvent>(OnPointerUp);
}
/// <summary> 挂上这次渲染的结果。传 null 表示"没有结果",只清读数。 </summary>
public void SetResult(Texture content, Vector2Int pixelSize)
{
m_PixelSize = pixelSize;
m_Image.style.backgroundImage = ToBackground(content);
if (m_AutoFit)
FitToView();
ApplySize();
}
/// <summary>
/// RenderTexture 与 Texture2D 走的是 Background 的两个不同入口——UI Toolkit 里 RT 不是
/// "一张普通纹理",它要自己那条采样路径;传空则回到"没有背景"。
/// </summary>
private static StyleBackground ToBackground(Texture content)
{
if (content == null)
return new StyleBackground(StyleKeyword.None);
var rt = content as RenderTexture;
if (rt != null)
return new StyleBackground(Background.FromRenderTexture(rt));
return new StyleBackground(Background.FromTexture2D(content as Texture2D));
}
/// <summary> 透明底棋盘:只在需要看 alpha 时生成那张纹理 </summary>
public void SetCheckerVisible(bool visible)
{
m_CheckerVisible = visible;
if (m_Checker == null)
return;
m_Checker.style.display = visible ? DisplayStyle.Flex : DisplayStyle.None;
if (visible)
ApplySize();
}
public void ZoomIn() { SetZoom(m_Zoom * 1.25f); }
public void ZoomOut() { SetZoom(m_Zoom / 1.25f); }
public void ActualSize() { m_AutoFit = false; SetZoom(1f); }
public void FitToView()
{
m_AutoFit = true;
Rect rect = m_Viewport.contentRect;
if (m_PixelSize.x <= 0 || m_PixelSize.y <= 0 || rect.width < 8f || rect.height < 8f)
return;
// 留 24px 边距,否则图正好贴边看上去像被裁了一半
float fit = Mathf.Min((rect.width - 24f) / m_PixelSize.x, (rect.height - 24f) / m_PixelSize.y);
SetZoom(fit);
}
public void Clear()
{
m_PixelSize = Vector2Int.zero;
m_Image.style.backgroundImage = new StyleBackground(StyleKeyword.None);
UpdateReadout();
}
public void Dispose()
{
if (m_CheckerTexture != null)
{
UnityEngine.Object.DestroyImmediate(m_CheckerTexture);
m_CheckerTexture = null;
}
}
private void SetZoom(float value)
{
m_Zoom = Mathf.Clamp(value, 0.02f, 32f);
ApplySize();
}
private void ApplySize()
{
if (m_PixelSize.x <= 0 || m_PixelSize.y <= 0)
{
m_Frame.style.width = 0f;
m_Frame.style.height = 0f;
UpdateReadout();
return;
}
int width = Mathf.Max(1, Mathf.RoundToInt(m_PixelSize.x * m_Zoom));
int height = Mathf.Max(1, Mathf.RoundToInt(m_PixelSize.y * m_Zoom));
m_Frame.style.width = width;
m_Frame.style.height = height;
if (m_CheckerVisible)
EnsureChecker(width, height);
UpdateReadout();
}
private void UpdateReadout()
{
if (m_Readout == null)
return;
if (m_PixelSize.x <= 0)
{
m_Readout.text = "无结果";
return;
}
m_Readout.text = m_PixelSize.x + " × " + m_PixelSize.y + " px " +
(m_Zoom * 100f).ToString("0.#") + "%";
}
private void OnViewportGeometry(GeometryChangedEvent evt)
{
// 视口变高变宽都要重钉,否则居中的参照物是上一次的大小
if (m_Stage != null)
{
m_Stage.style.minWidth = Mathf.Max(evt.newRect.width, 1f);
m_Stage.style.minHeight = Mathf.Max(evt.newRect.height, 1f);
}
if (m_AutoFit)
FitToView();
else
ApplySize();
}
private void OnWheel(WheelEvent evt)
{
if (m_PixelSize.x <= 0)
return;
// 滚轮在这块画布上的语义是缩放;平移交给拖拽,滚动条留给键盘和拖拽后的自动定位
m_AutoFit = false;
SetZoom(m_Zoom * (evt.delta.y > 0f ? 1.1f : 1f / 1.1f));
evt.StopPropagation();
}
private void OnPointerDown(PointerDownEvent evt)
{
if (m_PixelSize.x <= 0)
return;
m_Dragging = true;
m_DragStart = evt.position;
m_ScrollStart = m_Viewport.scrollOffset;
m_Viewport.CapturePointer(evt.pointerId);
}
private void OnPointerMove(PointerMoveEvent evt)
{
// 指针已经被 capture,move 一定送到这里,不需要再判断是否还在视口内
if (!m_Dragging)
return;
// 2022.1 的 position 是 Vector3,直接和 Vector2 相减会二义
Vector2 delta = (Vector2)evt.position - m_DragStart;
m_Viewport.scrollOffset = m_ScrollStart - delta;
}
private void OnPointerUp(PointerUpEvent evt)
{
m_Dragging = false;
m_Viewport.ReleasePointer(evt.pointerId);
}
/// <summary>
/// 生成 8px 格子的棋盘纹理。
///
/// <para>2022.1 的 <c>ScaleMode</c> 还没有 <c>Tile</c>,靠铺贴做不到,所以干脆按面片当前的
/// 显示尺寸生成一张等大纹理,元素直接拉伸也正好一格对一格。尺寸量化到 16 的整数倍:
/// 连续缩放时大多数帧能命中缓存,且格子边界始终对齐。</para>
/// </summary>
private void EnsureChecker(int width, int height)
{
const int cell = 8;
const int quantum = cell * 2;
const int maxSide = 1024;
int w = Mathf.Clamp(Mathf.Max(width, quantum) / quantum * quantum, quantum, maxSide);
int h = Mathf.Clamp(Mathf.Max(height, quantum) / quantum * quantum, quantum, maxSide);
if (m_CheckerTexture != null && m_CheckerWidth == w && m_CheckerHeight == h)
return;
UnityEngine.Object previous = m_CheckerTexture;
var tex = new Texture2D(w, h, TextureFormat.RGBA32, false)
{
name = "ShaderBakeChecker",
hideFlags = HideFlags.DontSave,
filterMode = FilterMode.Point,
wrapMode = TextureWrapMode.Clamp
};
var light = new Color32(107, 107, 107, 255);
var dark = new Color32(84, 84, 84, 255);
var pixels = new Color32[w * h];
for (int y = 0; y < h; y++)
{
int rowParity = (y / cell) & 1;
int offset = y * w;
for (int x = 0; x < w; x++)
pixels[offset + x] = (((x / cell) & 1) == rowParity) ? light : dark;
}
tex.SetPixels32(pixels);
tex.Apply();
m_CheckerTexture = tex;
m_CheckerWidth = w;
m_CheckerHeight = h;
m_Checker.style.backgroundImage = new StyleBackground(tex);
if (previous != null)
UnityEngine.Object.DestroyImmediate(previous);
}
}
}
@@ -0,0 +1,564 @@
using System;
using System.Collections.Generic;
using System.Text.RegularExpressions;
using UnityEditor;
using UnityEditor.UIElements;
using UnityEngine;
using UnityEngine.Rendering;
using UnityEngine.UIElements;
namespace XericUI.ShaderBake.Editor
{
/// <summary>
/// 右侧的"材质字段属性表":把 shader 声明的属性铺成一行行可编辑控件,改动直接写进那张
/// (临时)材质并通知外部重画。
///
/// <para><b>行从模板克隆,不在代码里造控件</b>:结构在 BakeShaderPropertyRow.uxml,
/// 这里只决定"这一行点亮哪个控件、其余收起来"。</para>
///
/// <para><b>2022.1 没有 GetPropertyDisplayName</b>,所以标签只能由属性名推(下划线去掉、
/// 驼峰拆词),description 拿来当 tooltip 并用于识别 <c>[Toggle]</c> 与 <c>[Enum]</c> 两类属性。
/// 这两个识别都是"猜形状",猜不中就退回普通数字框——功能不丢,只是少了个勾。</para>
/// </summary>
internal sealed class ShaderBakePropertyTable
{
/// <summary> 一行的所有控件;按类型只挂出一个 </summary>
private sealed class Row
{
public VisualElement root;
public Label label;
public FloatField floatValue;
public IntegerField intValue;
public Toggle toggle;
public DropdownField enumField;
public ColorField colorField;
public ObjectField textureField;
public VisualElement rangeGroup;
public Slider slider;
public FloatField rangeValue;
public VisualElement vectorGroup;
public FloatField[] vectorParts;
public int propIndex;
public string propName;
public ShaderPropertyType propType;
public string keyword;
public float rangeMin;
public float rangeMax;
/// <summary> 程序性赋值(RefreshValues)期间压掉回调,免得一次刷新触发一串重画 </summary>
public bool updating;
}
private readonly VisualElement m_Container;
private readonly VisualTreeAsset m_Template;
private readonly List<Row> m_Rows = new List<Row>();
private Shader m_Shader;
private Material m_Material;
/// <summary> 任一属性被改动(外部据此重画) </summary>
public event Action changed;
/// <summary> 行数(状态栏用来写"共 N 项属性") </summary>
public int rowCount { get { return m_Rows.Count; } }
public ShaderBakePropertyTable(VisualElement root, VisualTreeAsset rowTemplate)
{
m_Container = root.Q<VisualElement>("props-rows");
m_Template = rowTemplate;
if (m_Container == null)
throw new InvalidOperationException("BakeShaderWindow.uxml 缺少 props-rows 容器");
}
/// <summary>
/// 换目标。shader 变了重建行,只有材质变了就重新取值——重建一次要克隆几十行,
/// 不该在每次点导出的时候发生。
/// </summary>
public void SetTarget(Shader shader, Material material)
{
m_Material = material;
if (shader != m_Shader)
{
m_Shader = shader;
Rebuild();
}
else
{
RefreshValues();
}
}
public void Rebuild()
{
m_Rows.Clear();
m_Container.Clear();
if (m_Shader == null || m_Template == null)
return;
int count = ShaderUtil.GetPropertyCount(m_Shader);
for (int i = 0; i < count; i++)
{
if (ShaderUtil.IsShaderPropertyHidden(m_Shader, i))
continue;
Row row = CreateRow(i);
if (row != null)
{
m_Rows.Add(row);
m_Container.Add(row.root);
}
}
RefreshValues();
}
/// <summary> 把材质当前的值读回界面(写回/丢弃改动、或外部改了材质之后用) </summary>
public void RefreshValues()
{
foreach (Row row in m_Rows)
{
if (m_Material == null || !m_Material.HasProperty(row.propName))
{
row.root.style.display = DisplayStyle.None;
continue;
}
row.root.style.display = DisplayStyle.Flex;
row.updating = true;
try
{
FillFromMaterial(row);
}
finally
{
row.updating = false;
}
}
}
public void Dispose()
{
m_Rows.Clear();
m_Container.Clear();
}
// ── 建行 ────────────────────────────────────────────────
private Row CreateRow(int propIndex)
{
VisualElement host = new VisualElement();
m_Template.CloneTree(host);
if (host.childCount == 0)
return null;
VisualElement root = host[0];
root.RemoveFromHierarchy();
Shader shader = m_Shader;
string name = ShaderUtil.GetPropertyName(shader, propIndex);
// 两个同名枚举分属编辑器与运行时命名空间,但取值顺序一致(Color..Int..Constants)
var type = (ShaderPropertyType)(int)ShaderUtil.GetPropertyType(shader, propIndex);
string description = ShaderUtil.GetPropertyDescription(shader, propIndex);
var row = new Row
{
root = root,
label = root.Q<Label>("prop-label"),
floatValue = root.Q<FloatField>("prop-float"),
intValue = root.Q<IntegerField>("prop-int"),
toggle = root.Q<Toggle>("prop-toggle"),
enumField = root.Q<DropdownField>("prop-enum"),
colorField = root.Q<ColorField>("prop-color"),
textureField = root.Q<ObjectField>("prop-texture"),
rangeGroup = root.Q<VisualElement>("prop-range"),
slider = root.Q<Slider>("prop-slider"),
rangeValue = root.Q<FloatField>("prop-range-value"),
vectorGroup = root.Q<VisualElement>("prop-vector"),
propIndex = propIndex,
propName = name,
propType = type,
keyword = ReadKeyword(type, description)
};
row.vectorParts = new[]
{
root.Q<FloatField>("prop-vec-x"),
root.Q<FloatField>("prop-vec-y"),
root.Q<FloatField>("prop-vec-z"),
root.Q<FloatField>("prop-vec-w")
};
string displayName = ReadDisplayName(shader, propIndex, name);
if (row.label != null)
{
row.label.text = displayName;
row.label.tooltip = name + (string.IsNullOrEmpty(description) ? string.Empty : "\n" + description);
}
root.tooltip = row.label != null ? row.label.tooltip : name;
// 先把所有候选控件收起来,下面按类型只放一个出来
HideAll(row);
switch (type)
{
case ShaderPropertyType.Range:
row.rangeMin = ShaderUtil.GetRangeLimits(shader, propIndex, 0);
row.rangeMax = ShaderUtil.GetRangeLimits(shader, propIndex, 1);
Show(row.rangeGroup);
WireSlider(row);
WireRangeValue(row);
break;
case ShaderPropertyType.Float:
if (row.keyword != null)
{
Show(row.toggle);
WireToggle(row);
}
else
{
Show(row.floatValue);
WireFloat(row);
}
break;
case ShaderPropertyType.Int:
List<string> choices = ReadEnumChoices(description);
if (choices != null)
{
Show(row.enumField);
WireEnum(row, choices);
}
else if (row.keyword != null)
{
Show(row.toggle);
WireToggle(row);
}
else
{
Show(row.intValue);
WireInt(row);
}
break;
case ShaderPropertyType.Color:
Show(row.colorField);
if (row.colorField != null)
{
row.colorField.hdr = description != null && description.IndexOf("HDR", StringComparison.Ordinal) >= 0;
row.colorField.showAlpha = true;
}
WireColor(row);
break;
case ShaderPropertyType.Vector:
Show(row.vectorGroup);
WireVector(row);
break;
case ShaderPropertyType.Texture:
Show(row.textureField);
if (row.textureField != null)
{
row.textureField.objectType = typeof(Texture);
row.textureField.allowSceneObjects = false;
// [NonModifiableTexture] 的图是 shader 写死的,给个能看的框但别让人以为改得动
row.textureField.SetEnabled(!ShaderUtil.IsShaderPropertyNonModifiableTexureProperty(shader, propIndex));
}
WireTexture(row);
break;
}
return row;
}
private static string ReadDisplayName(Shader shader, int propIndex, string propName)
{
#if UNITY_2022_2_OR_NEWER
string displayName = ShaderUtil.GetPropertyDisplayName(shader, propIndex);
if (!string.IsNullOrEmpty(displayName))
return displayName;
#endif
return HumanizePropertyName(propName);
}
/// <summary> <c>_BaseColor</c> → <c>Base Color</c>:下划线只是 shader 的命名习惯,不该出现在界面上 </summary>
private static string HumanizePropertyName(string propName)
{
string text = propName.StartsWith("_", StringComparison.Ordinal) ? propName.Substring(1) : propName;
var builder = new System.Text.StringBuilder(text.Length + 4);
for (int i = 0; i < text.Length; i++)
{
char c = text[i];
if (i > 0 && char.IsUpper(c) && !char.IsUpper(text[i - 1]) && builder.Length > 0)
builder.Append(' ');
builder.Append(c);
}
return builder.ToString();
}
/// <summary>
/// 从 description 里认 <c>[Toggle(KEYWORD)]</c> / <c>[IntRange(KEYWORD)]</c> 的关键字。
/// Unity 在这里给到的形状不止一种("<c>_MY_KEYWORD</c>"、"My Toggle (<c>_MY_KEYWORD</c>)"、
/// "Toggle - <c>_MY_KEYWORD</c> on off"),所以规则是:挑一个下划线开头、或以
/// <c>_ON</c> / <c>_OFF</c> 结尾的标识符。
/// <para>故意不收全大写裸词(<c>SPECULAR</c> 这种散文会被误判成关键字,把数字属性变成勾);
/// 代价是 <c>[Toggle(FOO)]</c> 这类不带下划线的写法认不出来,退回数字框——功能不丢,只是少了个勾。</para>
/// </summary>
private static string ReadKeyword(ShaderPropertyType type, string description)
{
if (string.IsNullOrEmpty(description))
return null;
if (type != ShaderPropertyType.Float && type != ShaderPropertyType.Int)
return null;
MatchCollection matches = Regex.Matches(description, @"_?[A-Za-z][A-Za-z0-9_]*");
foreach (Match match in matches)
{
string token = match.Value;
if (token.Length < 2)
continue;
if (token.StartsWith("_", StringComparison.Ordinal))
return token;
if (token.EndsWith("_ON", StringComparison.Ordinal) || token.EndsWith("_OFF", StringComparison.Ordinal))
return token;
}
return null;
}
/// <summary> <c>[Enum(A|B|C)]</c> 与 <c>[KeywordEnum]</c> 的取值表;不是枚举就返回 null </summary>
private static List<string> ReadEnumChoices(string description)
{
if (string.IsNullOrEmpty(description))
return null;
char[] separators = description.IndexOf('|') >= 0 ? new[] { '|' } : new[] { ',' };
if (description.IndexOf('|') < 0 && description.IndexOf(',') < 0)
return null;
string[] parts = description.Split(separators);
var choices = new List<string>(parts.Length);
foreach (string part in parts)
{
string trimmed = part.Trim();
if (trimmed.Length == 0)
return null;
choices.Add(trimmed);
}
// 只有一个分隔符的散文("1, 000"之类)不该被当成枚举
return choices.Count >= 2 ? choices : null;
}
// ── 取值 / 写值 ─────────────────────────────────────────
private void FillFromMaterial(Row row)
{
switch (row.propType)
{
case ShaderPropertyType.Range:
float range = m_Material.GetFloat(row.propName);
// shader 的范围声明可能写反(Range(1, 0)),滑块吃下反区间会直接画不出把手
float min = Mathf.Min(row.rangeMin, row.rangeMax);
float max = Mathf.Max(row.rangeMin, row.rangeMax);
if (row.slider != null) { row.slider.lowValue = min; row.slider.highValue = max; }
if (range < min || range > max)
{
// 值掉在区间外时把区间撑开,否则滑块会把值就地改掉——那是"我动了你的参数"
if (row.slider != null) { row.slider.lowValue = Mathf.Min(min, range); row.slider.highValue = Mathf.Max(max, range); }
}
if (row.slider != null) row.slider.SetValueWithoutNotify(Mathf.Clamp(range, row.slider.lowValue, row.slider.highValue));
if (row.rangeValue != null) row.rangeValue.SetValueWithoutNotify(range);
break;
case ShaderPropertyType.Float:
float value = m_Material.GetFloat(row.propName);
if (row.toggle != null && row.keyword != null) row.toggle.SetValueWithoutNotify(!Mathf.Approximately(value, 0f));
if (row.floatValue != null) row.floatValue.SetValueWithoutNotify(value);
break;
case ShaderPropertyType.Int:
int intValue = m_Material.GetInt(row.propName);
if (row.toggle != null && row.keyword != null) row.toggle.SetValueWithoutNotify(intValue != 0);
if (row.intValue != null) row.intValue.SetValueWithoutNotify(intValue);
if (row.enumField != null)
row.enumField.SetValueWithoutNotify(ChoiceLabelFor(intValue, row.enumField.choices));
break;
case ShaderPropertyType.Color:
if (row.colorField != null) row.colorField.SetValueWithoutNotify(m_Material.GetColor(row.propName));
break;
case ShaderPropertyType.Vector:
Vector4 v = m_Material.GetVector(row.propName);
if (row.vectorParts != null)
{
row.vectorParts[0].SetValueWithoutNotify(v.x);
row.vectorParts[1].SetValueWithoutNotify(v.y);
row.vectorParts[2].SetValueWithoutNotify(v.z);
row.vectorParts[3].SetValueWithoutNotify(v.w);
}
break;
case ShaderPropertyType.Texture:
if (row.textureField != null) row.textureField.SetValueWithoutNotify(m_Material.GetTexture(row.propName));
break;
}
}
private void Write(Row row)
{
Action handler = changed;
if (handler != null)
handler.Invoke();
}
private void WriteKeywordState(Row row, bool on)
{
if (row.keyword == null || m_Material == null)
return;
// Unity 的原生材质面板就是这么做的:值写 float,关键字另写一份,两者必须同步
m_Material.SetFloat(row.propName, on ? 1f : 0f);
if (on) m_Material.EnableKeyword(row.keyword);
else m_Material.DisableKeyword(row.keyword);
}
private void WireSlider(Row row)
{
if (row.slider == null) return;
row.slider.RegisterValueChangedCallback(evt =>
{
if (row.updating || m_Material == null) return;
m_Material.SetFloat(row.propName, evt.newValue);
if (row.rangeValue != null) row.rangeValue.SetValueWithoutNotify(evt.newValue);
Write(row);
});
}
private void WireRangeValue(Row row)
{
if (row.rangeValue == null) return;
row.rangeValue.RegisterValueChangedCallback(evt =>
{
if (row.updating || m_Material == null) return;
m_Material.SetFloat(row.propName, evt.newValue);
if (row.slider != null)
row.slider.SetValueWithoutNotify(Mathf.Clamp(evt.newValue, row.slider.lowValue, row.slider.highValue));
Write(row);
});
}
private void WireFloat(Row row)
{
if (row.floatValue == null) return;
row.floatValue.RegisterValueChangedCallback(evt =>
{
if (row.updating || m_Material == null) return;
m_Material.SetFloat(row.propName, evt.newValue);
Write(row);
});
}
private void WireInt(Row row)
{
if (row.intValue == null) return;
row.intValue.RegisterValueChangedCallback(evt =>
{
if (row.updating || m_Material == null) return;
m_Material.SetInt(row.propName, evt.newValue);
Write(row);
});
}
private void WireToggle(Row row)
{
if (row.toggle == null) return;
row.toggle.RegisterValueChangedCallback(evt =>
{
if (row.updating || m_Material == null) return;
WriteKeywordState(row, evt.newValue);
Write(row);
});
}
private void WireEnum(Row row, List<string> choices)
{
if (row.enumField == null) return;
row.enumField.choices = choices;
row.enumField.RegisterValueChangedCallback(evt =>
{
if (row.updating || m_Material == null) return;
int index = choices.IndexOf(evt.newValue);
m_Material.SetInt(row.propName, Mathf.Max(index, 0));
Write(row);
});
}
private void WireColor(Row row)
{
if (row.colorField == null) return;
row.colorField.RegisterValueChangedCallback(evt =>
{
if (row.updating || m_Material == null) return;
m_Material.SetColor(row.propName, evt.newValue);
Write(row);
});
}
private void WireVector(Row row)
{
for (int i = 0; i < row.vectorParts.Length; i++)
{
FloatField field = row.vectorParts[i];
if (field == null) continue;
int component = i;
field.RegisterValueChangedCallback(evt =>
{
if (row.updating || m_Material == null) return;
Vector4 v = m_Material.GetVector(row.propName);
if (component == 0) v.x = evt.newValue;
else if (component == 1) v.y = evt.newValue;
else if (component == 2) v.z = evt.newValue;
else v.w = evt.newValue;
m_Material.SetVector(row.propName, v);
Write(row);
});
}
}
private void WireTexture(Row row)
{
if (row.textureField == null) return;
row.textureField.RegisterValueChangedCallback(evt =>
{
if (row.updating || m_Material == null) return;
m_Material.SetTexture(row.propName, evt.newValue as Texture);
Write(row);
});
}
private static string ChoiceLabelFor(int value, List<string> choices)
{
if (choices == null || choices.Count == 0)
return string.Empty;
if (value < 0 || value >= choices.Count)
return value.ToString();
return choices[value];
}
private static void HideAll(Row row)
{
Hide(row.floatValue);
Hide(row.intValue);
Hide(row.toggle);
Hide(row.enumField);
Hide(row.colorField);
Hide(row.textureField);
Hide(row.rangeGroup);
Hide(row.vectorGroup);
}
private static void Show(VisualElement element)
{
if (element != null) element.style.display = DisplayStyle.Flex;
}
private static void Hide(VisualElement element)
{
if (element != null) element.style.display = DisplayStyle.None;
}
}
}