《游戏编辑器技术原理与架构》2.3 框选与选择集合
鼠标拖出矩形框选一批对象:框内对象全选、排除忽略对象。本节实现矩形构造、包含判定、框选筛选与选择集合的选择/取消/全选。6 条用例钉住矩形包含、排除与集合语义。对标 Unity 的框选与 Blender 的 Box Select。
category
鼠标拖出矩形框选一批对象:框内对象全选、排除忽略对象。本节实现矩形构造、包含判定、框选筛选与选择集合的选择/取消/全选。6 条用例钉住矩形包含、排除与集合语义。对标 Unity 的框选与 Blender 的 Box Select。
资产数据库不靠用户点刷新,也不靠轮询——它监听文件系统。但底层事件又碎又密,一次保存能触发几十次 change。本节实现 FileWatcher:事件归一成 change/add/remove 三态、防抖窗口内同路径合并以最后一次为准、订阅可取消;6 条用例本机真跑,钉住「同路径合并、不同路径保留」两条防抖语义。
比较编辑器公开机制与 helio 教学模型,说明示例分类及其验证边界。
全量重扫是 N 次哈希 + N 次重导入,太贵。本节实现 AssetDatabase——记住上次扫描的快照,本次扫描与快照比对,只挑出三类差异:added(新增)、modified(内容变了需重导入)、removed(消失);needsReimport 只含前两类;6 条用例本机真跑,钉住「无变化差异全空、删除不触发重导入」两条增量语义。
排序算出来了,怎么执行?本节把拓扑序变成四阶段生命周期:init/start 按拓扑序推进、stop/shutdown 逆序收尾,并支持运行期热装卸——新模块被已运行模块依赖时拒绝装载、仍被依赖的模块拒绝卸载;7 条用例本机真跑,对照 UE 模块的会话级加载与 Unity 整域重载。
把每个对象的稳定 ID 编码成颜色,一帧渲染后在帧缓冲里按像素读回,命中查询退化成一次取像素。本节实现 encodeId/decodeId 双射与 IdBuffer 的写入、读回、解码。6 条用例钉住编码可逆、颜色分配与通道精度。对标 Unity 的 Gizmo 拾取缓冲与 Blender 的对象索引渲染。
资产数据库的第一步是把磁盘变成一张表。本节实现扫描器——scan 扫目录里的文件、fnv1a 给每个文件算 32 位内容哈希、toSourceAsset 复用 1.1 的类型推断产出 SourceAsset,并按路径建索引;6 条用例本机真跑,钉住「内容一个字节变化哈希即不同、mtime 不影响哈希」两条信号源不变量。
编辑器不是一坨可执行文件,是一堆互相声明的模块。本节从一张模块注册表开始:每个模块声明依赖谁,用 Kahn 算法把模块排成可启动的线性顺序,依赖环被检出并返回环成员,仍被依赖的模块不允许卸载;6 条用例本机真跑,对照 Unreal 的 Build.cs 依赖声明与 Unity 的 asmdef 程序集引用。
把屏幕坐标反投影成世界射线,再与世界中的球体、AABB 求交。本节实现 screenRay 反投影、raySphere/rayAABB 求交、pickNearest 取最近命中、pointAt 取射线上的点。6 条用例钉住反投影、命中判定与最近命中。对标 Unity 的 Raycast 与 Unreal 的 FHitResult。
卷三收口:把 14 章的核心能力固化成可断言清单。本节实现能力清单、冒烟验证与按章排序。6 条用例钉住清单完整、章节覆盖与验证通过。收口的意义:能力可枚举,才算真收口。
卷二《资产管线》收口:把 14 章的核心能力固化成一份可断言清单——每章恰好一项能力,含名称、章节号与验证状态。verifyAsset() 做冒烟验证:清单完整(14 项)、每项 verified、章节号连续覆盖 1..14。回顾的意义:能力可枚举,才算真收口。6 条用例本机真跑。
卷一收口:把 14 章的核心能力固化成一份可断言清单——每章恰好一项能力,含名称、章节号与验证状态。verifyCore() 做冒烟验证:清单完整(14 项)、每项 verified、章节号连续覆盖 1..14。回顾的意义:能力可枚举,才算真收口。6 条用例本机真跑。
把「编辑操作 → 命令 → 文档变更 → 事件 → 视图投影刷新」串成闭环。SceneEditorSession.edit() 执行命令、成功后记历史并触发视图刷新,undo()/redo() 在历史间移动,viewRefreshCount() 让「视图同步」可断言。每次成功操作记录一次刷新通知。6 条用例本机真跑,对标 Unity 的 Edit Mode 循环。
用前 15 章的全部能力装配一个关卡工作流:放置地形、摆对象、配光照、存子场景。本节实现 LevelBuilder 的关卡构建流程。6 条用例钉住流程步骤与产物。对标 Unity 关卡制作流程与 Unreal 关卡设计。
把构建期模块串成一条导出链路。BuildExporter.export()——一批源资产按类型选格式与压缩(纹理走平台格式、音频走平台编码、数据走 zstd),模型可选 LOD 取最远档,产出交付物清单(路径/格式/体积/清单指纹);6 条用例本机真跑,钉住「纹理、音频、数据、LOD、非 LOD、汇总」六条导出语义。
把前面章节的子系统(资产数据库、导入器、依赖图、构建清单)装配成整体。AssetPipeline.boot() 按注册序启动、shutdown() 逆序停止、import() 写入资产目录并广播 asset.imported,importWithDeps 校验依赖先于被依赖;装配的正确性是「互相可达 + 生命周期成对 + 未就绪拒绝」。6 条用例本机真跑。
把前面章节的子系统(模块、事件总线、文档存储)装配成一个整体。EditorAssembly.boot() 按注册序启动模块、shutdown() 逆序停止、applyEdit() 改文档并广播 document.changed。装配的正确性是「子系统互相可达 + 生命周期成对」——boot 顺序与 shutdown 逆序对称,未装配的编辑被拒绝。6 条用例本机真跑。
把层级面板、视口、Gizmo 串成主循环:选择传播、悬停高亮、拖拽变换。本节实现 EditorLoop 的选择→高亮→拖拽闭环。6 条用例钉住选择同步与拖拽更新。对标 Unity 的编辑器主循环。
多个子编辑器同时显示预览,渲染器按需创建与共享:同渲染器复用通道、无消费者销毁。本节实现 PreviewChannelPool 的获取/释放与共享判定。6 条用例钉住复用与销毁。对标 Unity 的 Preview Renderer 与 Unreal 的缩略图渲染器。
把编辑器行为固化成快照基线,回归时重跑对比:新增标签 added、消失 removed、值改动 changed。SnapshotRecorder 按 label 收集,diffSnapshots 分三档报告差异,BaselineStore 序列化成 JSON——CI 里基线入库,回归跑完报告差异,人工只看 changed。6 条用例本机真跑,对标 Unity 的 test runner 回归模式。