Wolf4SDL
Wolfenstein 3D 的跨平台 SDL 移植版，保留原版手感同时增加高分辨率、AdLib 音乐、控制器支持等现代改进。
基本信息
| 项目 | 内容 |
|---|---|
| GitHub | https://github.com/lazd/wolf4sdl |
| 语言 | C (gnu99) |
| 构建系统 | Makefile + 多种 IDE 项目文件 |
| 渲染/引擎 | SDL + SDL_mixer，Raycasting 软件渲染 |
| 许可 | GPLv2 或 id Software 许可（双许可） |
| 依赖 | SDL 1.2, SDL_mixer |
核心技术点
原始代码复用架构
Wolf4SDL 直接基于 id Software 1992年开源的 Wolfenstein 3D 源码（id_*.cpp 系列），不做清洁室重实现，而是通过 version.h 宏开关支持多版本游戏数据文件（v1.0-v1.4 / Shareware / Full / Spear of Destiny）。这与 ECWolf 类似，但 ECWolf 采用更激进的代码重构（C++）。
OPL2 模拟器双实现
音频子系统（id_sd.cpp）内置两个 AdLib OPL2 模拟器二选一：
- dosbox/dbopl.cpp — DOSBox OPL3 模拟器（GPL）
- mame/fmopl.cpp — MAME OPL2 模拟器（MAME 许可）
通过 Makefile GPL=1 开关选择，编译时 -DUSE_GPL 决定使用哪个实现。
SDL 跨平台层
id_vl.cpp / id_vh.cpp 处理 SDL 视频抽象，id_in.cpp 处理输入（键盘/鼠标/手柄）。id_pm.cpp 为内存映射文件系统（对应游戏数据文件 .WL6 等）。
版本条件编译
version.h 是核心配置头文件，通过 #define 宏选择目标游戏版本（Wolf3D v1.1/1.4 full、shareware、Spear of Destiny 等），每个版本的敌人数量、地图数量、难度参数均硬编码在此。
玩法特点
- 经典 Raycasting 渲染：与原版 Wolfenstein 3D 相同的光线投射软件渲染，320×200 原始分辨率或任意倍数
- 多手柄支持：可完全用游戏手柄游玩（至少 2 键，推荐 5+ 键）
- 任意分辨率：支持 320×200/240 的任意倍数分辨率，宽屏自适应
- AdLib 音乐：OPL2 模拟器实现近乎完美的原版音乐，无需真实声卡
- 8 通道数字化音效：原版只有单通道，改进明显
对公司 AI 游戏的参考价值
| 方向 | 启示 |
|---|---|
| 经典游戏现代移植 | Wolf4SDL 示范了如何最小改动保留原味的跨平台移植策略 |
| 跨平台抽象层设计 | id_*.cpp 模块化设计（输入/音频/视频/内存分离）可直接借鉴 |
| 多版本兼容 | version.h 条件编译模式适合游戏兼容层（如 ECWolf 对多 IWAD 的处理） |
| 手柄支持 | SDL GameController API 的早期使用，参考意义强 |
| 嵌入式模拟器 | OPL2 模拟器的双实现切换（GPL/MAME）是依赖许可设计的经典案例 |