webMAN-MOD sLaunch 详解:基于 XMB 视频缓冲渲染的游戏网格菜单
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 后执行:
- 按类型过滤:
gmode非 0 时只保留slaunch[n].type == gmode的条目; - 按设备过滤:
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 挂载点映射在临时目录下); - 剔除空条目(名称为空或路径为空);
- 不区分大小写排序:若列表未排序则执行冒泡排序,并在未启用任何过滤时把排序结果写回 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() 布局代码入手是最直接的路径。