《游戏编辑器技术原理与架构》14.3 流式区块
几 GB 的大地形不能整块进内存。本节实现 StreamingStore——把资产切成区块,register 登记、load 加载并 touch 最近使用、LRU 逐出腾内存;6 条用例本机真跑,钉住「加载可读、未加载 null、未登记忽略、LRU 逐出、touch 保活、计数」六条流式语义。
category
几 GB 的大地形不能整块进内存。本节实现 StreamingStore——把资产切成区块,register 登记、load 加载并 touch 最近使用、LRU 逐出腾内存;6 条用例本机真跑,钉住「加载可读、未加载 null、未登记忽略、LRU 逐出、touch 保活、计数」六条流式语义。
视图模型把文档状态投影成视图可渲染的结构,可测性的前提是确定性:同一输入必得同一输出、投影不改输入、输出不可变。DeterministicViewModel 把投影约束成纯函数——输入深度冻结、输出深度冻结、same() 递归相等判定。投影不可测,往往因为偷偷改输入或依赖外部状态;冻结把这类副作用当场暴露。6 条用例本机真跑。
子编辑器各自维护脏状态:改动标记、撤销栈、保存、依赖失效。本节实现状态创建、脏标记、撤销/保存与依赖变更检测。6 条用例钉住脏标记与撤销恢复。对标 Unity 的资产脏标记与 Unreal 的资产编辑状态。
编辑器的后台任务要排优先级、限并发、能取消。本节实现 TaskScheduler——submit 按优先级降序入队、drain 按并发上限分批执行、cancel 跳过任务;6 条用例本机真跑,钉住「优先级、并发上限、取消、全跑、pending、空队」六条调度语义。
大资产的导入不能卡编辑器。本节实现 AsyncImporter——把导入描述成带依赖的任务图,runAll 按拓扑序逐个 await(依赖先导入),失败重试一次后计入 failed;6 条用例本机真跑,钉住「拓扑顺序、失败重试、环不挂、全完成、只导已登记、空任务」六条导入语义。
各子编辑器共享一个宿主:面板注册、按类型取面板、重复注册覆盖。本节实现 EditorHost 的面板注册与查询。6 条用例钉住注册覆盖与类型索引。对标 Unity 的 EditorWindow 注册与 Unreal 的 Tab Manager。
编辑器操作 = 命令(改文档状态),测一串操作的效果 = 重放命令序列并断言中间状态。ReplayRunner 把记录、重放、断言做成一体的容器:每 push 一步立即执行并记录该步状态,stateAt(i) 取第 i 步断言。回放即断言——同一序列必得同一状态序列。6 条用例本机真跑。
大关卡要拆子场景:一个子场景多处复用、整体实例化、展开成扁平对象。本节实现子场景实例化、扁平展开、按模板统计与包围盒计算。6 条用例钉住实例数与展开结果。对标 Unity 的 Scene asset 与 Prefab 嵌套。
游戏运行在独立进程时,编辑器与子进程通过心跳判断存活——心跳超时表示会话暂时无法确认响应,编辑器要感知而不是挂死。PIEController 记录心跳时刻,isAlive(now, timeout) 在超时窗口内判定存活;模式(in-editor / separate-process)决定共享策略,切换重置心跳。6 条用例本机真跑,对标 UE 的多进程 PIE。
两个人改了同一份文本,合并 = base + ours + theirs。本节实现 mergeLines 三路合并——逐行判六态:都没改保留、一方改用其、双方改成相同无冲突、不同或删改冲突并打标记;6 条用例本机真跑,钉住「单方改、同改、异改冲突、独立区、原样、删行」六条合并语义。
只读的资产不能被随手改坏:VCS 集成的第一道门是「状态门」。本节实现 CheckoutManager——未跟踪自由写、已跟踪只读、checkout 放行可写、commit 收回只读;6 条用例本机真跑,钉住「未跟踪可写、跟踪只读、检出可写、未跟踪拒检、提交回锁、非检出拒提」六条状态语义。
Play 模式要能暂停:暂停后模拟不再自动推进,但可手动单步。PauseStepper 维护暂停状态——pause 冻结自动推进、step 手动推进一格、resume 恢复;SnapshotStore 保存/恢复模拟快照——单步几步不满意,restore 回到暂停点。暂停与快照配合,才谈得上可控的 Play。6 条用例本机真跑。
关卡编辑是摆对象:按网格放置、贴地吸附、旋转取整、成行摆放。本节实现网格放置、表面贴合、旋转取整、行列摆放与局部转世界。6 条用例钉住放置与对齐结果。对标 Unity 的 GridSnap 与 Blender 的摆放工具。
VCS 要回答「这个文本文件改了什么」。本节实现 TextDiff——用 LCS 把两段文本逐行对齐,产出 add/del/same 三态序列与变更块(hunk);6 条用例本机真跑,钉住「全增、全删、相同、单行改、插入、hunk 合并」六条 diff 语义。
进入 Play 时,编辑器和运行时共享部分数据(关卡配置),但运行时要改的游戏状态必须拷贝——改运行态不污染编辑态。IsolationPolicy 显式声明每个字段的归属:shared 共享引用、copied 深拷贝;splitCopy 沿策略切分,边界是声明的而非手写。6 条用例本机真跑,对标 Unity 的 play mode 隔离。
UI 编辑器用锚点定位控件:锚点定义控件相对父容器的位置,拉伸与居中两种模式。本节实现锚点矩形、拉伸/居中锚点、归一化转像素与等比适配。6 条用例钉住锚点布局与 letterbox。对标 Unity 的 RectTransform 与 Unreal UMG Anchor。
特效要放进场景:实例化、逐帧更新、主动停止。本节实现特效实例的创建、更新、数量查询与停止。6 条用例钉住实例生命周期。对标 Unity 的 Prefab 实例化与 Unreal 的 FX 场景放置。
Outliner、Profiler、层级面板这类工具窗口是单例:同一工具只允许一个窗口存在。ToolWindowManager 的 open 对已开窗口返回 'reused'——复用现有窗口并把焦点带过去,而不是再开一个;未注册工具拒绝打开;openCount 让「开了几个工具窗口」可见。6 条用例本机真跑。
LOD 是「距离远就少画三角形」:构建时按比例砍面片生成多档模型,运行时按相机距离切换。本节实现 LodGroup——build 生成 1.0→0.5→0.25 的 LOD 链、pick 按距离阈值选档;6 条用例本机真跑,钉住「递减链、面数不为 0、近距原始档、跨阈升档、最远档、零面退化」六条 LOD 语义。
预览特效前先算预算:粒子数、每帧成本、性能档位。本节实现粒子估算、预算检查、单帧成本与档位推荐。6 条用例钉住预算超限与档位选择。对标 Unity 的 Particle 性能预算与 Unreal FX 预算。