Files
XericUIActionVessel/Editor/ShaderBake/BakeShaderWindow.uxml
T
lrss3 632197b50e feat(ShaderBake): 不透明覆盖率读数、管线自检与贴图 ST 归位
"画面是棋盘格"这件事有两种完全不同的成因——什么都没画出来,和画出来但 alpha 为 0,
以前只能靠猜。现在:
- 每次渲染后降采样测一次不透明占比,写进预览读数和状态栏;
- 「管线自检」用 Unlit/Color 按同一套面片/相机/pass 再画一次,把问题分到管线还是被测 shader;
- 脚本造的临时材质里 Tiling 为 0 的贴图属性会被归位为 1(那等于把四个顶点 UV 乘成同一个点),
  并在属性表提示还有几张贴图没指定。
2026-11-06 08:19:46 +08:00

240 lines
17 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<ui:UXML xmlns:ui="UnityEngine.UIElements" xmlns:x="UnityEditor.UIElements" xmlns:xer="XericUI.ShaderBake.Editor">
<!--
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 name="face-overlay" class="face-overlay">
<ui:Label name="face-overlay-label" class="face-overlay-label" text="UV (0,0)" />
</ui:VisualElement>
</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:DropdownField name="out-preset" label="预设" class="field-half" />
<ui:Button name="out-fit-aspect" text="匹配面片比例" class="field-half" />
</ui:VisualElement>
<ui:VisualElement class="field-row">
<xer:IntegerField name="out-width" label="宽" class="field-half" />
<xer:IntegerField name="out-height" label="高" class="field-half" />
</ui:VisualElement>
<ui:VisualElement class="field-row">
<xer:IntegerField name="out-depth" label="深度" class="field-half" />
<ui:DropdownField name="out-msaa" label="采样" class="field-half" />
</ui:VisualElement>
<xer: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="翻转 Y" 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">
<xer:EnumField name="surf-kind" label="种类" class="field-full" />
<ui:VisualElement class="field-row">
<xer:FloatField name="surf-size-x" label="宽" class="field-half" />
<xer:FloatField name="surf-size-y" label="高" class="field-half" />
</ui:VisualElement>
<ui:VisualElement class="field-row">
<xer:IntegerField name="surf-seg-x" label="细分X" class="field-half" />
<xer:IntegerField name="surf-seg-y" label="细分Y" class="field-half" />
</ui:VisualElement>
<ui:Label class="field-note" text="面片网格(一格一张 UV 区域,向左/下扩展编号递减)" />
<ui:Label name="grid-info" class="field-note" text="1 × 1" />
<ui:VisualElement class="field-row">
<ui:Button name="grid-left" text="←加列" class="field-quarter" />
<ui:Button name="grid-right" text="加列→" class="field-quarter" />
<ui:Button name="grid-down" text="↓加行" class="field-quarter" />
<ui:Button name="grid-up" text="↑加行" class="field-quarter" />
</ui:VisualElement>
<ui:VisualElement class="field-row">
<ui:Button name="grid-reset" text="恢复 1×1" class="field-half" />
<ui:Button name="face-zero" text="选中面归零" class="field-half" />
</ui:VisualElement>
<ui:Label name="face-info" class="field-note" text="在左侧浏览图里点选面片" />
<ui:VisualElement class="field-row">
<xer:IntegerField name="face-uv-x" label="UV X" class="field-half" />
<xer:IntegerField name="face-uv-y" label="UV Y" class="field-half" />
</ui:VisualElement>
<ui:Label class="field-note" text="UV" />
<ui:VisualElement class="field-row">
<xer:FloatField name="surf-uv-off-x" label="偏移X" class="field-half" />
<xer:FloatField name="surf-uv-off-y" label="偏移Y" class="field-half" />
</ui:VisualElement>
<ui:VisualElement class="field-row">
<xer:FloatField name="surf-uv-tile-x" label="重复X" class="field-half" />
<xer:FloatField name="surf-uv-tile-y" label="重复Y" class="field-half" />
</ui:VisualElement>
<ui:Label class="field-note" text="面片变换" />
<ui:VisualElement class="field-row">
<xer:FloatField name="surf-pos-x" label="X" class="field-third" />
<xer:FloatField name="surf-pos-y" label="Y" class="field-third" />
<xer:FloatField name="surf-pos-z" label="Z" class="field-third" />
</ui:VisualElement>
<ui:VisualElement class="field-row">
<xer:FloatField name="surf-rot-x" label="X" class="field-third" />
<xer:FloatField name="surf-rot-y" label="Y" class="field-third" />
<xer:FloatField name="surf-rot-z" label="Z" class="field-third" />
</ui:VisualElement>
<ui:VisualElement class="field-row">
<xer:FloatField name="surf-scale-x" label="X" class="field-third" />
<xer:FloatField name="surf-scale-y" label="Y" class="field-third" />
<xer: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" />
<xer: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="写 _MainTex_ST" class="field-toggle" />
<ui:Toggle name="surf-double-sided" label="双面绘制" 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" />
<xer:FloatField name="cam-ortho-size" label="正交半高" class="field-full" />
<xer:FloatField name="cam-fov" label="视野角" class="field-full" />
<ui:VisualElement class="field-row">
<xer:FloatField name="cam-near" label="近" class="field-half" />
<xer:FloatField name="cam-far" label="远" class="field-half" />
</ui:VisualElement>
<ui:Label class="field-note" text="位置" />
<ui:VisualElement class="field-row">
<xer:FloatField name="cam-pos-x" label="X" class="field-third" />
<xer:FloatField name="cam-pos-y" label="Y" class="field-third" />
<xer:FloatField name="cam-pos-z" label="Z" class="field-third" />
</ui:VisualElement>
<ui:Label class="field-note" text="旋转(欧拉角)" />
<ui:VisualElement class="field-row">
<xer:FloatField name="cam-rot-x" label="X" class="field-third" />
<xer:FloatField name="cam-rot-y" label="Y" class="field-third" />
<xer:FloatField name="cam-rot-z" label="Z" class="field-third" />
</ui:VisualElement>
<ui:VisualElement class="field-row">
<ui:Button name="cam-fit" text="框住面片" class="field-half" />
<ui:Button name="cam-selftest" text="管线自检" class="field-half" />
</ui:VisualElement>
<ui:Label name="selftest-note" class="field-note"
text="自检:用不依赖贴图与光照的内置纯色 shader 按同一套矩阵画一次,用来分清是渲染管线的问题还是被测 shader 本身的问题" />
</ui:VisualElement>
</ui:VisualElement>
<!-- 全局参数:离屏渲染没有相机流程,光照/环境这类引擎全局量要自己补 -->
<ui:VisualElement name="sec-globals" class="section">
<ui:Toggle name="sec-globals-head" label="全局参数(光照 / 环境)" value="false" class="section-head" />
<ui:VisualElement name="sec-globals-body" class="section-body">
<ui:Label name="globals-note" class="field-note"
text="引擎在相机流程里才写入的全局量(光照方向、环境光、反射探针)这里默认缺失;勾选的条目在渲染时注入,渲染完立即还原" />
<ui:VisualElement class="field-row">
<ui:Button name="globals-detect" text="扫描 Shader" class="field-half" />
<ui:Button name="globals-presets" text="加入常用预设" class="field-half" />
</ui:VisualElement>
<ui:VisualElement name="globals-rows" class="props-rows" />
</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>