求解器(ui/LayoutSolver.js): - 按方向校验 anchor:竖排只收 top/bottom/center、横排只收 left/right/center, 未知 direction 一并拒绝。框架 AlignmentUtils 的 switch 对写错方向的 anchor 落到 default(居中),笔误会被静默吞掉——ROOM_CATEGORY_COLUMN 就是这么把前两行摆到画布外的。 - grid 校验合并 ctx 后的 cols/rows 必须是数字:缺 rows 时 capacity=NaN 让超载守卫失效、 循环一次不跑,静默返回空数组(一个矩形都不产出)。 - line/fan/grid 要求 anchorX/anchorY 必须是数字(框架的 anchorY||0 会把缺失变成 0); point 要求 x/y 必须是数字。 - apply() 精灵数与矩形数不等时抛错,不再静默截断:截断会让多余精灵停在上一手牌的旧坐标上。 - 统一运行时注入:ctx 里的 INJECT_KEYS(target/x/y/w/h/anchorX/anchorY/rows/ itemWidth/itemHeight)覆盖配置同名字段,优先级 ctx > bySeat > base。 - line + items 竖排显式拒绝(只实现了水平)。 配置: - ROOM_CATEGORY_COLUMN anchor 由 'left' 改为 'top'(竖排语义)。 - ROOM_OPTION_OVERFLOW_GRID 补 rows(runtime)、槽尺寸与 anchor 沿用 ROOM_OPTION_ROW, cols 直接引用 ROOM_OPTION_MAX_PER_ROW;ROOM_OPTION_ROW 补上注释里已声明的 itemHeight。 - 所有依赖运行时注入的节点加 runtime 声明,所有 attach 节点加 targetKind (sprite / layout / platform),显式区分「忘了写」与「故意延后到运行时」。 守卫(tests/test_constants.js): - 求解冒烟改为只对 runtime 声明过的键注入假值,没声明却缺字段的照常抛错变红。 - 补矩形数量断言(line/fan/grid 按项数、point/attach 恒 1)——此前只查数组与坐标类型, 空数组照样通过,「少画了几张牌」对守卫完全不可见。 - attach.target 改为只在 targetKind 指定的那一个命名空间里校验存在。 - 补 runtime 声明自身的合法性检查与布局节点总数(62)钉死。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
146 lines
6.8 KiB
JavaScript
146 lines
6.8 KiB
JavaScript
///////////////////////////////////////////////////////////////
|
||
////////// EQW_Layout: 常驻区 + 玩家位(清单 §6.5 / §6.6)//////
|
||
///////////////////////////////////////////////////////////////
|
||
// 【纯数据文件】无函数、无副作用;依赖 LayoutConstants.js 先加载
|
||
// (引用其 EQW_Layout.TEXT_STYLE.*,属 EQW_Layout 内部自引用)。
|
||
var EQW_Layout = EQW_Layout || {};
|
||
|
||
//===== 常驻区(清单 §6.5)=====
|
||
|
||
//顶部信息条底
|
||
EQW_Layout.TOP_INFO_BG = { kind: 'point', x: 486, y: 4, w: 276, h: 68 };
|
||
|
||
//顶部 · 花色图标:贴信息条内部左下角(资源 SUIT_ICON_S 30×30,清单 §3)
|
||
EQW_Layout.TOP_SUIT_ICON = {
|
||
kind: 'attach', targetKind: 'layout', target: 'TOP_INFO_BG',
|
||
hAlign: 'left', vAlign: 'bottom', offsetX: 20, offsetY: -8, w: 30, h: 30
|
||
};
|
||
|
||
//顶部 · 叫分数值文字 / 抓分数值文字:【清单 §6.5 未给出位置】——那张表只列了两个角标底与角标
|
||
//文字,而角标底又必须贴在这两段数值文字身上。此处显式占位:坐标与宽高全部标为运行时注入,
|
||
//由调用方按信息条内的三列表格实际排布给出;设计稿补齐后把 x/y/w/h 回填成固定值即可。
|
||
//显式占位是为了避免 C 阶段在渲染代码里就地硬编码一组坐标——那样这两处位置就再也无从统一修改
|
||
EQW_Layout.TOP_CALL_TEXT = { kind: 'point', runtime: ['x', 'y', 'w', 'h'] };
|
||
EQW_Layout.TOP_GRADE_TEXT = { kind: 'point', runtime: ['x', 'y', 'w', 'h'] };
|
||
|
||
//顶部 · 叫分角标底:贴叫分数值文字右上角(资源 BADGE_MULTIPLE 帧1 34×18)。
|
||
//角标数值文字复用同一矩形,不单独配置(清单未给独立位置,下同)
|
||
EQW_Layout.TOP_CALL_BADGE_BG = {
|
||
kind: 'attach', targetKind: 'layout', target: 'TOP_CALL_TEXT',
|
||
corner: 'topRight', offsetX: 4, offsetY: 6, w: 34, h: 18
|
||
};
|
||
|
||
//顶部 · 抓分角标底:贴抓分数值文字右上角(资源 BADGE_MULTIPLE 帧2 34×18)
|
||
EQW_Layout.TOP_GRADE_BADGE_BG = {
|
||
kind: 'attach', targetKind: 'layout', target: 'TOP_GRADE_TEXT',
|
||
corner: 'topRight', offsetX: 4, offsetY: 6, w: 34, h: 18
|
||
};
|
||
|
||
//亮牌信息条
|
||
EQW_Layout.LIANGPAI_BG = { kind: 'point', x: 35, y: 400, w: 210, h: 35 };
|
||
|
||
//底栏条
|
||
EQW_Layout.FOOTER_BG = { kind: 'point', x: 0, y: 648, w: 1280, h: 72 };
|
||
|
||
//底栏 · 局数文字「1/4 局」
|
||
EQW_Layout.FOOTER_ASET_TEXT = {
|
||
kind: 'point', x: 635, y: 672, w: 65, h: 26, textStyle: EQW_Layout.TEXT_STYLE.ASET_COUNT
|
||
};
|
||
|
||
//底栏 · 功能钮组(明牌/已出牌/上一轮/底牌):逐项不等宽(清单 §6.1 T-25)
|
||
EQW_Layout.FOOTER_FUNC_BUTTONS = {
|
||
kind: 'line', direction: 'horizontal', anchorX: 1250, anchorY: 672,
|
||
itemHeight: 30, spacing: 15, anchor: 'right',
|
||
items: [
|
||
{ key: 'BTN_MINGPAI', width: 74 },
|
||
{ key: 'BTN_HISTORY', width: 87 },
|
||
{ key: 'BTN_LAST_ROUND', width: 93 },
|
||
{ key: 'BTN_BOTTOM_CARDS', width: 78 }
|
||
]
|
||
};
|
||
|
||
//底栏 · 提示按钮组(踩/有分/没分):count 由运行时同时可见的按钮数给出,不进配置
|
||
EQW_Layout.FOOTER_TISHI_BUTTONS = {
|
||
kind: 'line', direction: 'horizontal', anchorX: 335, anchorY: 672,
|
||
itemWidth: 52, itemHeight: 30, spacing: 26, anchor: 'left'
|
||
};
|
||
|
||
//右侧语音钮(平台):坐标仅登记供 01_SubGame_modify.js 配置区人工同步核对(清单 §6.11 同类处理)
|
||
EQW_Layout.VOICE_BTN_REF = { kind: 'point', x: 1210, y: 310, w: 56, h: 56 };
|
||
|
||
//右侧聊天钮(平台):同上
|
||
EQW_Layout.CHAT_BTN_REF = { kind: 'point', x: 1210, y: 385, w: 56, h: 56 };
|
||
|
||
//===== 玩家位(清单 §6.6)=====
|
||
|
||
//头像框(平台提供):仅登记坐标供 attach 参考与 Game_Modify.PLAYER_INFO_LAYOUT 人工同步(清单 §6.11)。
|
||
//SELF 尺寸与 LEFT/RIGHT 不同(84×53 vs 91×118),bySeat 内单独覆盖 w/h
|
||
EQW_Layout.PLAYER_AVATAR_FRAME_REF = {
|
||
kind: 'point', w: 91, h: 118,
|
||
bySeat: {
|
||
LEFT: { x: 22, y: 122 },
|
||
RIGHT: { x: 1160, y: 122 },
|
||
SELF: { x: 22, y: 645, w: 84, h: 53 }
|
||
}
|
||
};
|
||
|
||
//『庄』印章:三家各一个精灵(P_LEFT_BANKER / P_RIGHT_BANKER / P_SELF_BANKER),按 bySeat 求位置。
|
||
//LEFT/RIGHT 贴平台头像框外角;SELF 为底栏固定点(与清单 §6.5「底栏·庄标」同一元素,此处合并,避免重复定义)。
|
||
//注意:base 的 kind 是 attach,SELF 变体里【有意】把 kind 覆盖为 point——EQW_LayoutSolver._mergeBySeat
|
||
//会合并包括 kind 在内的所有字段,这里利用该机制表达「底栏庄标是固定坐标、不贴附任何目标」,
|
||
//与 LEFT/RIGHT 两个上家贴头像框(attach)是不同的定位方式,不是笔误
|
||
EQW_Layout.P_BANKER_MARK = {
|
||
kind: 'attach', targetKind: 'platform', w: 40, h: 40,
|
||
bySeat: {
|
||
LEFT: { target: 'P_LEFT_AVATAR', corner: 'topRight', offsetX: 7, offsetY: 8 },
|
||
RIGHT: { target: 'P_RIGHT_AVATAR', corner: 'topLeft', offsetX: -40, offsetY: 8 },
|
||
SELF: { kind: 'point', x: 338, y: 668, w: 32, h: 34 }
|
||
}
|
||
};
|
||
|
||
//『主N』角标底:仅左右两家(自己主/对数已在手牌区可见,无此角标)。w/h 为清单 §6.6 实测值
|
||
EQW_Layout.P_ZHU_BADGE = {
|
||
kind: 'attach', targetKind: 'platform', corner: 'bottomLeft', offsetX: 0, offsetY: 6, w: 40, h: 19,
|
||
bySeat: {
|
||
LEFT: { target: 'P_LEFT_AVATAR' },
|
||
RIGHT: { target: 'P_RIGHT_AVATAR' }
|
||
}
|
||
};
|
||
|
||
//『对N』角标底:贴主N角标右侧。w/h 清单未重复给出,沿用主N角标同尺寸
|
||
//(同资源 BADGE_ZHU_PAIR 的另一帧,帧1黄底=主N、帧2白底=对N,尺寸一致)
|
||
EQW_Layout.P_PAIR_BADGE = {
|
||
kind: 'attach', targetKind: 'layout', target: 'P_ZHU_BADGE', hAlign: 'right', vAlign: 'middle',
|
||
offsetX: 44, offsetY: 0, w: 40, h: 19
|
||
};
|
||
|
||
//状态文字「60分」/「不叫」:仅左右两家(自己此阶段无独立文字区,见清单 §6.6 表)
|
||
EQW_Layout.P_STATUS_TEXT = {
|
||
kind: 'point', w: 130, h: 70, textStyle: EQW_Layout.TEXT_STYLE.STATUS_BIG,
|
||
bySeat: {
|
||
LEFT: { x: 170, y: 165 },
|
||
RIGHT: { x: 980, y: 165 }
|
||
}
|
||
};
|
||
|
||
//倒计时:三家都有
|
||
EQW_Layout.P_COUNTDOWN = {
|
||
kind: 'point', w: 75, h: 70,
|
||
bySeat: {
|
||
LEFT: { x: 195, y: 165 },
|
||
RIGHT: { x: 1010, y: 165 },
|
||
SELF: { x: 445, y: 345 }
|
||
}
|
||
};
|
||
|
||
//提示气泡(踩/没分/有分):朝向 arrowRight 是配置项,不按座位硬判(清单 §6.6)。
|
||
//w/h 清单 §3 标『待定』,此处用示意尺寸占位,资源定稿后回填(不影响 kind/字段结构)
|
||
EQW_Layout.TISHI_BUBBLE = {
|
||
kind: 'attach', targetKind: 'platform', w: 96, h: 44,
|
||
bySeat: {
|
||
LEFT: { target: 'P_LEFT_AVATAR', hAlign: 'right', vAlign: 'middle', offsetX: 10, arrowRight: false },
|
||
RIGHT: { target: 'P_RIGHT_AVATAR', hAlign: 'left', vAlign: 'middle', offsetX: -10, arrowRight: true },
|
||
SELF: { target: 'P_SELF_AVATAR', hAlign: 'right', vAlign: 'top', offsetX: 10, offsetY: -70, arrowRight: false }
|
||
}
|
||
};
|