docs: 补 Bake Shader 窗口的 README 章节与 CHANGELOG 条目
README 增加输入源、输出、面片与 UV、实时预览与测试视图、全局参数、已知限制几节; CHANGELOG 在 [Unreales] 里补上这个窗口的完整能力,以及本轮修掉的四个问题 (分格线不显示、滑块区间取错、数值框被挤出面板、切换 shader 后值不生效的加固)。
This commit is contained in:
@@ -105,6 +105,19 @@ P28 面边插槽 6×4=24(规范 §31,2026-10-26 他数的两件事):
|
|||||||
P27 显示范围只定标尺;数据图元自己决定"钳/藏/原样"(规范 §32,2026-10-26 他裁定):症状是**同一张表两幅画**——散点折进盒子用的是 `Mathf.Clamp01`(超范围的点钉在盒壁上,看着像"数据到边就停"),而矢量与圆柱按 `TryNormalize` 比例投(可以跑到盒外),两边都"看着挺对"、谁也不报错(再往前箭头连折都没折=§28 的"计数全对画面空无一物")。他给的口径:**范围的本分是定标尺(网格多大、轴到哪儿),它不该决定数据画不画**;数据项目该呈现自己准确的位置;有时又确实想看被限制住的版本 ⇒ 开关交给数据图元。落法:① 新纯算术 `XChartCubeFoldMath`——`TryRatio01(value,min,max,behaviour,out 0..1)` 是**唯一**一份"值→盒子内比例",`TryFoldCube` 是三轴全有或全无版([-1,1];只夹一轴会画出"数据里不存在"的位置,比少画一条糟得多);② 圆柱原来调 `XChartBindingMath.TryNormalize`、箭头调 `XChartVectorFieldMath.TryCubePoint`、散点调自己那份 `Normalize` ⇒ **三份并成一份**(箭头的 `TryCubePoint` 删掉);③ 数据图元各一个三档 `XChartValueOutOfRange`,**默认 `RenderAsIs`**(散点从此不贴边=行为变更,另一处行为变更:**一整列同一个数**以前让矢量整条拒答,现在答居中,因为为"还没钉范围"把元素弄没等于把状态误报成"这里没有数据";坏数 NaN/Inf 仍拒答);轴与格线**永远**用范围、不给开关(否则就是 §20 一路在拆的"格线按 A、刻度按 B");④ 颜色映射那一档**刻意不统一**:越界的颜色取端色是常态,继续夹,"隐藏超范围"是坐标的事——写成注释防下次有人"顺手统一"把梯度弄出洞;⑤ 读数 `out=asis|clamptorange|hideoutofrange` 与 `hidden=`(策略隐的)/`skipped=`(数据不可用的)分开印,"我主动不画"和"数据不能用"必须分得开。搬家那一步被门抓了一次且抓得对:`dirty_gate` 的 claim F 当场 FAIL("箭头的坐标不再经过折法")——它判的是"必须经过**唯一那份**折法"而不是"必须调用某个旧名字",所以正确处置是把门指向新来源,**删判据是错的处理**;M8(把旧形状塞回去)这轮继续红,顺带证明"搬家会被抓到"。判据:探针 **469** 项 0 失败(三档各一条 + 常数列居中 + 坏数仍拒 + §28 那批域内/域外判据挪到唯一实现上)、`p4_control` **71** 支全红在点名断言(新 2 支:hide 不 hide/clamp 不 clamp;搬家 3 支重挂新文件)、`dirty_gate` 正本 `knobs=136 takesEffect=136`(三个新旋钮都是自动置脏 setter)九支全红、编译门三臂 + 3 对照绿(`chain_p27.txt`)。自己的错照记:新判据的期望值我手打算错了(y 域是 `-20..20` 却按 `-100..50` 算),探针第一次跑就红——手打的数字必须有对着真输入的断言;中文第四次进了声明 `coding: ascii` 的门脚本。覆盖不到:画到盒外的点会不会被别的东西挡住、以及"默认到底该钳还是原样"的观感,归他现场判——**他觉得"跑出去太乱"时不用回滚代码,把那一档调成 `ClampToRange` 就行**,这正是开关存在的意义。
|
P27 显示范围只定标尺;数据图元自己决定"钳/藏/原样"(规范 §32,2026-10-26 他裁定):症状是**同一张表两幅画**——散点折进盒子用的是 `Mathf.Clamp01`(超范围的点钉在盒壁上,看着像"数据到边就停"),而矢量与圆柱按 `TryNormalize` 比例投(可以跑到盒外),两边都"看着挺对"、谁也不报错(再往前箭头连折都没折=§28 的"计数全对画面空无一物")。他给的口径:**范围的本分是定标尺(网格多大、轴到哪儿),它不该决定数据画不画**;数据项目该呈现自己准确的位置;有时又确实想看被限制住的版本 ⇒ 开关交给数据图元。落法:① 新纯算术 `XChartCubeFoldMath`——`TryRatio01(value,min,max,behaviour,out 0..1)` 是**唯一**一份"值→盒子内比例",`TryFoldCube` 是三轴全有或全无版([-1,1];只夹一轴会画出"数据里不存在"的位置,比少画一条糟得多);② 圆柱原来调 `XChartBindingMath.TryNormalize`、箭头调 `XChartVectorFieldMath.TryCubePoint`、散点调自己那份 `Normalize` ⇒ **三份并成一份**(箭头的 `TryCubePoint` 删掉);③ 数据图元各一个三档 `XChartValueOutOfRange`,**默认 `RenderAsIs`**(散点从此不贴边=行为变更,另一处行为变更:**一整列同一个数**以前让矢量整条拒答,现在答居中,因为为"还没钉范围"把元素弄没等于把状态误报成"这里没有数据";坏数 NaN/Inf 仍拒答);轴与格线**永远**用范围、不给开关(否则就是 §20 一路在拆的"格线按 A、刻度按 B");④ 颜色映射那一档**刻意不统一**:越界的颜色取端色是常态,继续夹,"隐藏超范围"是坐标的事——写成注释防下次有人"顺手统一"把梯度弄出洞;⑤ 读数 `out=asis|clamptorange|hideoutofrange` 与 `hidden=`(策略隐的)/`skipped=`(数据不可用的)分开印,"我主动不画"和"数据不能用"必须分得开。搬家那一步被门抓了一次且抓得对:`dirty_gate` 的 claim F 当场 FAIL("箭头的坐标不再经过折法")——它判的是"必须经过**唯一那份**折法"而不是"必须调用某个旧名字",所以正确处置是把门指向新来源,**删判据是错的处理**;M8(把旧形状塞回去)这轮继续红,顺带证明"搬家会被抓到"。判据:探针 **469** 项 0 失败(三档各一条 + 常数列居中 + 坏数仍拒 + §28 那批域内/域外判据挪到唯一实现上)、`p4_control` **71** 支全红在点名断言(新 2 支:hide 不 hide/clamp 不 clamp;搬家 3 支重挂新文件)、`dirty_gate` 正本 `knobs=136 takesEffect=136`(三个新旋钮都是自动置脏 setter)九支全红、编译门三臂 + 3 对照绿(`chain_p27.txt`)。自己的错照记:新判据的期望值我手打算错了(y 域是 `-20..20` 却按 `-100..50` 算),探针第一次跑就红——手打的数字必须有对着真输入的断言;中文第四次进了声明 `coding: ascii` 的门脚本。覆盖不到:画到盒外的点会不会被别的东西挡住、以及"默认到底该钳还是原样"的观感,归他现场判——**他觉得"跑出去太乱"时不用回滚代码,把那一档调成 `ClampToRange` 就行**,这正是开关存在的意义。
|
||||||
P29 方向的单位="差折法"(只缩不移位)+ 四档方向来源到底各自在做什么(规范 §33,2026-10-26 他试完四档报"看起来完全没有意义"):先把四种现象各自算清(用他自己那张表的数字:三列 x/y/z、域约 `x[-100..100] y[-49.9..49.9] z[-49.7..50]`、`DirectionScale=0.25`)——`NextRecordAsVector` 拿"下一条记录**折好的坐标**"当方向 ⇒ 长度上限就是 0.25 个盒半径(一截短矢量);`NextRecordAsPoint` 拿相邻两点的差 ⇒ 同样短、略有区别;`ThisRecordCarriesVector` 要 6 个数值维而表里只有 3 列 ⇒ **一支都不画**(这是正确的拒绝,`dims=3/6`,缺的是数据里的方向列);`AlternatingRecords` 拿奇数行的**原始值**当方向、**没折** ⇒ `(-93.5,10.1,49.0)×0.25 ≈ 23 个立方体单位 ≈ 2700 像素` ⇒ 他看到的"一根比终点还大的矢量"。前两档的"没意义"来自他的表没有方向列(把位置当方向用本来就是凑数的一档);**第四档是真 bug**:位置除以了跨度、方向没有,同一个 `DirectionScale` 底下一套值两种单位。修法=纯算术新增 `XChartCubeFoldMath.TryFoldDelta(dx,dy,dz, 各轴 min/max, out cubeDelta)` = `delta/span×2`:**不减 min**(位置折的是"在这列数据里的位置",方向折的是"多长、朝哪",减起点会把朝向变成在哪——全表平移会挪走所有箭头);**一个数据跨度=2 个立方体单位**,与位置铺满 [-1,1] 同尺度,`DirectionScale` 回到"再乘多少倍"的本分;**不吃 `OutOfRange`**(钳制/隐藏是坐标的事,把方向夹进盒子尺寸=替数据改方向);折不出来(某列跨度 ≤0 或非有限)这一条拒画,`hidden=`(尺度没用)与 `skipped=`(数据坏)分开数。判据:探针 **473** 项 0 失败,4 条打在性质上(零方向仍是零——位置折法在这里会答 −1,这条就是两套折法的分界;一个跨度=2 个单位;成比例且带符号;跨度 0/非有限拒答)+ `p4_control` **73** 支各红在点名断言(新 2 支:把方向按位置折=偏移混进来;方向干脆不缩=他那根巨箭的形状)+ 编译门三臂 + 3 对照绿(`chain_p29.txt`)。等他定的那一半我没动:旧 `NextRecordAsVector` 去留(他预制存的就是序号 0),三个选项与我的建议已给出,删档或改默认都会改他画面上的东西,属于待答项不是我该拍的实现细节。
|
P29 方向的单位="差折法"(只缩不移位)+ 四档方向来源到底各自在做什么(规范 §33,2026-10-26 他试完四档报"看起来完全没有意义"):先把四种现象各自算清(用他自己那张表的数字:三列 x/y/z、域约 `x[-100..100] y[-49.9..49.9] z[-49.7..50]`、`DirectionScale=0.25`)——`NextRecordAsVector` 拿"下一条记录**折好的坐标**"当方向 ⇒ 长度上限就是 0.25 个盒半径(一截短矢量);`NextRecordAsPoint` 拿相邻两点的差 ⇒ 同样短、略有区别;`ThisRecordCarriesVector` 要 6 个数值维而表里只有 3 列 ⇒ **一支都不画**(这是正确的拒绝,`dims=3/6`,缺的是数据里的方向列);`AlternatingRecords` 拿奇数行的**原始值**当方向、**没折** ⇒ `(-93.5,10.1,49.0)×0.25 ≈ 23 个立方体单位 ≈ 2700 像素` ⇒ 他看到的"一根比终点还大的矢量"。前两档的"没意义"来自他的表没有方向列(把位置当方向用本来就是凑数的一档);**第四档是真 bug**:位置除以了跨度、方向没有,同一个 `DirectionScale` 底下一套值两种单位。修法=纯算术新增 `XChartCubeFoldMath.TryFoldDelta(dx,dy,dz, 各轴 min/max, out cubeDelta)` = `delta/span×2`:**不减 min**(位置折的是"在这列数据里的位置",方向折的是"多长、朝哪",减起点会把朝向变成在哪——全表平移会挪走所有箭头);**一个数据跨度=2 个立方体单位**,与位置铺满 [-1,1] 同尺度,`DirectionScale` 回到"再乘多少倍"的本分;**不吃 `OutOfRange`**(钳制/隐藏是坐标的事,把方向夹进盒子尺寸=替数据改方向);折不出来(某列跨度 ≤0 或非有限)这一条拒画,`hidden=`(尺度没用)与 `skipped=`(数据坏)分开数。判据:探针 **473** 项 0 失败,4 条打在性质上(零方向仍是零——位置折法在这里会答 −1,这条就是两套折法的分界;一个跨度=2 个单位;成比例且带符号;跨度 0/非有限拒答)+ `p4_control` **73** 支各红在点名断言(新 2 支:把方向按位置折=偏移混进来;方向干脆不缩=他那根巨箭的形状)+ 编译门三臂 + 3 对照绿(`chain_p29.txt`)。等他定的那一半我没动:旧 `NextRecordAsVector` 去留(他预制存的就是序号 0),三个选项与我的建议已给出,删档或改默认都会改他画面上的东西,属于待答项不是我该拍的实现细节。
|
||||||
注册路径根改名:`Xeric Library` → `XericLibrary`(2026-10-26 他点名两处"`Table/Table Editor OverrideLayer`"和"`UI/Image/场景变形手柄`"的族前缀带了空格):他在两个具体组件上看到的只是症状,根因在唯一那份总表——`XericRegistrationPaths.Root`(`Runtime/Core/XericRegistrationPaths.cs`)写的是带空格的 `"Xeric Library"`,而**所有族常量都是它拼出来的**(Chart/Table/UI/Layout/Form/翻页/…),所以改了根就一次性把整个包的菜单与组件路径统一成 `XericLibrary/...`。改动是**一个常量加一行注释**,不散落:全仓 `grep "Xeric Library"` 只剩两处**散文**(ObjectVessel 里指向 Wiki 的原名、以及新注释里引用旧写法),没有一处活的路径字面量;也确认没有 `EditorApplication.ExecuteMenuItem("Xeric Library/...")` 这类按字符串找回菜单的地方。安全性:`AddComponentMenu`/`MenuItem` 的路径不入场景、不入预制(只影响菜单显示),所以这次改名不会动他的资产;**代价是旧的菜单路径没了**——他若把某个子菜单拖进过快捷栏/记过路径,需要按新根重找一次。编译门三臂 + 3 对照绿(`chain_paths.txt`)。
|
注册路径根改名:`Xeric Library` → `XericLibrary`(2026-10-26 他点名两处"`Table/Table Editor OverrideLayer`"和"`UI/Image/场景变形手柄`"的族前缀带了空格):他在两个具体组件上看到的只是症状,根因在唯一那份总表——`XericRegistrationPaths.Root`(`Runtime/Core/XericRegistrationPaths.cs`)写的是带空格的 `"Xeric Library"`,而**所有族常量都是它拼出来的**(Chart/Table/UI/Layout/Form/翻页/…),所以改了根就一次性把整个包的菜单与组件路径统一成 `XericLibrary/...`。改动是**一个常量加一行注释**,不散落:全仓 `grep "Xeric Library"` 只剩两处**散文**(ObjectVessel 里指向 Wiki 的原名、以及新注释里引用旧写法),没有一处活的路径字面量;也确认没有 `EditorApplication.ExecuteMenuItem("Xeric Library/...")` 这类按字符串找回菜单的地方。安全性:`AddComponentMenu`/`MenuItem` 的路径不入场景、不入预制(只影响菜单显示),所以这次改名不会动他的资产;**代价是旧的菜单路径没了**——他若把某个子菜单拖进过快捷栏/记过路径,需要按新根重找一次。编译门三臂 + 3 对照绿(`chain_paths.txt`)。
|
||||||
|
新增「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
|
||||||
|
|
||||||
## [0.1.6] - 2026-07-01
|
## [0.1.6] - 2026-07-01
|
||||||
|
|
||||||
|
|||||||
@@ -61,4 +61,51 @@ public class MeasuringPointPageManager : FlipPageComponentManager
|
|||||||
}
|
}
|
||||||
|
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Shader 烘焙(Bake Shader As Image)
|
||||||
|
|
||||||
|
把 shader 离屏渲染成贴图,用来在场景或界面里当贴图 / Sprite 使用。
|
||||||
|
|
||||||
|
入口:`XericLibrary/Tool/Bake Shader As Image`
|
||||||
|
|
||||||
|
### 输入源
|
||||||
|
|
||||||
|
- **Shader**:按该 shader 造一张临时材质,属性表里改的就是这张副本,关掉窗口即丢。
|
||||||
|
- **Material**:复制一份材质再编辑,原资产不会被写脏;要落盘按「写回原材质」,否则按「丢弃改动」回到来源参数。
|
||||||
|
|
||||||
|
两者只能有一个,切换时另一个会被清空。属性表按 shader 声明的类型铺行(Range 滑块、Float / Int、`[Toggle]` 关键字、`[Enum]`、Color、Vector、贴图),每次刷新都会把值原样写回材质并同步关键字状态。
|
||||||
|
|
||||||
|
### 输出
|
||||||
|
|
||||||
|
尺寸预设或自定义、MSAA、HDR、sRGB 存储、翻转 Y、Pass 下标、背景色。导出支持 PNG / JPG / TGA / EXR,以及直接生成 Sprite 资产。
|
||||||
|
|
||||||
|
### 面片与 UV
|
||||||
|
|
||||||
|
Quad 网格里每一格对应一段 UV 区域,格号(UV X / Y)就是这段区域原点的整数部分;加行加列会按贴边那一格往外推算编号,「恢复 1×1」回到单片。也可以切到外部网格,把模型的某一层按平面投影烘出来。
|
||||||
|
|
||||||
|
- 「框住面片」把整个网格铺满输出,「选中格铺满」只框当前选中的那一格;
|
||||||
|
- 输出比例与面片比例不一致时按**内容比例**拉伸铺满,不留白边——一格就是一张图;
|
||||||
|
- 预览图上会叠分格线与每格 UV 编号,点选格子时右侧的 UV X / Y 跟着换。
|
||||||
|
|
||||||
|
### 实时预览与测试视图
|
||||||
|
|
||||||
|
工具栏「实时预览」打开后按编辑器心跳重画(聚焦 60fps、失焦 20fps);关掉时参数改动只记成「待刷新」,写在「重新渲染」按钮上。
|
||||||
|
|
||||||
|
「测试视图」提供四种不依赖材质内容的探针图,用同一套面片 / 相机 / pass 重画:
|
||||||
|
|
||||||
|
- **UV**:红 = U、绿 = V,左下角纯黑即这一格的 UV 原点;
|
||||||
|
- **梯度**:灰度尺,用来量这一格占了画面多大;
|
||||||
|
- **棋盘**:方块变长条说明横竖缩放不等,变平行四边形说明斜切或透视;
|
||||||
|
- **纯色**:内置 `Unlit/Color` 画一张纯色面片,画得出来就说明管线是通的,问题在被测 shader 自己。
|
||||||
|
|
||||||
|
重复次数大于 1 时,UV 视图里一格仍是一条连续递增的尺子,整数 UV 处保留一条分界线,方便数这一格跨了几个 UV 单位。
|
||||||
|
|
||||||
|
### 全局参数
|
||||||
|
|
||||||
|
引擎在相机流程里才会写入的全局量(光照方向、环境光、反射探针等)在离屏路径里默认缺失。可在「全局参数」里扫描 shader 实际用到的条目,勾选后在渲染前注入、渲染后立即还原。
|
||||||
|
|
||||||
|
### 已知限制
|
||||||
|
|
||||||
|
- 属性表不列 `[HideInInspector]` 与 `[PerRendererData]` 属性,后者由渲染器逐实例提供,离屏渲染没有对应实例。
|
||||||
|
- 离屏渲染不跑引擎的相机流程,依赖 `_CameraDepthTexture`、屏幕空间后处理等相机内部数据的 shader 可能烘不出预期结果。
|
||||||
|
|||||||
Reference in New Issue
Block a user