二七王：回退自造的图集叠绘，改用平台既有 SpriteManager.setNumberImage

方案作废并纠正认知：多帧图片精灵【不是】只能显示一位数——SpriteManager 第 1154 行
早有 setNumberImage(spriteId, text, charWidth)：把整串文本设给一个多帧图片精灵，
引擎按字符逐帧渲染，精灵宽度按「字符数 × charWidth」自动调整。bc75e40 造的
drawImageRegion + NumberRenderer 是重复轮子，本次整体回退（revert bc75e40）。

- 回退：删除 gameabc-framework/ui/NumberRenderer.js 与其单测，SpriteManager 与
  index.html 恢复到改动前（与 bc75e40^ 逐字节一致）。
- ImageResources.js：数字类资源改为 16 帧、固定帧序 0123456789.+-x/p，逐条写明
  各帧含义、第16帧后缀（选主张数=「张」；结算/叫分的后缀标注待美术与规则确认，未瞎填）、
  单字符宽高与整图尺寸（16 × 单字宽），并说明帧序不可重排、不可省略占位。
- LayoutConstants.js：NUM_STYLE 改为 setNumberImage 所需的 res/charWidth/charHeight/suffix。
- Layout_Action.js：两个数字节点 h 取 charHeight（SSOT），w 留运行时注入
  （宽度由 setNumberImage 按字符数自动改，随位数变）。
- Sprites_Action.js / Sprites_Result.js：注释改为 setNumberImage 用法；
  结算玩家栏 ACC_TPL_SCORE_NUM 是复制精灵也能用（该接口不依赖绘制回调）。
- test_constants.js：NUM_STYLE 守卫改为校验 charWidth/charHeight/suffix 与
  「h 同源、w 运行时注入」；suffix 限定为 setNumberImage 支持的 分/倍/张。
- 文档：清单 §1.3/§1.5/§3.6/§5.4/§6.8 与前端 02 的那一节全部按 setNumberImage 重写，
  三种机制改为「文字精灵 / setFrame 切帧 / setNumberImage」，并记下这次误判作为反例。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

This commit is contained in:

joywayer

2026-08-27 00:07:35 +08:00

co-authored by

Claude Opus 5

parent dbdd6607d7

commit 35ee85e1d6

12 changed files with 174 additions and 712 deletions

									
										client/index.html
									
		-2
	
												View File
												
				@@ -191,8 +191,6 @@

				<!-- 通用战绩页组件（依赖 DynamicSpriteList/SpriteEventController/SpriteManager，均已在前加载） -->

				<script type="text/javascript" src="js/gameabc-framework/ui/RecordViewDefaultConfig.js"></script>

				<script type="text/javascript" src="js/gameabc-framework/ui/RecordView.js"></script>

				<!-- 图集叠绘数字（一个精灵画多位美术字；依赖 SpriteManager/SpriteEventController，均已在前加载） -->

				<script type="text/javascript" src="js/gameabc-framework/ui/NumberRenderer.js"></script>