# VERTICAL SLICE - NOT FOR PRODUCTION # 布局几何断言探针(现行事实源=tools/probe_gate.sh 默认段;呈现层三区布局的分辨率维度验收) # 用途:battle.md §验收「1280×800 与 16:9 全屏下三区无遮挡/无重叠/无裁切」的可执行化 # GDD 锚:design/gdd/ux/battle.md §Layout Zones(B/C/D 三区几何) # 硬约束:档位表是数据、断言是一份函数据——加档只改表不动断言(禁每档建一个探针) extends Node const ProbeUiUtil := preload("res://probe/probe_ui_util.gd") # 隔离样板单点 const BoardViewScript := preload("res://presentation/views/board_view.gd") # 算式单点静态调用载体(迭代 46 卡C) # 分辨率档位表(逻辑视口尺寸;数据侧——增删档位只改这里,断言代码零改动) const VIEWPORTS := [ {"label": "基座 1280x800", "size": Vector2i(1280, 800)}, {"label": "16:9 全屏 1920x1080", "size": Vector2i(1920, 1080)}, ] var _problems: PackedStringArray = [] var _cell_reads: Dictionary = {} # 逐档格边长实读留痕(label→cell_size;PASS 行引基座值) var _est_reads: Dictionary = {} # 逐档 13/14 板推定读数留痕(label→{13,14,avail};PASS 后打印对拍) func _ready() -> void: await get_tree().process_frame var main: Node = load("res://presentation/main.tscn").instantiate() add_child(main) await get_tree().process_frame ProbeUiUtil.isolate_save(main, "smoke_layout_probe", true, false, true) main.ui.modals.debug_overlay.seed_edit.text = "42" # 种子钉死(确定性禁依赖默认随机分支) main._start_adventure_from_menu() for i in range(8): await get_tree().process_frame # 进战斗屏——三区(B 战斗画面/C 角色信息/D 扫雷图)同屏常驻,菜单屏不构成断言面 main.ui.modals.level_screen.press_candidate(0) for i in range(20): await get_tree().process_frame for vp in VIEWPORTS: # content_scale_size 是headless 下改逻辑视口的唯一有效入口(get_window().size # 在 headless 下不改变视口——用旧 API 会得到永远为真的假断言) get_tree().root.content_scale_size = vp["size"] for i in range(5): await get_tree().process_frame _check_one(vp["label"], main) # 复原本项目基座(探针不该把进程留在末档尺寸) get_tree().root.content_scale_size = Vector2i(1280, 800) if _problems.is_empty(): print("[layout_probe] PASS — %d 档几何不变量全过+格边长等价成立(基座实读 %.0fpx)〔格边长 V1〕" % [VIEWPORTS.size(), float(_cell_reads.get("基座 1280x800", -1.0))]) for label in _est_reads: var e: Dictionary = _est_reads[label] print("[layout_probe] [%s] 13 板推定 %dpx/14 板推定 %dpx(实板可用面积 %s)〔格边长 V4〕" % [label, int(e["13"]), int(e["14"]), str(e["avail"])]) get_tree().quit(0) else: for p in _problems: print("[layout_probe] FAIL — " + p) print("[layout_probe] FAIL — %d 项断言未过" % _problems.size()) get_tree().quit(1) # 一份不变量断言,逐档代入——代码量与档数无关 func _check_one(label: String, main: Node) -> void: var vr: Rect2 = get_viewport().get_visible_rect() if vr.size != Vector2(VIEWPORTS[0]["size"]) and vr.size.y < 1.0: _problems.append("[%s] 逻辑视口退化 %s" % [label, vr.size]) var rects := {} var battle_ui: Object = main.get("ui").battle # 注册面战区域容器(字段名与三区 key 同名——合同键即字段名) for key in ["stage", "info_panel", "board_zone"]: var ctl: Control = battle_ui.get(key) if ctl == null: _problems.append("[%s] %s = null(三区未装配)" % [label, key]) return var r := Rect2(ctl.global_position, ctl.size) rects[key] = r if r.size.x <= 0.0 or r.size.y <= 0.0: _problems.append("[%s] %s 零尺寸 %s" % [label, key, r.size]) elif not vr.encloses(r): _problems.append("[%s] %s 越视口 %s ⊄ %s" % [label, key, r, vr]) # 判据覆盖边界(如实记录,勿当已拦截):本探针按名点名三区做几何判定, # 不遍历战斗屏宿主的全部后代——「未登记兄弟控件」(如向装配器塞一个挂在 # battle_root 内层根下的全幅 ColorRect)这一缺陷类不在本探针拦截面内,探针对此仍全绿。 # 要拦它得改为递归遍历全子树找重叠,那是另一套判据(且极易误报容器父子关系), # 本探针不设此判据。 var bv: Control = main.ui.battle.board_zone.board_view if bv == null: _problems.append("[%s] board_view = null" % label) return var br := Rect2(bv.global_position, bv.size) if not vr.encloses(br): _problems.append("[%s] board_view 越视口 %s ⊄ %s" % [label, br, vr]) if rects.has("board_zone") and not rects["board_zone"].encloses(br): _problems.append("[%s] board_view 越出 board_zone(%s ⊄ %s)" % [label, br, rects["board_zone"]]) var keys := rects.keys() for i in range(keys.size()): for j in range(i + 1, keys.size()): if rects[keys[i]].intersects(rects[keys[j]]): _problems.append("[%s] 顶层区重叠 %s×%s(%s ∩ %s)" % [label, keys[i], keys[j], rects[keys[i]], rects[keys[j]]]) var cell: float = main.ui.battle.board_zone.board_view.get("cell_size") _cell_reads[label] = cell # 格边长接线守卫——判据=等价(生产写入值与单点算式严格相等,生产接线断开即红; # 全仓禁任何人造格边长可读阈值)。 # 板型 N 无公开出口→`bv.get("_board")` 内部字段直查=受控例外(改动—验收对照表行 1 注明理由)。 var b = bv.get("_board") if b == null: _problems.append("[%s] _board 为 null(板型 N 无从取值,等价断言无依据)〔格边长 V1〕" % label) elif cell != float(BoardViewScript._cell_for(maxi(int(b.width), int(b.height)), bv.size)): _problems.append("[%s] 格边长等价破——生产写入 %.1fpx ≠ _cell_for(n=%d, avail=%s) 返回 %.1fpx(实板可用面积 %s)〔格边长 V1〕" % [label, cell, maxi(int(b.width), int(b.height)), str(bv.size), float(BoardViewScript._cell_for(maxi(int(b.width), int(b.height)), bv.size)), str(bv.size)]) # 最大板推定留痕(迭代 46 卡C T2——实板可用面积代入 13/14 板型求算式单点,读数打印不作判红: # 锚点=用户验收的现行渲染值;对拍归实现报告,对拍不一致=卡 §9 L3 #2 呈报,禁实现侧改锚; # 零尺寸前置=可用面积不可信时推定无依据) if bv.size.x <= 0.0 or bv.size.y <= 0.0: _problems.append("[%s] board_view 零尺寸(可用面积不可信,格边长推定无依据)〔格边长 V4〕" % label) else: _est_reads[label] = { "13": BoardViewScript._cell_for(13, bv.size), "14": BoardViewScript._cell_for(14, bv.size), "avail": str(bv.size), }