二七王：前端精灵结构常量

照清单 §5.1–§5.8 逐条录入，键名与 ID 原样照抄；省略写法（如「结构同 202」）全部展开写全。每个精灵注明类型/用途/资源键/帧说明，后期照此在编辑器里创建。按协调方中途下达的结构变更，Group 与其名下精灵合并为 group 容器（groupName: { id: 群组常量, 精灵键: 精灵ID, ... }）。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-26 20:53:35 +08:00
parent 8b579896b2
commit 488f36b545
5 changed files with 705 additions and 0 deletions
@@ -0,0 +1,113 @@
+///////////////////////////////////////////////////////////////
+////////// EQW_Sprites: 精灵结构（清单 §5.1 牌桌常驻）/////////
+///////////////////////////////////////////////////////////////
+// 子游戏精灵段 1001–2999（段内仅 3000 被平台占用）。
+// 以 UI View 为组织单位：View 下 Layer（或 Layer1/Layer2…）为图层声明，
+// 其余键一律是「group 容器」——容器内 id 为群组 ID、其余键才是精灵 id。
+// 每个精灵注明：类型（图片/文字）+ 用途 + 资源键 + 帧说明——
+// 后期即照这些注释在编辑器里逐个创建。
+var EQW_Sprites = EQW_Sprites || {};
+
+//顶部信息条：主 / 叫分 / 抓分 三列（清单 §5.1 群组 201）
+EQW_Sprites.TopInfoView = {
+    Layer: EQW_Layers.TABLE_STATIC,     //101
+
+    TopInfo: {
+        id: EQW_Groups.TOP_INFO,        //201
+
+        TOP_INFO_BG:          1001,   //图片：三列表格底，资源 EQW_Images.PANEL_TOP_INFO
+        TOP_SUIT_ICON:        1002,   //图片：「主」列花色图标，资源 EQW_Images.SUIT_ICON_S，帧 = flower（1方块 2梅花 3红心 4黑桃，服务端 flower 编号）
+        TOP_CALL_TEXT:        1003,   //文字：叫分数值
+        TOP_CALL_BADGE_BG:    1004,   //图片：叫分角标底，资源 EQW_Images.BADGE_MULTIPLE 帧1（蓝底）
+        TOP_CALL_BADGE_TEXT:  1005,   //文字：「N子」
+        TOP_GRADE_TEXT:       1006,   //文字：抓分数值
+        TOP_GRADE_BADGE_BG:   1007,   //图片：抓分角标底，资源 EQW_Images.BADGE_MULTIPLE 帧2（橙底）
+        TOP_GRADE_BADGE_TEXT: 1008    //文字：「N倍」，取 Math.abs(curmultiple)（T-16/S-8：curmultiple 带符号，展示取绝对值）
+    }
+};
+
+//三家玩家位附加标记：庄印章 + 主N/对N 角标 + 状态文字，跨三个群组
+//（头像框本身是平台提供，登记见本文件末尾 EQW_PlatformSprites；本 View 的精灵全部 attach 到平台头像框上，见清单 §6.6）
+EQW_Sprites.PlayerMarkView = {
+    Layer: EQW_Layers.TABLE_STATIC,     //101
+
+    LeftMark: {
+        id: EQW_Groups.P_LEFT_MARK,     //202 左上家
+
+        P_LEFT_BANKER:     1100,   //图片：「庄」印章，资源 EQW_Images.MARK_BANKER，attach 头像框 topRight
+        P_LEFT_ZHU_BG:     1101,   //图片：「主N」角标底，资源 EQW_Images.BADGE_ZHU_PAIR 帧1（黄底），attach 头像框 bottomLeft
+        P_LEFT_ZHU_TEXT:   1102,   //文字：剩余主牌数
+        P_LEFT_PAIR_BG:    1103,   //图片：「对N」角标底，资源 EQW_Images.BADGE_ZHU_PAIR 帧2（白底），attach 主N角标右侧
+        P_LEFT_PAIR_TEXT:  1104,   //文字：剩余主对数
+        P_LEFT_STATUS_TEXT: 1105   //文字：「60分」/「不叫」
+    },
+
+    RightMark: {
+        id: EQW_Groups.P_RIGHT_MARK,    //203 右上家，结构同 202
+
+        P_RIGHT_BANKER:     1110,  //图片：「庄」印章，资源 EQW_Images.MARK_BANKER，attach 头像框 topLeft
+        P_RIGHT_ZHU_BG:     1111,  //图片：「主N」角标底，资源 EQW_Images.BADGE_ZHU_PAIR 帧1（黄底），attach 头像框 bottomLeft
+        P_RIGHT_ZHU_TEXT:   1112,  //文字：剩余主牌数
+        P_RIGHT_PAIR_BG:    1113,  //图片：「对N」角标底，资源 EQW_Images.BADGE_ZHU_PAIR 帧2（白底），attach 主N角标右侧
+        P_RIGHT_PAIR_TEXT:  1114,  //文字：剩余主对数
+        P_RIGHT_STATUS_TEXT: 1115  //文字：「60分」/「不叫」
+    },
+
+    SelfMark: {
+        id: EQW_Groups.P_SELF_MARK,     //204 自己，无主N/对N角标——自己主/对数已在手牌区可见
+
+        P_SELF_BANKER:      1120,  //图片：底栏「庄」印章，资源 EQW_Images.MARK_BANKER，point (338,668)
+        P_SELF_STATUS_TEXT: 1121   //文字：「50分」/「不叫」
+    }
+};
+
+//亮牌信息条（清单 §5.1 群组 206）
+EQW_Sprites.LiangPaiView = {
+    Layer: EQW_Layers.TABLE_STATIC,     //101
+
+    LiangPaiBar: {
+        id: EQW_Groups.LIANGPAI_BAR,    //206
+
+        LIANGPAI_BG:   1030,   //图片：半透圆角条，资源 EQW_Images.BAR_LIANGPAI
+        LIANGPAI_TEXT: 1031    //文字：亮牌统计文案
+    }
+};
+
+//底栏：局数 + 功能按钮（明牌/已出牌/上一轮/底牌）+ 提示按钮（清单 §5.1 群组 205）
+EQW_Sprites.FooterView = {
+    Layer: EQW_Layers.TABLE_STATIC,     //101
+
+    Footer: {
+        id: EQW_Groups.FOOTER,          //205
+
+        FOOTER_BG:              1040,   //图片：底栏深色条，资源 EQW_Images.BAR_FOOTER
+        FOOTER_ASET_TEXT:       1041,   //文字：「1/4 局」
+        BTN_MINGPAI:            1042,   //图片：「明牌」按钮，资源 EQW_Images.BTN_BOTTOM_FUNC
+        BTN_MINGPAI_TEXT:       1043,   //文字：按钮文案「明牌」
+        BTN_HISTORY:            1044,   //图片：「已出牌」按钮，资源 EQW_Images.BTN_BOTTOM_FUNC
+        BTN_HISTORY_TEXT:       1045,   //文字：按钮文案「已出牌」
+        BTN_LAST_ROUND:         1046,   //图片：「上一轮」按钮，资源 EQW_Images.BTN_BOTTOM_FUNC
+        BTN_LAST_ROUND_TEXT:    1047,   //文字：按钮文案「上一轮」
+        BTN_BOTTOM_CARDS:       1048,   //图片：「底牌」按钮，资源 EQW_Images.BTN_BOTTOM_FUNC
+        BTN_BOTTOM_CARDS_TEXT:  1049,   //文字：按钮文案「底牌」
+        BTN_TISHI_CAI:          1050,   //图片：「踩」按钮（闲家，占庄标区），资源 EQW_Images.BTN_TISHI
+        BTN_TISHI_CAI_TEXT:     1051,   //文字：「踩」
+        BTN_TISHI_HAS:          1052,   //图片：「有分」按钮，资源 EQW_Images.BTN_TISHI
+        BTN_TISHI_HAS_TEXT:     1053,   //文字：「有分」
+        BTN_TISHI_NONE:         1054,   //图片：「没分」按钮，资源 EQW_Images.BTN_TISHI
+        BTN_TISHI_NONE_TEXT:    1055    //文字：「没分」
+    }
+};
+
+///////////////////////////////////////////////////////////////
+////////// EQW_PlatformSprites: 平台提供精灵登记表 //////////////
+///////////////////////////////////////////////////////////////
+//平台提供的精灵，子游戏【不建】，仅登记 ID 供布局 attach 引用。
+//落在框架保留段 1–1000，故独立于 EQW_Sprites、不参与子游戏号段校验。
+//三人局座位映射（清单 §0.2）：ind0=南=自己 ind1=东=右上家 ind3=西=左上家；
+//头像框基址 376+ind（清单 §6.6）。
+var EQW_PlatformSprites = EQW_PlatformSprites || {
+    P_SELF_AVATAR:  376,   //平台头像框 376+ind0，自己（南）
+    P_RIGHT_AVATAR: 377,   //平台头像框 376+ind1，右上家（东）
+    P_LEFT_AVATAR:  379    //平台头像框 376+ind3，左上家（西）
+};