diff --git a/CHANGELOG.md b/CHANGELOG.md index beff499..b29c36a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -109,6 +109,20 @@ P29b 方向来源删到三档 + 资产值迁移(规范 §33.4,2026-11-08 他 合并他那 17 条 ShaderBake 提交(gitea/thr_dev/dev2,2026-11-05/06)到 thr_dev/dev_chart(`ae992c6`,已推):两条线从 a311c41 分叉,文件集只共用 `XericRegistrationPaths.cs`,他那侧只新增 `ToolBar` 常量、两套根都保住(工具栏 `XericLibrary/Action Vessel`、右键 `Xeric Library/Action Vessel`),入口走常量没有硬编码 ⇒ 无冲突。**门先整轮红在环境不是代码**:rsp 记录的引擎 `U:/UNITY_Engine/editor/2022.1.24f1` 已经不在(U: 上那版只剩安装包),同版本在 `G:/Unity_EngineFlie/Unity 2022.1.24f1`;给 `run_gate.py` 加"引用按引擎根重映射 + 逐臂计数 + 开头点名读的是哪个引擎根"(211 条引用全部能在那边解析),`probe_run.py` 的 mono 路径同规则。重跑三臂 + 3 对照绿,并且正向确认 ShaderBake 的 **11 runtime + 8 editor** 文件真进了被编译的清单——rsp 是快照,新文件靠 `scan_dir` 补,不补就会"绿着跳过"它们。 P25/P23 填充改由一个 Graphic 自己画完(规范 §34,2026-11-08 他定形状:"填充不需要额外的渲染脚本,自己写一个简单的就够了"):形状上把分块那套(`FaceChunk`/`EnsureChunkCount`/子物体/`MaxChunkVertices`)全部拿掉,一个 `MaskableGraphic` 自己填,不再依赖库的分块填充渲染器(库那侧的分块照旧,只有这一份实现改了)。② **顶点上限只能前缀取舍**:一个 Graphic 65535 顶点 ⇒ 装不下的只能整段放弃且不许重排(画家顺序就是提交顺序,跳着画会画出"数据里不存在"的拼接),被放弃的面由报表 `fillRefused=` 报出来而不是静默少画;`XChartMeshBudget.VerticesPerFace`(Radial 5 / Flat·Linear 4)**一处定义、守卫与写网格两边共用**——否则守卫按 4 判、写手按 5 画,报出来的 refused 数就不等于画面上的缺。③ **P23"发了但不上屏"的根因读源码而不是靠记忆**(`com.unity.ugui@1.0.0/Runtime/UI/Core/Graphic.cs`):17-18 行属性只有 `DisallowMultipleComponent` + `RequireComponent(RectTransform)`,**没有 CanvasRenderer**;640 行 `Rebuild` 第一句 `if (canvasRenderer == null || canvasRenderer.cull) return`;453-467 行的 `canvasRenderer` **是 getter,读到时会 `AddComponent`**(所以读它等于写应用状态)⇒ 我们运行时造的子物体只带 RectTransform,网格填满了、提交发生了、什么也没画、也不报错;库里那三个基类都带这个属性,**这正是散点/折线/曲线/箭头能上屏而填充不能的那条差**。两处修:类上补 `[RequireComponent(typeof(CanvasRenderer))]`,`CreateChild`(工具子物体的唯一出处)把两个组件写全;`OnPopulateMesh` 开头补 `vh.Clear()`(`DoMeshGeneration` 只在坏矩形那一支清,共享的 `s_VertexHelper` 不归子类清)。④ **四个读数各判一层**:`fillPlan=`(Apply 时算)、`fillShipped=`(真写进 VertexHelper 的)、`fillRefused=`(被上限挤出去的)、`fillCr=`(用 `GetComponent()` 判,不用那个会 AddComponent 的 getter,否则永远答 yes)。判据:新门 `fill_gate.py`(7 支,主张是"类带属性/CreateChild 写全/渲染器里没有嵌套 Graphic、没有运行时 GameObject、没有 AddComponent/上限被真正使用且只画接受的前缀/`VerticesPerFace` 是唯一那张表/报表印四个键且 presence 走 GetComponent"),正本 0 findings + 7 支全红 + 编译门三臂绿;探针 **474** 项 0 失败(6 条打在性质上:接受的面永远不超上限、真的有一面被拒、接受的是最大前缀所以画家顺序没被打乱、装得下的整批全收、单面超上限则整批全拒、0 面则两头都 0),`p4_control` **73** 支照旧各红在点名断言(第 26 支重挂"从不查上限、每面都收=会撞 65535"),`dirty_gate` `knobs=136 takesEffect=136 findings=0`。三次被门/自己抓到的记录:① `fill_gate` 基线假红——属性正则要求它在第 0 列;② 臂 F4 绿着——主张 D 把 `Apply()` 里的计数循环也当成了"画前缀",正确处置是**把判据收窄到真提交顶点的那个方法体**,不是放宽正则;③ 探针在第 26 支上**先死再判**(断言的明细值 `counts[accepted]` 越界,打印的是"NO VERDICT LINE (the probe died before judging)")——仪器死掉的"红"不是判决,明细值必须自证安全。**覆盖不到**:Canvas 收 CanvasRenderer 那一跳在引擎内部,离线门只能判形状与读数;上屏归他 Ctrl+R 判——报表 `fillCr=yes`、`fillShipped>0`、超大数据上 `fillRefused>0`(而不是抛异常)就是这一笔该给的样子;若那三个数都对而画面仍空,§34.3 就不是全部故事。 P26 标签是"记录上的标签列",不是随身的一串字符串(规范 §35,2026-11-08 他前几轮的口径:"每个数据项目对应数个 float 维和一个 string 维,把 string 维放在数据编辑器窗口前面直接编辑"):① **1:1 落在门口**——`XChartColumnMath` 补标签半边(`LabelCount` / `LabelSlotOf` / `DefinitionOfLabelSlot` / `SizedLabels`,与数值三支完全对称),`TryAddRecord` 在 `labels` 非 null 且长度≠标签列数时整条拒收,文本导入按标签字段个数校验并点名行号(以前默认"多出来的就是标签",于是窗口显示得出来、元素读不到、导出再读回来变了样;顺带补上记录行少到连时间戳都没有时点名拒绝,那条路原来抛的是异常不是判决);② **窗口一个显示序、两个读者**——`ComputeColumnSlots` 同时算值槽/标签槽/显示序(标签列在前),表头与行都遍历它;每格身份是 `CellRef{IsLabel,Slot}`(`-1` 仍只表示"这一列不占格"),标签格走 `TrySetLabel` 的字符串分支(数字解析会把"巷道1"当错报拒掉),工具栏「+标签」加的是 Label 维、走 `SetDimensions` 这唯一定长路径(老记录补空串、不挤走旧标签);③ **标签元素**(`ChartToolLabels` + `XChartLabelConfig`)13 个旋钮全自动置脏,位置与折法同散点/圆柱(范围只定标尺,§32),文本走池且**比记录多的槽位必须擦**,锚点与对齐出自同一档(pivot 与 alignment 都从 `AnchorOf`/`AlignmentFor` 来,`anchorMin/Max` 不写),报表 `labelSlot= dim= records= want= have= pending= written= cleared= empty= hidden= skipped= out= anchor= wrap=` 把数据侧与槽位侧分开;面板把"要几个标签列/表里有几个"和数值维、记录数一起印(§25.1 第三半,`RequiredLabelColumns`)。④ **探针这一轮抓到两个真缺陷(判据先红、代码后改)**:`SizedLabels(null,n)` 原来补的是 null 元素而不是空串——窗口里同为空,但"这一格是空的"这条判据上 null 与 `""` 各答一套(导入写出的永远是 `""`,往返一次就变样);九档锚点表**漏了 `MiddleRight`**、落到 `default`(Center),所谓"九档"实际只有八档。判据:探针 **492** 项 0 失败(新增 `label columns:` 一组 8 条 + `label anchor:` 一组 6 条;原 `data text:` 的标签断言按新口径重写——记录带 1 个标签列,没给标签的记录**仍有那一格**、是空串);新门 `label_gate.py` 15 条 claim + 15 支臂全红(每条 claim 一支变异;C7 的 forbidden 只认**写** `anchorMin =`,注释里解释"为什么不写"不算违规);`p4_control` **78** 支(新增 5 支:标签槽手数/记录自定标签长度/边中点锚点落到中心/非有限偏移直通/删标签列留错那一格;原"删列留旧值"那支的锚点因 `TryRemoveDimension` 重写而失效,已**重定靶**不是删掉);`dirty_gate` **149** 旋钮 149 生效(应磁盘清单新增 `Text/ChartToolLabels.cs`);`slot_reset_gate` 照旧 PASS;编译门三臂 + 3 对照绿,且 `source present:` 逐条点名四个新文件。覆盖不到:`AlignmentFor` 返回 TMPro 类型、离线探针引用不到那个程序集 ⇒ "对齐出自同一表"由源码门(C5/C6)判;标签真上屏、窗口里改完字跟着变归他 Ctrl+R 判。 +新增「Bake Shader As Image」窗口(XericLibrary/Tool):把 shader 离屏烘成贴图 / Sprite / 图片文件;左侧预览可缩放拖拽,右侧细节面板,顶部工具栏 + 底部状态栏 +输入源分 Shader / Material 两路:Shader 造临时材质、Material 复制一份,属性表改的都是副本,「写回原材质」才落到资产 +材质属性表按 shader 属性类型铺行(Range 滑块、Float/Int、[Toggle] 关键字、[Enum]、Color、Vector、贴图),刷新时把值原样回写材质并同步关键字 +面片网格:一格一张 UV 区域,格号(UV X/Y)可编辑,加行加列按贴边格推算编号;另支持外部网格与细分 +相机:正交/透视,视图投影矩阵自建(含 Z 镜像与可选 Y 翻转),双面绘制兜住绕序;框取按内容宽高比铺满输出,输出比例不一致时用拉伸而不是留白 +输出:尺寸预设/自定义、MSAA、HDR、sRGB、翻转 Y、Pass 下标、背景色;导出 PNG / JPG / TGA / EXR 与 Sprite 资产 +实时预览走编辑器心跳(聚焦 60fps、失焦 20fps),关掉时改动记成「待刷新」写在重新渲染按钮上;覆盖率只写 Debug.Log,且只在百分比变化时输出 +测试视图四种:UV / 梯度 / 棋盘 / 纯色自检,用同一套面片/相机/参数走探针重画;UV 视图按 UV 跨度归一,重复次数 >1 时一格仍是一条连续尺子,整数 UV 处留分界线 +预览图上叠分格线与每格 UV 编号,点选换格时右侧 UV X/Y 跟着刷新 +全局参数:扫描 shader 用到的引擎全局量(光照方向、环境光、反射探针等),渲染前注入、渲染后立即还原 +修分格线与选中框一直不显示:`Matrix4x4 * Vector3` 走隐式 `Vector3→Vector4`,w 恒为 0,`clip.w <= 0` 把每一格都判成不在画面里 +修 Range 属性的滑块区间取错:`ShaderUtil.GetRangeLimits` 的 0/1/2 依次是 默认值/最小/最大,按 0/1 取会让区间变成 0..默认值,手柄永远顶在右端 +修属性行数值框被挤出面板:主题滑块默认不收缩,显式 `flex-shrink: 1` 并把数值框钉死 58px +细节面板六个板块改用 Foldout 折叠(原来是带复选框的 Toggle,看着不像能折),标题左侧的三角就是状态,整条可点;全局参数默认折叠 ## [0.1.6] - 2026-07-01 diff --git a/Editor/ShaderBake/BakeShaderAsImageWindow.cs b/Editor/ShaderBake/BakeShaderAsImageWindow.cs index 960b1a0..be3b653 100644 --- a/Editor/ShaderBake/BakeShaderAsImageWindow.cs +++ b/Editor/ShaderBake/BakeShaderAsImageWindow.cs @@ -27,13 +27,30 @@ namespace XericUI.ShaderBake.Editor 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 kGlobalRowUxmlPath = "Packages/com.lrss3.xericuiactionvessel/Editor/ShaderBake/BakeShaderGlobalRow.uxml"; + private const string kDebugViewShaderPath = "Packages/com.lrss3.xericuiactionvessel/Editor/ShaderBake/ShaderBakeDebugView.shader"; private const string kPrefSettings = "XericUI.ShaderBake.Settings"; private const string kPrefAutoRefresh = "XericUI.ShaderBake.AutoRefresh"; private const string kPrefChecker = "XericUI.ShaderBake.Checker"; + private const string kPrefDebugView = "XericUI.ShaderBake.DebugView"; private const string kPrefDetailWidth = "XericUI.ShaderBake.DetailWidth"; private const string kPrefSource = "XericUI.ShaderBake.SourceAsset"; + /// 测试视图用的那张 shader(Editor 目录下,见 ShaderBakeDebugView.shader) + private const string kDebugViewShader = "Hidden/XericUI/ShaderBake/Debug View"; + + /// + /// 实时预览的节拍上限:有焦点时按 60fps 排,失焦降到 20fps。 + /// + /// 这只是"最早什么时候重画",真正的帧率还受渲染耗时和编辑器自己的刷新率限制—— + /// 所以别处只管少做无用功,别指望靠调这个数字把卡顿调掉。 + /// + private const double kLiveIntervalFocused = 1.0 / 60.0; + private const double kLiveIntervalBlurred = 1.0 / 20.0; + + /// 覆盖率读数降频:它要 ReadPixels,会同步一次显卡,实时预览里做多了就是顿感来源 + private const double kCoverageInterval = 2.0; + private const float kDefaultDetailWidth = 340f; private static readonly string[] kAntiAliasingChoices = { "1", "2", "4", "8" }; private const string kCustomSize = "自定义"; @@ -56,8 +73,10 @@ namespace XericUI.ShaderBake.Editor private ObjectField m_MaterialField; private Label m_SourceNote; private Button m_ExportButton; + private ToolbarButton m_RenderButton; private ToolbarToggle m_AutoRefreshToggle; private ToolbarToggle m_CheckerToggle; + private ToolbarButton m_DebugButton; private Label m_StatusMessage; private Label m_StatusSize; private Label m_StatusTime; @@ -68,14 +87,46 @@ namespace XericUI.ShaderBake.Editor private readonly List m_Syncers = new List(); private bool m_RenderPending; + /// 实时预览关着时攒下的改动:还没重画,「重新渲染」按钮上会写着这件事 + private bool m_PendingRefresh; private double m_LastRenderMs = -1; + private double m_NextLiveRender; + /// 上一次心跳的时刻;用来量两次心跳之间实际隔了多久 + private double m_LastHeartbeatTime; + /// 实测心跳间隔(毫秒),-1 = 还没量到 + private float m_LiveFrameMs = -1f; + private double m_NextStatusUpdate; + private double m_NextCoverageCheck; /// 上一次结果的不透明像素占比,-1 = 没测出来 private float m_LastCoverage = -1f; - /// 管线自检的探针(活着才能让自检那张图继续显示) - private ShaderBakeRenderer m_SelfTestProbe; - private RenderTexture m_SelfTestTarget; - private Material m_SelfTestMaterial; + /// 上一次写进日志的覆盖率百分比:只在变化时输出,避免拖滑块刷屏 + private int m_LoggedCoverage = -1; + /// 探针(自检 / 测试视图)活着才能让那张图继续显示;切回真实结果时才收掉 + private readonly ShaderBakeOverrideRenderer m_Override = new ShaderBakeOverrideRenderer(); + private DebugView m_DebugView = DebugView.None; + /// 测试视图那张材质:_Mode 决定画哪种图,建一次反复用 + private Material m_DebugMaterial; private int m_SelectedFace; + /// 给预览面板的分格数据:每帧重填,避免按格新建列表 + private readonly List m_GridCells = new List(); + + /// 预览换成"量几何与 UV"的测试图。都不吃贴图、不吃光照,画不出来的原因只剩一个。 + /// Uv/Gradient/Checker 的取值与 shader 的 _Mode 一一对应 + private enum DebugView + { + None = -1, + /// 红=U、绿=V,一格四角即 00/10/01/11 + Uv = 0, + /// 灰度尺:主体沿 U、顶条沿 V,每 0.1 一档,量这一格跨了多少像素 + Gradient = 1, + /// 半 UV 棋盘 + 每格色相 + 左下角红/右上角蓝,看拉伸、斜切与镜像 + Checker = 2, + /// + /// 内置 Unlit/Color 的一张绿面片:不吃贴图、不吃光照、不吃 UV,只回答"这套矩阵画得出东西吗"。 + /// 取值故意离开 shader 的 _Mode 范围——它用的是另一张 shader + /// + SolidColor = 20 + } [MenuItem(XericRegistrationPaths.ToolBar + "/Bake Shader As Image", false, 20)] private static void OpenFromMenu() @@ -123,19 +174,54 @@ namespace XericUI.ShaderBake.Editor BuildGlobalTable(); BindFaceGrid(); BindToolbar(); - BindSections(); BindSettings(); BindDetailSplit(); RestorePrefs(); SyncUiFromSettings(); + // 面片网格的行列数只在 RefreshFaceUi 里回写,开窗时得先走一遍, + // 否则那行字会停在 UXML 的默认值上,和实际渲染的格子对不上 + RefreshFaceUi(); AdoptSelectionIfEmpty(); AssignSource(m_Source.sourceShader, m_Source.sourceMaterial, true); DoRender(); + + // 实时预览的节拍由这里驱动,域重载/关窗口时在 OnDisable 里摘掉 + EditorApplication.update -= OnEditorUpdate; + EditorApplication.update += OnEditorUpdate; + } + + /// + /// 编辑器心跳:实时预览开着就按固定节拍重画,不管有没有"改动事件"。 + /// + /// 之所以不能只等控件回调:数字框是延迟提交的,拖标签刻度、在别处改材质、 + /// shader 里用 _Time 挪顶点,这些都不会发 ChangeEvent——表现就是"界面不跟着刷新"。 + /// 关掉实时预览时这里什么都不做,改动只标记成待刷新。 + /// + private void OnEditorUpdate() + { + if (m_Renderer == null || m_Preview == null || m_AutoRefreshToggle == null || !m_AutoRefreshToggle.value) + return; + double now = EditorApplication.timeSinceStartup; + if (now < m_NextLiveRender) + return; + + // 实测两次心跳之间的间隔。它是"看到的帧率",和渲染本身花了多少毫秒不是一回事: + // 卡在别处时两个数会差很远,只有摆出来才分得清是谁的问题 + if (m_LastHeartbeatTime > 0.0) + { + float delta = (float)((now - m_LastHeartbeatTime) * 1000.0); + m_LiveFrameMs = m_LiveFrameMs < 0f ? delta : Mathf.Lerp(m_LiveFrameMs, delta, 0.3f); + } + m_LastHeartbeatTime = now; + + m_NextLiveRender = now + (hasFocus ? kLiveIntervalFocused : kLiveIntervalBlurred); + DoRender(true); } private void OnDisable() { + EditorApplication.update -= OnEditorUpdate; SavePrefs(); if (m_Exporter != null) m_Exporter.settingsReplaced -= OnSettingsReplaced; @@ -143,8 +229,9 @@ namespace XericUI.ShaderBake.Editor m_PropertyTable.Dispose(); if (m_Preview != null) m_Preview.Dispose(); - // 临时材质一定要还:它挂着的是 shader,不销毁就是每次开关窗口漏一份 - ReleaseSelfTestTarget(); + // 探针那张 RT 归探针所有,先收探针;测试视图材质挂着 shader,不销毁就是每次开关窗口漏一份 + m_Override.Release(); + ReleaseDebugMaterial(); if (m_Source != null) m_Source.Dispose(true); if (m_Renderer != null) m_Renderer.Dispose(true); m_Source = null; @@ -178,6 +265,7 @@ namespace XericUI.ShaderBake.Editor m_ExportButton = Require("export-menu"); m_AutoRefreshToggle = Require("auto-refresh"); m_CheckerToggle = Require("show-checker"); + m_DebugButton = Require("debug-view"); m_StatusMessage = Require