《游戏编辑器技术原理与架构》5.1 Inspector 的数据模型与嵌套数组
Inspector 显示选中对象的属性,深层结构要支持:嵌套对象、数组增删、资源引用 picker 与枚举校验。本节实现行构建、资源引用格式化/校验、枚举合法性与数组插入删除。6 条用例钉住嵌套行、引用校验与数组操作。对标 Unity Inspector 与 Unreal Details Panel。
category
Inspector 显示选中对象的属性,深层结构要支持:嵌套对象、数组增删、资源引用 picker 与枚举校验。本节实现行构建、资源引用格式化/校验、枚举合法性与数组插入删除。6 条用例钉住嵌套行、引用校验与数组操作。对标 Unity Inspector 与 Unreal Details Panel。
glTF 是 JSON 结构 + 二进制 buffer 的组合:JSON 描述节点树、网格、场景。本节实现 parseGltf——吃 JSON 结构层(scene/nodes/meshes/primitives),校验 asset.version、缺省字段归一;6 条用例本机真跑,钉住「节点树与引用、primitive 属性槽、非法文档返回 null」三条结构解析不变量。
多选后一键对齐或分布:左对齐、居中对齐、均匀分布、约束拖拽方向与平面。本节实现对齐计算、均匀分布、方向约束与平面约束。6 条用例钉住对齐值、分布间距与约束过滤。对标 Unity 的 Editor 对齐工具与 Blender 的 Align 工具。
一张图集 = 一堆小图塞进一个大矩形。本节用最朴素的 shelf 算法实现 AtlasPacker——按高度降序排、同一行从左到右放、放不下换行、单边超限拒绝;6 条用例本机真跑,钉住「矩形不重叠、换行 y 递增、超限被拒」三条打包不变量。
「删除」在有节点选中时可用、没选中时灰掉;「移动」要带 dx/dy 参数。本节实现 ContextCommandRouter:enabled(ctx) 决定上下文可用性、resolveTarget(ctx) 决定作用对象、参数在执行前校验必填与类型;7 条用例本机真跑,覆盖选中节点/资产/空选择三种上下文与参数默认值。
命令表有了,入口长什么样?本节实现 MenuBar:按菜单路径逐层构建嵌套菜单、keymap 收集全部快捷键到命令 id 的映射、快捷键全局唯一冲突拒绝;6 条用例本机真跑,钉住路径约定(顶层菜单 + 子菜单链)、嵌套构建与同菜单去重。
同一张 png,是 UI 贴图还是法线贴图,导入结果天差地别。本节实现 TextureSettings——wrap/filter/mipmaps/srgb/maxSize 五要素,textureSettingsFrom 从 meta 构建(合并 + 校验,非法值回落默认),maxSize 归一为 2 的幂;6 条用例本机真跑,钉住「非法枚举回落、非正尺寸回落默认」两条净化语义。
同样的拖拽在不同坐标系/枢轴下行为不同。本节实现世界/局部坐标系转换、枢轴模式(中心/对象)与数值吸附。6 条用例钉住吸附取整、坐标轴转换与枢轴定位。对标 Unity 的 Pivot/Center、Global/Local 与 Snapping。
不加载全图就拿到宽高与通道——头解析是图像导入的第一课。本节手写 PNG 签名 + IHDR、JPEG SOI + SOF 的字节级解析,把两种格式收敛成统一 ImageInfo(宽高、通道、归一格式 rgba8/rgb8/luminance8);6 条用例本机真跑,钉住「非法数据返回 null 不崩溃、签名后非 IHDR 判无效」两条健壮性。
菜单、工具栏、快捷键、脚本宏——编辑器里每一种操作入口,最终都必须落到同一个 execute。本节实现 CommandTable:命令注册、按 id 路由执行、enabled 上下文校验、快捷键全局唯一;6 条用例本机真跑,钉住「未知命令给明确原因、禁用命令被拒绝」两条失败路径。
选中对象后视口出现三套手柄:平移、旋转、缩放。本节实现 Transform 结构、三手柄的拾取与拖拽数学。6 条用例钉住平移/缩放手柄的拾取与拖拽、旋转手柄。对标 Unity 的 Transform Gizmo 与 Unreal 的 Move/Rotate/Scale 工具。
编辑器里要同时看清被遮挡物与半透明物:背面排序、遮挡判定与混合。本节实现 back-to-front 排序、遮挡判定、alpha 裁剪与前景混合。6 条用例钉住排序、遮挡与混合结果。对标 Unity 的 transparency sorting 与渲染队列。
比较编辑器公开机制与 helio 教学模型,说明示例分类及其验证边界。
内置导入器只覆盖主流格式,第三方要为自家格式接入。本节实现 PluginRegistry——插件声明 extensions + 可选 supports 谓词 + 优先级,route 找到扩展名匹配且 supports 通过的最高优先级插件;id 全局唯一,重复注册拒绝;6 条用例本机真跑,钉住「supports 过滤、id 唯一」两条插件语义。
视口网格给编辑者空间参照,吸附把摆放规整到网格。本节实现网格线生成、吸附、自适应步长与对齐参考线。6 条用例钉住线数、吸附值与参考线判定。对标 Unity 的网格与吸附、Blender 的 snap 与参考线。
一次导入不是一步:读源、预处理、转换、后处理、写缓存。本节实现 ImportPipeline——把导入拆成有序阶段、阶段间用 context.scratch 传数据、任一阶段失败整条流水线停止并报告失败在哪一阶段;6 条用例本机真跑,钉住「阶段保序、失败点名、后续不跑」三条编排语义。
编辑器的窗口布局是一棵树:split 节点带方向与比例、tab 节点叠放窗口、window 叶节点绑定窗口 id。本节实现 DockLayout:把叶窗口拆成带方向的 split、把整棵布局序列化成 JSON 持久化、从 JSON 恢复并校验重复 id;6 条用例本机真跑,为工作区记忆、崩溃恢复与多显示器布局定下格式。
选中对象要有反馈,工业级做法是屏幕空间描边或几何描边。本节实现描边参数生成、边缘判定与世界空间半宽换算。6 条用例钉住参数构造、宽度换算与边缘判定。对标 Unity 的 outline 与 Blender 的 Solidify 轮廓。
每种资产类型有自己的导入器。本节实现 ImporterRegistry——导入器声明处理的扩展名与优先级,注册表按扩展名路由分发、同扩展名多导入器取优先级最高者(内置可被插件覆盖);normalizeExt 大小写归一;6 条用例本机真跑,钉住「优先级覆盖、无匹配给 null」两条分发语义。
编辑器 UI 该每帧重建还是持有节点树?本节用一个「文本输入框」剖开两种范式:即时模式无状态、每帧从应用数据重建 UI,输入框文本必须寄放回应用状态;保留模式节点树跨帧存活,文本缓冲直接挂在节点上。7 条用例真跑对比两种模式各自把状态放在哪里,为 helio 编辑器 UI 定下基调。