Mobile HUD layout: disc widgets, quickslot wheel and belt (mobile step 4)

Native CDisc window for procedural round frames; ui_mobile_widgets
(RoundButton, QuickSlotDisc); HUD laid out as the phone plan: player
panel, top-right entry row with minimap, left button column, attack disc
with two quickslot rings, potion belt on quickslot page 4, exp bar. The
PC taskbar and its tooltips are hidden in mobile mode. Adds global
quickslot use/add/move for the belt.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
shenlei
2026-10-12 21:14:29 +09:00
co-authored by Claude Opus 5.5
parent b79fbce0b0
commit 11bd94d1ce
17 changed files with 968 additions and 397 deletions
+242 -185
View File
@@ -2,222 +2,279 @@
import ui
import grp
import player
import chr
import chrmgr
import net
import app
import wndMgr
import math
import ui_mobile_joystick
import ui_mobile_combat
import ui_mobile_drawer
import ui_mobile_widgets as widgets
import touch
import uiCharacter
def unsigned32(n):
return n & 0xFFFFFFFFL
class MobileHUD(ui.Window):
"""
ava2-client 移动端全屏战斗 HUD (完整集成版)
自适应 2376 x 1080 横屏规范
包含:
1. 左上角主角状态 HUD (圆形头像 + HP/MP/体力条)
2. 顶部悬浮目标血条 HUD (Monster Name, Level, HP Gauge)
3. 右上角导航快捷入口与小地图挂载抽屉 (MobileDrawer)
4. 底部药水/消耗品快捷轮盘 (Quick Belt)
5. 右下角核心战斗轮盘 (MobileCombatWheel: 大普攻 + 扇形技能槽)
6. 左下角虚拟摇杆触控层 (MobileJoystick)
"""
def __init__(self, interface=None):
ui.Window.__init__(self)
self.SetWindowName("MobileHUD")
self.interface = interface
"""
移动端战斗 HUD(docs/MOBILE-ARCHITECTURE.md 第 4 步),按安全区内缩:
1. 左上:头像圆框 + 名字等级 + HP/SP/体力条;原版 buff 图标(AffectShower)挪到其下方
2. 顶部居中:沿用原版目标栏 uiTarget.TargetBoard(本来就在顶部居中)
3. 右上:圆形入口按钮行 + 菜单面板(MobileDrawer);原版小地图挪到其下方
4. 左侧:竖排功能按钮(任务、技能、表情、聊天)
5. 右下:攻击键 + 当前快捷页 8 格(MobileCombatWheel)
6. 底部居中:药水栏 = 第 4 快捷页 8 格;最底一条经验条
7. 左下:浮动摇杆显示层(MobileJoystick)
移动模式下隐藏 PC 任务栏(AdoptDefaultWindows)。快捷栏数据与 PC 端完全相同。
"""
BELT_PAGE = 3
BELT_DIAMETER = 46
BELT_STEP = 50
SIDE_DIAMETER = 48
SIDE_STEP = 58
FACE_DIAMETER = 64
HP_WIDTH = 190
SP_WIDTH = 170
ST_WIDTH = 150
sw = wndMgr.GetScreenWidth()
sh = wndMgr.GetScreenHeight()
self.SetPosition(0, 0)
self.SetSize(sw, sh)
self.AddFlag("attach")
self.AddFlag("not_pick")
def __init__(self, interface=None):
ui.Window.__init__(self)
self.SetWindowName("MobileHUD")
self.interface = interface
self.safe_area = touch.GetSafeArea()
self.__BuildUI(sw, sh)
sw = wndMgr.GetScreenWidth()
sh = wndMgr.GetScreenHeight()
self.SetPosition(0, 0)
self.SetSize(sw, sh)
self.AddFlag("attach")
self.AddFlag("not_pick")
def __del__(self):
ui.Window.__del__(self)
self.safe_area = touch.GetSafeArea()
self.race = -1
self.lastBeltRefresh = 0
self.__BuildUI(sw, sh)
def __BuildUI(self, w, h):
# ---------------------------------------------------------------------
# 1. 左上角:主角状态 (Player HUD)
# ---------------------------------------------------------------------
self.player_hud = ui.Window()
self.player_hud.SetParent(self)
safe_l, safe_t, safe_r, safe_b = self.safe_area
self.player_hud.SetPosition(safe_l + 25, safe_t + 20)
self.player_hud.SetSize(320, 100)
self.player_hud.Show()
def __del__(self):
ui.Window.__del__(self)
# 头像框背景底板
self.avatar_bg = ui.Bar()
self.avatar_bg.SetParent(self.player_hud)
self.avatar_bg.SetPosition(0, 0)
self.avatar_bg.SetSize(72, 72)
self.avatar_bg.SetColor(grp.GenerateColor(0.15, 0.15, 0.22, 0.85))
self.avatar_bg.Show()
def __Container(self, x, y, w, h):
wnd = ui.Window()
wnd.SetParent(self)
wnd.AddFlag("not_pick")
wnd.SetPosition(x, y)
wnd.SetSize(w, h)
wnd.Show()
return wnd
# 角色名称
self.text_name = ui.TextLine()
self.text_name.SetParent(self.player_hud)
self.text_name.SetPosition(80, 2)
self.text_name.SetText("Player")
self.text_name.Show()
def __Gauge(self, parent, x, y, w, h, back, front):
bg = ui.Bar()
bg.SetParent(parent)
bg.AddFlag("not_pick")
bg.SetPosition(x, y)
bg.SetSize(w, h)
bg.SetColor(back)
bg.Show()
bar = ui.Bar()
bar.SetParent(parent)
bar.AddFlag("not_pick")
bar.SetPosition(x, y)
bar.SetSize(w, h)
bar.SetColor(front)
bar.Show()
frame = ui.Box()
frame.SetParent(parent)
frame.AddFlag("not_pick")
frame.SetPosition(x - 1, y - 1)
frame.SetSize(w + 2, h + 2)
frame.SetColor(grp.GenerateColor(0.55, 0.42, 0.25, 0.9))
frame.Show()
return bar
# HP 条背景与前景
self.hp_bar_bg = ui.Bar()
self.hp_bar_bg.SetParent(self.player_hud)
self.hp_bar_bg.SetPosition(80, 22)
self.hp_bar_bg.SetSize(210, 14)
self.hp_bar_bg.SetColor(grp.GenerateColor(0.2, 0.05, 0.05, 0.75))
self.hp_bar_bg.Show()
def __BuildUI(self, w, h):
safe_l, safe_t, safe_r, safe_b = self.safe_area
self.hp_bar = ui.Bar()
self.hp_bar.SetParent(self.player_hud)
self.hp_bar.SetPosition(80, 22)
self.hp_bar.SetSize(210, 14)
self.hp_bar.SetColor(grp.GenerateColor(0.85, 0.12, 0.12, 0.95))
self.hp_bar.Show()
# 1. 左上:主角状态
self.player_hud = self.__Container(safe_l + 12, safe_t + 8, 300, self.FACE_DIAMETER + 4)
self.face_disc = widgets.MakeDisc(self.player_hud, 0, 0, self.FACE_DIAMETER, widgets.STYLE_FRAME)
self.face_image = ui.ExpandedImageBox()
self.face_image.SetParent(self.player_hud)
self.face_image.AddFlag("not_pick")
# MP 条背景与前景
self.mp_bar_bg = ui.Bar()
self.mp_bar_bg.SetParent(self.player_hud)
self.mp_bar_bg.SetPosition(80, 40)
self.mp_bar_bg.SetSize(180, 10)
self.mp_bar_bg.SetColor(grp.GenerateColor(0.05, 0.1, 0.25, 0.75))
self.mp_bar_bg.Show()
self.text_name = ui.TextLine()
self.text_name.SetParent(self.player_hud)
self.text_name.AddFlag("not_pick")
self.text_name.SetPosition(self.FACE_DIAMETER + 8, 2)
self.text_name.SetOutline()
self.text_name.SetText("")
self.text_name.Show()
self.mp_bar = ui.Bar()
self.mp_bar.SetParent(self.player_hud)
self.mp_bar.SetPosition(80, 40)
self.mp_bar.SetSize(180, 10)
self.mp_bar.SetColor(grp.GenerateColor(0.15, 0.45, 0.95, 0.95))
self.mp_bar.Show()
gx = self.FACE_DIAMETER + 8
self.hp_bar = self.__Gauge(self.player_hud, gx, 22, self.HP_WIDTH, 12,
grp.GenerateColor(0.20, 0.05, 0.05, 0.75), grp.GenerateColor(0.85, 0.12, 0.12, 0.95))
self.mp_bar = self.__Gauge(self.player_hud, gx, 38, self.SP_WIDTH, 9,
grp.GenerateColor(0.05, 0.10, 0.25, 0.75), grp.GenerateColor(0.15, 0.45, 0.95, 0.95))
self.sp_bar = self.__Gauge(self.player_hud, gx, 51, self.ST_WIDTH, 5,
grp.GenerateColor(0.20, 0.18, 0.05, 0.75), grp.GenerateColor(0.90, 0.80, 0.10, 0.85))
# 体力/耐力条
self.sp_bar = ui.Bar()
self.sp_bar.SetParent(self.player_hud)
self.sp_bar.SetPosition(80, 54)
self.sp_bar.SetSize(150, 6)
self.sp_bar.SetColor(grp.GenerateColor(0.9, 0.8, 0.1, 0.85))
self.sp_bar.Show()
# 2. 右上:入口按钮行 + 菜单面板
self.drawer = ui_mobile_drawer.MobileDrawer(self.interface)
self.drawer.SetParent(self)
self.drawer.Show()
self.drawer.AttachPanel(self)
# ---------------------------------------------------------------------
# 2. 顶部居中:目标血条 (Target HUD)
# ---------------------------------------------------------------------
self.target_hud = ui.Window()
self.target_hud.SetParent(self)
self.target_hud.SetPosition((w - 420) / 2, safe_t + 20)
self.target_hud.SetSize(420, 50)
# 3. 左侧竖排按钮
side = [
("Quest", None, lambda: self.__ToggleCharacter("QUEST")),
("Skill", "d:/ymir work/ui/game/taskbar/mouse_button_skill_01.sub", lambda: self.__ToggleCharacter("SKILL")),
("Emote", None, lambda: self.__ToggleCharacter("EMOTICON")),
("Chat", "d:/ymir work/ui/game/taskbar/chat_button_01.sub", self.__ToggleChat),
]
self.side_buttons = []
top = safe_t + 8 + self.FACE_DIAMETER + 48
for i, (label, icon, event) in enumerate(side):
btn = widgets.RoundButton(self.SIDE_DIAMETER)
btn.SetParent(self)
btn.SetPosition(safe_l + 12, top + i * self.SIDE_STEP)
if not icon or not btn.SetIcon(icon):
btn.SetLabel(label)
btn.SetEvent(event)
btn.Show()
self.side_buttons.append(btn)
self.target_bg = ui.Bar()
self.target_bg.SetParent(self.target_hud)
self.target_bg.SetPosition(0, 18)
self.target_bg.SetSize(420, 16)
self.target_bg.SetColor(grp.GenerateColor(0.2, 0.05, 0.05, 0.75))
self.target_bg.Show()
# 4. 左下:摇杆显示层
self.joystick = ui_mobile_joystick.MobileJoystick(base_x=safe_l + 160, base_y=h - safe_b - 180)
self.joystick.SetParent(self)
self.joystick.Show()
self.target_bar = ui.Bar()
self.target_bar.SetParent(self.target_hud)
self.target_bar.SetPosition(0, 18)
self.target_bar.SetSize(420, 16)
self.target_bar.SetColor(grp.GenerateColor(0.9, 0.1, 0.1, 0.95))
self.target_bar.Show()
# 5. 右下:战斗轮盘
self.combat_wheel = ui_mobile_combat.MobileCombatWheel(origin_x=w - safe_r - 120, origin_y=h - safe_b - 120)
self.combat_wheel.SetParent(self)
self.combat_wheel.Show()
self.target_name = ui.TextLine()
self.target_name.SetParent(self.target_hud)
self.target_name.SetPosition(10, 0)
self.target_name.SetText("Target")
self.target_name.Show()
# 6. 底部:药水栏(第 4 快捷页)与经验条
count = 8
beltWidth = (count - 1) * self.BELT_STEP + self.BELT_DIAMETER
self.quick_belt = self.__Container((w - beltWidth) / 2, h - safe_b - self.BELT_DIAMETER - 10, beltWidth, self.BELT_DIAMETER)
self.quick_slots = []
for i in xrange(count):
slot = widgets.QuickSlotDisc(self.BELT_DIAMETER, globalIndex=self.BELT_PAGE * 8 + i)
slot.SetParent(self.quick_belt)
slot.SetPosition(i * self.BELT_STEP, 0)
slot.Show()
self.quick_slots.append(slot)
self.target_pct = ui.TextLine()
self.target_pct.SetParent(self.target_hud)
self.target_pct.SetPosition(370, 0)
self.target_pct.SetText("100%")
self.target_pct.Show()
self.target_hud.Hide()
self.exp_width = w - safe_l - safe_r
self.exp_bar = self.__Gauge(self, safe_l, h - safe_b - 4, self.exp_width, 3,
grp.GenerateColor(0.05, 0.05, 0.05, 0.6), grp.GenerateColor(0.85, 0.70, 0.25, 0.9))
# ---------------------------------------------------------------------
# 3. 右上角:系统抽屉菜单与导航 (Mobile Drawer)
# ---------------------------------------------------------------------
self.drawer = ui_mobile_drawer.MobileDrawer(self.interface)
self.drawer.SetParent(self)
self.drawer.Show()
def __ToggleCharacter(self, state):
if self.interface:
self.interface.ToggleCharacterWindow(state)
# ---------------------------------------------------------------------
# 4. 左下角:虚拟摇杆 (Mobile Joystick)
# ---------------------------------------------------------------------
self.joystick = ui_mobile_joystick.MobileJoystick(base_x=160, base_y=h - 180)
self.joystick.SetParent(self)
self.joystick.Show()
def __ToggleChat(self):
if self.interface:
self.interface.ToggleChat()
# ---------------------------------------------------------------------
# 5. 右下角:核心战斗轮盘 (Mobile Combat Wheel)
# ---------------------------------------------------------------------
self.combat_wheel = ui_mobile_combat.MobileCombatWheel(origin_x=w - safe_r - 120, origin_y=h - safe_b - 120)
self.combat_wheel.SetParent(self)
self.combat_wheel.Show()
# 由 interfaceModule.ShowDefaultWindows / ShowAllWindows 调用:PC 任务栏隐藏,
# 小地图挪到右上入口行下面,聊天窗抬到药水栏上方。
def AdoptDefaultWindows(self):
interface = self.interface
if not interface:
return
safe_l, safe_t, safe_r, safe_b = self.safe_area
sw = wndMgr.GetScreenWidth()
sh = wndMgr.GetScreenHeight()
for name in ("wndTaskBar", "wndExpandedTaskBar", "wndEnergyBar", "wndExpandedMoneyTaskBar"):
wnd = getattr(interface, name, None)
if wnd:
wnd.Hide()
minimap = getattr(interface, "wndMiniMap", None)
if minimap:
minimap.SetPosition(sw - safe_r - minimap.GetWidth(), safe_t + 8 + self.drawer.GetRowHeight() + 4)
# 任务栏的 HP/SP/经验悬浮提示是独立 TOP_MOST 窗口,平时由任务栏 OnUpdate 隐藏;
# 任务栏不显示时它们会一直挂在最后的鼠标位置
taskbar = getattr(interface, "wndTaskBar", None)
for name in ("tooltipHP", "tooltipSP", "tooltipST", "tooltipEXP", "tooltipGift"):
tip = getattr(taskbar, name, None)
if tip:
tip.Hide()
self.__AdoptGameButtons(getattr(interface, "wndGameButton", None))
chat = getattr(interface, "wndChat", None)
if chat:
chat.SetPosition(sw / 2 - chat.CHAT_WINDOW_WIDTH / 2, sh - safe_b - chat.EDIT_LINE_HEIGHT - self.BELT_DIAMETER - 24)
# ---------------------------------------------------------------------
# 6. 底部居中:药水快捷滑盘 (Quick Belt)
# ---------------------------------------------------------------------
self.quick_belt = ui.Window()
self.quick_belt.SetParent(self)
self.quick_belt.SetPosition((w - 360) / 2, h - safe_b - 70)
self.quick_belt.SetSize(360, 60)
self.quick_belt.Show()
# 由 game.GameWindow 调用(活动图标创建之后):原版 buff 图标放在头像状态栏下面,
# 活动日历图标放在小地图左边
# 原版提示按钮(帮助、加点、任务、礼物、活动入口……)原来贴在 PC 任务栏上方两角,
# 移动端排成左侧按钮列右边的第二列;原来共用一个位置的按钮这里也共用一行
GAME_BUTTON_ROWS = (("HELP",), ("STATUS",), ("SKILL", "QUEST", "BUILD", "EXIT_OBSERVER"), ("GIFT",),
("COMBAT_ZONE", "BOSS_EVENT"), ("METIN_EVENT",))
self.quick_slots = []
for i in range(5):
slot = ui.Bar()
slot.SetParent(self.quick_belt)
slot.SetPosition(i * 70, 0)
slot.SetSize(60, 60)
slot.SetColor(grp.GenerateColor(0.1, 0.1, 0.15, 0.6))
slot.Show()
self.quick_slots.append(slot)
def __AdoptGameButtons(self, wndGameButton):
buttons = getattr(wndGameButton, "gameButtonDict", None)
if not buttons:
return
safe_l, safe_t, safe_r, safe_b = self.safe_area
x = safe_l + 12 + self.SIDE_DIAMETER + 14
top = safe_t + 8 + self.FACE_DIAMETER + 48
for row, names in enumerate(self.GAME_BUTTON_ROWS):
for name in names:
btn = buttons.get(name)
if btn:
btn.SetPosition(x, top + row * self.SIDE_STEP)
def OnUpdate(self):
# 1. 刷新主角状态
cur_hp = player.GetStatus(player.HP)
max_hp = player.GetStatus(player.MAX_HP)
if max_hp > 0:
pct = min(1.0, max(0.0, float(cur_hp) / float(max_hp)))
self.hp_bar.SetSize(int(210 * pct), 14)
def AdoptGameWindows(self, game):
safe_l, safe_t, safe_r, safe_b = self.safe_area
game.affectShower.SetPosition(safe_l + 12 + self.FACE_DIAMETER + 8, safe_t + 8 + 62)
notification = getattr(game, "notificationItem", None)
if notification:
sw = wndMgr.GetScreenWidth()
minimap = getattr(self.interface, "wndMiniMap", None) if self.interface else None
right = sw - safe_r - (minimap.GetWidth() if minimap else 0)
notification.SetPosition(right - notification.GetWidth() - 4, safe_t + 8 + self.drawer.GetRowHeight() + 4)
cur_mp = player.GetStatus(player.SP)
max_mp = player.GetStatus(player.MAX_SP)
if max_mp > 0:
pct = min(1.0, max(0.0, float(cur_mp) / float(max_mp)))
self.mp_bar.SetSize(int(180 * pct), 10)
def __RefreshFace(self):
race = net.GetMainActorRace()
if race == self.race:
return
self.race = race
# 头像与角色窗口同一张表
name = uiCharacter.FACE_IMAGE_DICT.get(race)
if not name:
self.face_image.Hide()
return
try:
self.face_image.LoadImage(name)
except:
self.face_image.Hide()
return
size = max(self.face_image.GetWidth(), self.face_image.GetHeight(), 1)
inner = self.FACE_DIAMETER - 16
scale = float(inner) / float(size)
self.face_image.SetScale(scale, scale)
off = (self.FACE_DIAMETER - int(size * scale)) / 2
self.face_image.SetPosition(off, off)
self.face_image.Show()
cur_sp = player.GetStatus(player.STAMINA)
max_sp = player.GetStatus(player.MAX_STAMINA)
if max_sp > 0:
pct = min(1.0, max(0.0, float(cur_sp) / float(max_sp)))
self.sp_bar.SetSize(int(150 * pct), 6)
def __SetGauge(self, bar, width, height, cur, maximum):
if maximum > 0:
pct = min(1.0, max(0.0, float(cur) / float(maximum)))
bar.SetSize(int(width * pct), height)
# 2. 刷新目标状态
target_vid = player.GetTargetVID()
if target_vid != 0 and chr.GetInstanceType(target_vid) != chr.INSTANCE_TYPE_PLAYER:
self.target_hud.Show()
name = chr.GetNameByVID(target_vid)
self.target_name.SetText(name if name else "Target")
target_hp = chr.GetHP(target_vid) if hasattr(chr, 'GetHP') else 100
target_max_hp = chr.GetMaxHP(target_vid) if hasattr(chr, 'GetMaxHP') else 100
if target_max_hp > 0:
pct = min(1.0, max(0.0, float(target_hp) / float(target_max_hp)))
self.target_bar.SetSize(int(420 * pct), 16)
self.target_pct.SetText("%d%%" % int(pct * 100))
else:
self.target_hud.Hide()
def OnUpdate(self):
# 1. 主角状态
self.__SetGauge(self.hp_bar, self.HP_WIDTH, 12, player.GetStatus(player.HP), player.GetStatus(player.MAX_HP))
self.__SetGauge(self.mp_bar, self.SP_WIDTH, 9, player.GetStatus(player.SP), player.GetStatus(player.MAX_SP))
self.__SetGauge(self.sp_bar, self.ST_WIDTH, 5, player.GetStatus(player.STAMINA), player.GetStatus(player.MAX_STAMINA))
self.__SetGauge(self.exp_bar, self.exp_width, 3,
unsigned32(player.GetStatus(player.EXP)), unsigned32(player.GetStatus(player.NEXT_EXP)))
self.text_name.SetText("Lv.%d %s" % (player.GetStatus(player.LEVEL), player.GetName()))
self.__RefreshFace()
# 3. 子组件状态刷新
if hasattr(self, 'joystick') and self.joystick:
self.joystick.OnUpdate()
if hasattr(self, 'combat_wheel') and self.combat_wheel:
self.combat_wheel.OnUpdate()
# 2. 子组件
self.joystick.OnUpdate()
self.combat_wheel.OnUpdate()
if app.GetGlobalTime() - self.lastBeltRefresh > 500:
self.lastBeltRefresh = app.GetGlobalTime()
for slot in self.quick_slots:
slot.Refresh()