// NumberRenderer.layout:图集叠绘的逐字符矩形计算(纯函数,唯一可脱离引擎单测的部分) const { load, throws } = require('./_load'); const t = require('./_assert')(); load('client/js/gameabc-framework/ui/NumberRenderer.js'); // 基准样式:单字 30×40、无间距、绘制区宽 100 function style(over) { const s = { imageId: 635, charWidth: 30, charHeight: 40, spacing: 0, align: 'left', width: 100 }; Object.keys(over || {}).forEach(k => { s[k] = over[k]; }); return s; } // 只取关心的字段,断言更可读 const brief = items => items.map(i => ({ c: i.char, srcX: i.srcX, destX: i.destX })); // ---- 正面:多位数逐位裁源矩形,第 idx 格 = (idx*charWidth, 0, charWidth, charHeight) ---- const two = NumberRenderer.layout(70, style()); t.eq('两位数:字符数', two.length, 2); t.eq('两位数:逐位源/目标 x', brief(two), [ { c: '7', srcX: 210, destX: 0 }, { c: '0', srcX: 0, destX: 30 } ]); t.eq('两位数:源矩形完整字段', two[0], { char: '7', index: 7, srcX: 210, srcY: 0, srcW: 30, srcH: 40, destX: 0, destY: 0, destW: 30, destH: 40 }); // ---- 正面:单位数 ---- t.eq('单位数', brief(NumberRenderer.layout(5, style())), [{ c: '5', srcX: 150, destX: 0 }]); // ---- 正面:字符串入参与数字入参等价 ---- t.eq('字符串入参等价', brief(NumberRenderer.layout('70', style())), brief(two)); // ---- 正面:四位数(结算得分级别) ---- t.eq('四位数', brief(NumberRenderer.layout(1234, style({ width: 200 }))), [ { c: '1', srcX: 30, destX: 0 }, { c: '2', srcX: 60, destX: 30 }, { c: '3', srcX: 90, destX: 60 }, { c: '4', srcX: 120, destX: 90 } ]); // ---- 正面:负号 → 默认映射索引 11;正号 → 10 ---- t.eq('负号', brief(NumberRenderer.layout('-5', style())), [ { c: '-', srcX: 330, destX: 0 }, { c: '5', srcX: 150, destX: 30 } ]); t.eq('正号', brief(NumberRenderer.layout('+18', style())), [ { c: '+', srcX: 300, destX: 0 }, { c: '1', srcX: 30, destX: 30 }, { c: '8', srcX: 240, destX: 60 } ]); // ---- 正面:三种对齐(总宽 = 2*30 + 1*0 = 60,绘制区宽 100)---- t.eq('align left 起始 x', NumberRenderer.layout(70, style({ align: 'left' }))[0].destX, 0); t.eq('align center 起始 x', NumberRenderer.layout(70, style({ align: 'center' }))[0].destX, 20); t.eq('align right 起始 x', NumberRenderer.layout(70, style({ align: 'right' }))[0].destX, 40); // ---- 边界:绘制区恰好等于总宽时,三种对齐结果一致 ---- t.eq('绘制区等于总宽时 center 起始 x', NumberRenderer.layout(70, style({ align: 'center', width: 60 }))[0].destX, 0); t.eq('绘制区等于总宽时 right 起始 x', NumberRenderer.layout(70, style({ align: 'right', width: 60 }))[0].destX, 0); // ---- 边界:内容超出绘制区时不裁剪,center/right 起始 x 为负(由调用方自行调宽)---- t.eq('超宽 center 起始 x 为负', NumberRenderer.layout(1234, style({ align: 'center' }))[0].destX, -10); // ---- 边界:字间距为负(字符重叠)---- t.eq('负字间距(重叠 6px)', brief(NumberRenderer.layout(123, style({ spacing: -6 }))), [ { c: '1', srcX: 30, destX: 0 }, { c: '2', srcX: 60, destX: 24 }, { c: '3', srcX: 90, destX: 48 } ]); // 负间距下总宽 = 3*30 + 2*(-6) = 78,居中起始 x = (100-78)/2 = 11 t.eq('负字间距 + center', NumberRenderer.layout(123, style({ spacing: -6, align: 'center' }))[0].destX, 11); // ---- 边界:正字间距 ---- t.eq('正字间距 4px', brief(NumberRenderer.layout(12, style({ spacing: 4 }))), [ { c: '1', srcX: 30, destX: 0 }, { c: '2', srcX: 60, destX: 34 } ]); // ---- 边界:空值不产生任何字符 ---- t.eq('null 值', NumberRenderer.layout(null, style()), []); t.eq('undefined 值', NumberRenderer.layout(undefined, style()), []); t.eq('空串', NumberRenderer.layout('', style()), []); t.eq('数值 0 照常显示(不被当空值)', brief(NumberRenderer.layout(0, style())), [{ c: '0', srcX: 0, destX: 0 }]); // ---- 正面:charMap 可整体覆盖默认映射(图集排列不同的数字图)---- const zhMap = { '0': 0, '1': 1, '2': 2, '张': 3 }; t.eq('自定义 charMap', brief(NumberRenderer.layout('12张', style({ charMap: zhMap }))), [ { c: '1', srcX: 30, destX: 0 }, { c: '2', srcX: 60, destX: 30 }, { c: '张', srcX: 90, destX: 60 } ]); // 覆盖是整体替换:默认的 '-' 在自定义表里没有 → 抛错,不回退到默认表 t.eq('charMap 是整体覆盖而非合并', throws(() => NumberRenderer.layout('-1', style({ charMap: zhMap }))), true); // ---- 反面:映射不到的字符必须显式抛错,不静默跳过 ---- t.eq('字母抛错', throws(() => NumberRenderer.layout('7A', style())), true); t.eq('小数点抛错(默认图集没有这一格)', throws(() => NumberRenderer.layout('1.5', style())), true); t.eq('中文抛错', throws(() => NumberRenderer.layout('5分', style())), true); t.eq('空格抛错', throws(() => NumberRenderer.layout('7 0', style())), true); // 抛错而不是返回残缺结果:错误信息要点名是哪个字符 let msg = ''; try { NumberRenderer.layout('7A', style()); } catch (e) { msg = e.message; } t.eq('错误信息含出问题的字符', msg.indexOf('"A"') >= 0, true); // ---- 反面:样式非法一律抛错(显式失败优于隐式兜底)---- t.eq('style 缺失抛错', throws(() => NumberRenderer.layout(70, null)), true); t.eq('imageId 非正数抛错', throws(() => NumberRenderer.layout(70, style({ imageId: 0 }))), true); t.eq('charWidth 非正数抛错', throws(() => NumberRenderer.layout(70, style({ charWidth: 0 }))), true); t.eq('charHeight 缺失抛错', throws(() => NumberRenderer.layout(70, style({ charHeight: undefined }))), true); t.eq('width 缺失抛错', throws(() => NumberRenderer.layout(70, style({ width: undefined }))), true); t.eq('align 非法抛错', throws(() => NumberRenderer.layout(70, style({ align: 'middle' }))), true); t.eq('align 缺失抛错', throws(() => NumberRenderer.layout(70, style({ align: undefined }))), true); t.eq('spacing 非数字抛错', throws(() => NumberRenderer.layout(70, style({ spacing: '0' }))), true); t.eq('charMap 非对象抛错', throws(() => NumberRenderer.layout(70, style({ charMap: 'x' }))), true); // spacing 省略时按 0 处理(唯一的可选项) t.eq('spacing 省略 = 0', NumberRenderer.layout(70, style({ spacing: undefined }))[1].destX, 30); // ---- 默认映射本身:0–9 连续,+/- 接在后面 ---- t.eq('默认映射 0-9 连续', [0, 1, 2, 3, 4, 5, 6, 7, 8, 9].map(n => NumberRenderer.DEFAULT_CHAR_MAP[String(n)]), [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]); t.eq('默认映射 + 为 10', NumberRenderer.DEFAULT_CHAR_MAP['+'], 10); t.eq('默认映射 - 为 11', NumberRenderer.DEFAULT_CHAR_MAP['-'], 11); // ---- 子游戏的 5 套数字样式都能通过校验,且各自的典型值画得下 ---- load('client/js/01_SubGame/codes/config/ImageResources.js'); load('client/js/01_SubGame/codes/config/LayoutConstants.js'); const CASES = { COUNTDOWN: '15', // 倒计时秒数,最多两位 RESULT_WIN: '+1234', // 带符号四位 RESULT_LOSE: '-1234', CALL_SCORE: '70', // 叫分档位最大值 MAIN_SUIT_COUNT: '26' // 两副牌单花色最多 26 张 }; const styleProblems = []; Object.keys(CASES).forEach(key => { const st = EQW_Layout.NUM_STYLE[key]; if (!st) { styleProblems.push(key + ' 缺样式'); return; } if (!EQW_Images.hasOwnProperty(st.res)) { styleProblems.push(key + ' 的资源键不存在: ' + st.res); return; } // 用真实资源 ID 组出完整 style(业务代码也是这么组的:纯数据配置只存资源键名) const real = { imageId: EQW_Images[st.res], charWidth: st.charWidth, charHeight: st.charHeight, spacing: st.spacing, align: st.align, width: st.width }; let items; try { items = NumberRenderer.layout(CASES[key], real); } catch (e) { styleProblems.push(key + ' -> ' + e.message); return; } if (items.length !== CASES[key].length) { styleProblems.push(key + ' 字符数不对'); return; } // 典型最长值必须画得进绘制区(否则 width 配小了,画面会溢出到精灵外) const right = items[items.length - 1].destX + items[items.length - 1].destW; if (items[0].destX < 0 || right > st.width) { styleProblems.push(key + ' 典型最长值 "' + CASES[key] + '" 超出绘制区 width=' + st.width + '(实际 ' + items[0].destX + '..' + right + ')'); } }); if (styleProblems.length) { console.log('数字样式问题:\n ' + styleProblems.join('\n ')); } t.eq('5 套数字样式合法且典型最长值画得下', styleProblems, []); t.eq('数字样式恰好 5 套', Object.keys(EQW_Layout.NUM_STYLE).sort(), Object.keys(CASES).sort()); process.exit(t.done('numberrenderer') ? 0 : 1);