webMAN-MOD sLaunch 详解:基于 XMB 视频缓冲渲染的游戏网格菜单

原创2026-10-14 18:28:481,722 阅读
文章标签:嵌入式后端网络

webMAN-MOD sLaunch 详解:基于 XMB 视频缓冲渲染的游戏网格菜单

sLaunch 是 webMAN-MOD 项目中一个独立编译的 VSH(虚拟 Shell)插件,它为 PS3 玩家提供了一套在 XMB 主界面之上直接访问 webMAN 游戏库的替代 UI——无需进入网页管理界面即可浏览、筛选、挂载游戏。本文将以 Projects/slaunch/README.md 为主体,结合 Projects/slaunch/slaunch.c 及 webMAN MOD 主工程的扫描、路径、命令处理源码,完整讲解 sLaunch 的按键操作、侧边菜单功能、数据文件格式、渲染原理与编译方式,帮助你理解"如何在 XMB 上原生呈现 webMAN 游戏网格"这一整套实现。

sLaunch 是什么

sLaunch 是 webMAN MOD 的可选 GUI 组件,用于在 XMB 上以网格形式访问 webMAN 管理的游戏内容。它基于 DeanK 为 sMAN 发布的新 GUI 改造而来,并在其基础上增加了大量功能与性能优化(见 Projects/slaunch/README.md 的 Credits 部分)。

sLaunch 以 .sprx 插件形式存在,由 webMAN MOD 动态加载,菜单渲染时直接写入 XMB 视频缓冲区(利用 3141card 为 VSH menu 开发、并由 DeanK 扩展为全屏显示的渲染技巧),因此它并非网页,而是"画"在 XMB 画面上的原生网格界面。

安装与启动

插件存放位置

按 README 说明,插件存储在 PS3 主机的:

/dev_hdd0/tmp/wm_res/slaunch.sprx

该路径对应 webMAN MOD 主工程中的 WM_RES_PATH(/dev_hdd0/tmp/wm_res,见 include/init/paths.h)。sLaunch 由 webMAN MOD 动态加载,退出菜单返回 XMB 时即从内存卸载。安装更新时,Projects/updater/source/main.c 会将 slaunch.sprx 复制到资源目录(同时更新 slaunch_fav.jpg、slaunch_PSX.jpg 等背景图片),旧版本插件会被先删除(见 updater/source/main.c)。

呼出菜单

在 XMB 界面下,按住 L2+R2 或 START 键 3 秒,即可打开 / 关闭游戏菜单。

在源码中,这一触发逻辑位于 slaunch_thread()(Projects/slaunch/slaunch.c):主循环在 XMB 上轮询手柄数据,当检测到 CELL_PAD_CTRL_L2 | CELL_PAD_CTRL_R2 或单独的 CELL_PAD_CTRL_START 组合时调用 start_VSH_Menu()。注意触发前会经过 gui_allowed() 校验:菜单仅允许在用户已登录且确实处于 XMB(未进入游戏、未加载视频/音频/设置等插件)时打开,否则会通过 webMAN 弹出 Not logged in! 或 Not in XMB! 提示(Projects/slaunch/slaunch.c)。

通过 webMAN 远程/浏览器启动

除了手柄组合键,webMAN MOD 还提供了一条浏览器命令入口:/xmb.ps3$slaunch(见 include/cmd/xmb_browser.h 与 xmb_browser.h 的处理逻辑)。同时在温度页 include/cpursx.h 中,当检测到 WM_RES_PATH "/slaunch.sprx" 存在时,页面会把"MEM/HDD"链接替换为 /browser.ps3$slaunch,方便从浏览器一键呼出菜单。

启动后 sLaunch 会等待 12 秒(sys_timer_sleep(12))再弹出版本提示,以避免干扰开机流程(Projects/slaunch/slaunch.c)。

按键操作完整指南

README 给出了完整按键映射,结合 Projects/slaunch/include/pad.h 中定义的位标志,整理如下:

按键 功能 对应 PAD 标志
左摇杆 / 十字键 移动光标导航 PAD_LEFT/RIGHT/UP/DOWN
L1 / R1 上一页 / 下一页 PAD_L1 / PAD_R1
CROSS(⭘) 加载所选游戏标题 PAD_CROSS
CIRCLE(✕) 退出返回 XMB PAD_CIRCLE
TRIANGLE(△) 打开侧边菜单 PAD_TRIANGLE
SQUARE(□) 按游戏类型过滤(ALL / PSX / PS2 / PS3 / PSP / VIDEO / ROMS) PAD_SQUARE
SQUARE+L2 按设备类型过滤(ALL / dev_hdd0 / NTFS / USB / NET) PAD_SQUARE + PAD_L2
SQUARE+R2 恢复默认内容列表(ALL) PAD_SQUARE + PAD_R2
L3 切换每页 5x2 / 10x4 网格 PAD_L3
R3 快速切换网格(源码中与 L3 同样通过 gpp ^= 34 实现,见 Projects/slaunch/slaunch.c) PAD_R3
SELECT 在收藏列表 / 普通列表间切换 PAD_SELECT
START 将当前游戏加入 / 移出收藏列表 PAD_START

源码细节补充:

  • 导航与翻页:光标移动遵循 gpl = (gpp == 10) ? 5 : 10 的"每行游戏数"规则,上下左右与 L1/R1 翻页的边界回绕逻辑见 Projects/slaunch/slaunch.c。
  • 加载游戏:按 CROSS 时,sLaunch 读取当前条目的挂载路径(slaunch<a href="https://link.gitcode.com/i/d70bd82a4461c27c49fe958ff59c421d" target="_blank">cur_game].name + path_pos),对 PS1/PS2(type <= TYPE_PS2)先闪烁红框提示再发送请求,其余类型直接发送 web 请求([Projects/slaunch/slaunch.c)。挂载动作由 webMAN MOD 与 Cobra payload 完成,sLaunch 只负责"发命令"。
  • 日版按键:pad_read() 会查询系统设置(GetEnterButtonAssign),若为日版(O/X 互换)会自动交换 CROSS/CIRCLE(Projects/slaunch/include/pad.h)。
  • 模拟摇杆:左右摇杆的模拟值同样被映射为方向键(阈值 <0x10 / >0xf0),所以用摇杆推到底也能导航(Projects/slaunch/include/pad.h)。

侧边菜单(Side Menu)详解

按 TRIANGLE 打开侧边菜单,用上下键选择、CROSS 确认、TRIANGLE/CIRCLE 取消(Projects/slaunch/slaunch.c)。8 个选项及其底层实现:

选项 作用 底层 web 命令 / 实现
Favorites / 类型列表 切换收藏与普通列表,或按类型过滤 左侧/右侧方向键在 TYPE_ALL..TYPE_FAV 间循环(Projects/slaunch/slaunch.c)
Unmount 卸载已挂载的游戏(ISO / 文件夹) send_wm_request("/mount_ps3/unmount")
Refresh 重新扫描内容,无需重载 XMB 即时刷新 send_wm_request("/refresh_ps3")
gameDATA 将 /dev_hdd0/game 重定向到 USB 设备 send_wm_request("/extgd.ps3")
Disable CFW Syscalls 在 gameDATA 上按 LEFT/RIGHT 切换;禁用 CFW 系统调用 先弹窗提示再执行 send_wm_request("/syscall.ps3mapi?scd=1")(Projects/slaunch/slaunch.c)
Restart 重启 PS3 send_wm_request("/restart.ps3")
Shutdown 关机 send_wm_request("/shutdown.ps3")
Unload webMAN / Quit 卸载 webMAN(在选项上按 LEFT/RIGHT 可在两种模式间切换) 弹窗提示后执行 send_wm_request("/quit.ps3"),随后设置 running = 0 退出主循环(Projects/slaunch/slaunch.c)
Setup / File Manager / Grid 10x4 在 Setup 上按 LEFT/RIGHT 可切换为打开文件管理器或切换网格布局 send_wm_request("/browser.ps3/") 或 send_wm_request("/browser.ps3/setup.ps3")(Projects/slaunch/slaunch.c)

侧边菜单的绘制由 draw_side_menu_option() 完成,它会把菜单渲染到 ctx.side 缓冲再合成到屏幕(Projects/slaunch/slaunch.c),并使用 XMB 自带的 RCO 音效(snd_cursor、snd_cancel、snd_system_ok,见 Projects/slaunch/misc.c)。

收藏功能

START 键添加/移除收藏:

  • 添加:add_game() 先检查 slist1.bin 是否已存在同路径条目(按挂载路径去重),无重复则以追加模式(O_APPEND | O_CREAT)写入当前游戏的完整记录,同时以蓝色闪烁提示(Projects/slaunch/slaunch.c)。
  • 移除:remove_game() 重写整个 slist1.bin(跳过当前条目),随后收缩内存中的列表并以红色闪烁提示(Projects/slaunch/slaunch.c)。
  • 按 SELECT 则在两个列表间切换(TOGGLE(fav_mode) 后重新加载数据)。

工作原理

插件生命周期

  • sLaunch 是标准 PRX 模块:SYS_MODULE_INFO(sLaunch, 0, 1, 1),版本号在源码中定义为 "1.19"(Projects/slaunch/slaunch.c)。
  • 启动时创建 slaunch_thread(优先级 -0x1d8、栈 0x2000),退出时由 slaunch_stop_thread 回收线程并调用 finalize_module() 完成模块卸载(Projects/slaunch/slaunch.c)。
  • 菜单打开流程 start_VSH_Menu()(Projects/slaunch/slaunch.c):从内存容器 1("app")创建堆 → 读取屏幕分辨率 → 暂停 RSX FIFO → 初始化图形 → 停用 VSH 手柄(start_stop_vsh_pad(0))→ 加载配置与游戏列表 → 显示界面。菜单关闭时逆序执行:释放字体实例、销毁堆、保存配置、恢复 RSX 与 VSH 手柄(stop_VSH_Menu(),Projects/slaunch/slaunch.c)。

停用 VSH 手柄的原理很有意思:start_stop_vsh_pad() 直接把 io_pad_library 的初始化标志置 0,使 VSH 读取手柄时得到 CELL_PAD_ERROR_UNINITIALIZED 从而"看不见"你的按键;而 sLaunch 则通过系统调用 sys_hid_manager_read()(MyPadGetData())直接读取手柄数据,实现"接管"输入(Projects/slaunch/include/pad.h)。

游戏列表文件

游戏列表由 webMAN MOD 在扫描 XML 内容列表时构建,写入:

/dev_hdd0/tmp/wmtmp/slist.bin      ← 普通游戏列表
/dev_hdd0/tmp/wmtmp/slist1.bin     ← 收藏列表

主工程中该路径由 include/init/paths.h 定义为 SLAUNCH_FILE = WMTMP "/slist.bin"。扫描逻辑位于 include/scan/games_slaunch.h:

  • create_slaunch_file() 以覆盖写模式创建文件;
  • add_slaunch_entry() 将每个游戏写为一条定长记录(类型、标题 ID、挂载 URL、图标路径、名称);
  • close_slaunch_file() 写完后关闭并设置权限。

调用点分别出现在 XML 列表生成(include/scan/games_xml.h)与 HTML 列表生成(include/scan/games_html.h)中:非过滤、非移动端浏览 index.ps3 时若 slist.bin 已存在则直接复用,否则重建。此外 find_slaunch_game() 还用于 webMAN 的挂载复制(include/cmd/mount_copy.h)与手柄组合键播放(include/cmd/pad_combo_play.h),从 slist.bin 反查某个文件名对应的挂载路径。

内部数据结构

README 特别提醒:sLaunch 的内部数据结构与 sMAN 的 sLaunch 菜单完全不同。sLaunch 使用的定长记录结构为(Projects/slaunch/slaunch.c,与 include/scan/games_slaunch.h 中主工程侧的定义完全一致):

typedef struct // 1MB for 2000+1 titles
{
    uint8_t  type;      // 游戏类型(TYPE_PS1/PS2/PS3/PSP/VID/ROM...)
    char     id[10];    // 标题 ID
    uint8_t  path_pos;  // name[] 中挂载路径的起始偏移
    uint16_t icon_pos;  // name[] 中图标路径的起始偏移
    uint16_t padd;      // 填充
    char     name[508]; // 名称 + 挂载路径 + 图标路径(共用缓冲区)
} __attribute__((packed)) _slaunch;

每条记录约 512 字节,因此 1MB 可容纳 2000+1 个条目(MAX_GAMES 2000)。路径与图标以"偏移量 + 单一字符串区"的方式存储,加载时直接取 name + path_pos 作为挂载 URL、name + icon_pos 作为图标 URL,非常紧凑。

游戏类型常量(Projects/slaunch/slaunch.c):

TYPE_ALL 0  TYPE_PS1 1  TYPE_PS2 2  TYPE_PS3 3
TYPE_PSP 4  TYPE_VID 5  TYPE_ROM 6  TYPE_FAV 7

过滤、排序与设备识别

load_data()(Projects/slaunch/slaunch.c)加载 slist.bin 后执行:

  1. 按类型过滤:gmode 非 0 时只保留 slaunch[n].type == gmode 的条目;
  2. 按设备过滤:dmode 非 0 时按挂载路径匹配 drives<a href="https://link.gitcode.com/i/1337fd6ecca255e70b8f953799cb4ea1" target="_blank">](dev_hdd0 / ntfs / dev_usb / net,见 [Projects/slaunch/slaunch.c)。其中 NTFS 条目通过路径含 /dev_hdd0/tmp 来识别(NTFS 挂载点映射在临时目录下);
  3. 剔除空条目(名称为空或路径为空);
  4. 不区分大小写排序:若列表未排序则执行冒泡排序,并在未启用任何过滤时把排序结果写回 slist.bin 缓存。

设备过滤的细节见 Projects/slaunch/slaunch.c:HDD0 条目要求路径以 dev_hdd0 开头且第 20 个字符不是 t(排除 NTFS 的 /dev_hdd0/tmp 映射)。

界面渲染与温度显示

  • 菜单直接写入 XMB 视频缓冲区:画布常量定义在 Projects/slaunch/include/blitting.h,CANVAS_W=1920、CANVAS_H=1080,信息条(infobar)位于 INFOBAR_Y=900、高 96 像素,侧边菜单起点 SM_X=1440。不同分辨率(1080p/720p/480p/576p)通过宏换算帧缓冲偏移(OFFSET_1080/OFFSET_720p/...)。
  • 每页布局:5x2 网格时图标间距按 160+24px 平铺;10x4 时按 320+56px 平铺(draw_page(),Projects/slaunch/slaunch.c)。低于 720p 时强制回退为 5x2(if(disp_h<720) gpp = 10;)。
  • 屏幕温度显示:信息条右侧实时显示 CPU / RSX 温度(摄氏与华氏),并约每 400 帧在 CPU 与 RSX 之间轮换(Projects/slaunch/slaunch.c 与 slaunch.c)。温度数据通过 get_temperature()(Projects/slaunch/misc.c 附近,实际实现调用 webMAN 的 /cpursx.ps3 体系)获取。
  • 选中框带有脉动动画(tick/delta 实现亮度呼吸,见 Projects/slaunch/slaunch.c),翻页过程中还会轮询手柄以支持 L1/R1 快速中断绘制。

图标与背景回退链

图标来源(Projects/slaunch/slaunch.c 与 slaunch.c):

/dev_flash/vsh/resource/explore/icon/icon_wm_ps3.png 等 7 个类型图标
  → 不存在则用 /dev_hdd0/tmp/wm_icons/ 下同名图标
  → 再不存在则用 /dev_flash/vsh/resource/explore/user/020.png ~ 026.png

背景图(load_background(),Projects/slaunch/slaunch.c):

/dev_hdd0/tmp/wm_res/images/slaunch.jpg        (ALL 模式)
/dev_hdd0/tmp/wm_res/images/slaunch_PSX.jpg 等(按类型,PSX/PS2/PS3/PSP/video/ROMS)
/dev_hdd0/tmp/wm_res/images/slaunch_fav.jpg    (收藏模式)
  → 均不存在则回退到 /dev_flash/vsh/resource/explore/icon/cinfo-bg-store*.jpg

图片解码支持 PNG/JPG/ARGB:sLaunch 自带 png_dec.c、jpg_dec.c、argb_dec.c 解码器,并附带 png2argb 转换工具(Projects/slaunch/tools/png2argb/png2argb.c)用于将 PNG 预转成 ARGB 位图以加速渲染。

配置持久化

最后使用的设置保存在:

/dev_hdd0/tmp/wmtmp/slaunch.cfg

load_config() / save_config() 读写 _sconfig 结构(Projects/slaunch/slaunch.c),持久化字段包括:类型过滤 gmode、设备过滤 dmode、网格布局 gpp、收藏模式 fav_mode、收藏索引 fav_game、以及普通/收藏列表各自的光标位置 cur_game / cur_game_。退出菜单时自动保存。

编译说明

README 明确给出了编译约束:sLaunch 使用 cc/gcc 工具链 4.6.2(Windows 版) 编译;4.1.1 的 Linux 编译器在开启优化(甚至 -O1)时可能生成有问题的代码,因此若自行编译请优先采用 README 指定的工具链版本。

工程根目录的 Projects/slaunch/Makefile 展示了完整构建流程:

  • 目标产物为 slaunch.prx(PPU PRX),随后用 scetool 签名生成可被 webMAN 加载的 SPRX(-0 SELF -1 TRUE ... -e slaunch.prx slaunch.sprx);
  • 编译参数:-Os -ffunction-sections -fdata-sections -fno-builtin-printf -nodefaultlibs -std=gnu99;
  • 链接库包括 -lfs_stub -lnet_stub -lio_stub -lnetctl_stub -ljpgdec_stub -lstdc_export_stub -lallocator_export_stub -lxsetting_export_stub -lpngdec_ppuonly_export_stub -lvsh_export_stub -lpaf_export_stub -lvshmain_export_stub -lvshtask_export_stub -lsdk_export_stub -lsys_io_export_stub;
  • 源码文件:libc.c(仓库根目录)、mem.c、misc.c、argb_dec.c、png_dec.c、jpg_dec.c、blitting.c、slaunch.c,头文件目录指向仓库根目录的 vsh/(VSH 导出头)。

相关文件速览

文件 作用
Projects/slaunch/slaunch.c 插件主逻辑:线程、菜单、过滤、收藏、配置、web 命令
Projects/slaunch/include/blitting.h 画布/帧缓冲常量、字体与位图缓冲结构
Projects/slaunch/include/pad.h 手柄位标志、VSH pad 接管、sys_hid_manager_read 直读
Projects/slaunch/include/misc.h 温度、RCO 音效、文件存在性等辅助函数
Projects/slaunch/Makefile SPRX 构建与签名流程
include/scan/games_slaunch.h webMAN 侧生成 slist.bin 的实现
include/init/paths.h SLAUNCH_FILE 路径定义
include/cmd/xmb_browser.h /xmb.ps3$slaunch 远程启动入口
Projects/updater/source/main.c 更新器对 sLaunch 插件与背景图的安装

致谢与代码来源

sLaunch 的诞生离不开以下贡献者(见 README Credits):

  • DeanK —— 原始 sLaunch GUI 概念与编码;
  • aldostools —— 修改、附加功能与优化;
  • 3141card —— 视频渲染函数与内存处理;
  • DarjanKrijan —— ARGB 支持与测试;
  • Mysis —— VSH exports。

简而言之:sLaunch 是 webMAN MOD 生态中"把游戏库带进 XMB"的关键一环——它依赖 webMAN MOD 扫描生成 slist.bin 数据、以 VSH 直写帧缓冲的方式渲染网格、再以 web 命令回路请求挂载,是一个数据、渲染、命令三端协同的典型 VSH 插件实现。若想深入扩展(例如调整网格密度、加入新的过滤维度),从 slaunch.c 的 load_data() 过滤链与 draw_page() 布局代码入手是最直接的路径。

登录后查看全文
webMAN-MOD