本页目录

Chip8Python:Chip 8 / Super Chip / XO Chip 模拟器(Python)

Chip8Python · craigthomas/Chip8Python

Chip8Python 是一个用 Python 编写的 Chip 8 模拟器,按仓库说明同时支持 XO Chip 与 Super Chip,并标称兼容 Octo。项目以 MIT 协议开源,README 提供 Ubuntu 与 Windows 安装步骤,以及运行 ROM、调整屏幕缩放等使用说明;仓库 topics...

其他 Pygame Python 渲染技术 中级
★ Stars 102 Forks 25 License MIT 更新 2026-10-11

国内开发环境适配

Windows
官方声明支持
Linux
官方声明支持
macOS
未知
引擎 / 框架:Pygame 暂无中文教程标记 未标记站长实测
Linux 下 pygame 依赖 SDL 系列系统库(libsdl-dev、libsdl-image/mixer/ttf/sound 等),需通过 apt 安装;pip 安装 pygame 时建议使用国内镜像源加速,具体可用性待核验。Windows 下按 README 勾选 pip 与 PATH 即可,无需编译。

中文项目介绍

Chip8Python(仓库内的可执行脚本为 yac8e.py)是一个用 Python 3 编写的 Chip 8 模拟器,README 标题写作「Yet Another (Super) Chip 8 Emulator」。作者在文档中说明,项目最初的目标是做一个简单、文档完善、代码表述易于理解的「学习型模拟器」,同时也是一次深入了解 Python 的练习,最终产物是一个命令行方式的 Chip 8 模拟器。

在标准 Chip 8 之外,模拟器还实现了 XO Chip 与 Super Chip 规范,并标称与 Octo 兼容。README 特别提示:运行 XO Chip、Super Chip 或普通 Chip 8 ROM 本身并不需要额外开关,但部分 ROM 可能需要配合不同的兼容性(quirks)标志才能正常运行,具体见下文。

同一作者还提供了另外两个语言版本的实现——Chip8Java 与 Chip8C,便于做跨语言对照阅读。

补充说明

授权协议

项目采用 MIT 风格许可,条款细节见仓库中的 LICENSE 文件。

安装指南

运行前需要 Python 3.6.8 或更高版本,以及 pygame。README 建议使用 virtualenv 与 virtualenvwrapper 创建独立虚拟环境,把 pygame 装进沙箱,而不影响系统主 Python 环境。

Ubuntu(README 以 Ubuntu 20.04 为例)大致步骤:

  1. 安装 SDL 及其依赖:python3、python3-dev、libsdl-dev、libfreetype6-dev、libsdl-image1.2-dev、libsdl-mixer1.2-dev、libsdl-ttf2.0-dev、libsdl-sound1.2-dev、libportmidi-dev。
  2. 安装 pip(python3-pip)。
  3. 可选:安装 virtualenv / virtualenvwrapper,在 ~/.bashrc 末尾追加相关环境变量并 source,再执行 mkvirtualenv chip8 创建环境。
  4. 用 git 克隆本仓库。
  5. 执行 pip install -r requirements.txt 安装依赖。

Windows 大致步骤:

  1. 安装 Python 3.6.8 或更新版本,安装时勾选 pip 与「Add python.exe to Path」;README 注明更高版本的 Python 3 一般也能正常工作。
  2. 可选:安装 virtualenv 与 virtualenvwrapper-win,并创建独立环境。
  3. 安装 Git for Windows 并克隆仓库。
  4. 在源码目录执行 pip install -r requirements.txt。

运行与命令行参数

若使用了虚拟环境,需先 workon chip8 激活。命令行接口只要求一个参数,即 ROM 文件的完整路径:

python yac8e.py /path/to/rom/filename

常用参数(均按 README 描述整理):

  • --scale:缩放窗口尺寸,1 倍时原始分辨率为 64×32,例如 --scale 10 表示放大 10 倍。
  • --ticks:限制每秒执行的指令数,默认 1000,最小 200。为简化处理,每条指令被假定耗时相同;用于让运行过快的 ROM 慢下来。
  • --mem_size:内存大小,默认 64K(XO Chip 扩展需要),可改为 4K 以贴近原始规范。
  • --color_0 / --color_1 / --color_2 / --color_3:分别指定背景色与各 bitplane 的颜色,使用不带 # 的 HTML 十六进制值,默认依次为 000000、FF33CC、33CCFF 等。
  • quirks 系列开关:--shift_quirks、--index_quirks、--jump_quirks、--clip_quirks、--logic_quirks。

Quirks 模式说明

README 用相当篇幅解释 Chip 8 语言规范在演进中出现的碎片化问题:Super Chip 的一个版本悄然改变了几条指令的语义,导致为「纯」Chip 8 编写的程序在采用新规范的模拟器上出错。项目参考 Octo 的做法,提供若干 quirks 标志:

  • Shift Quirks:原始规范中移位指令需要源寄存器 y 与目标寄存器 x,写作 Vx = Vy << 1;新规范则忽略 y,写作 Vx = Vx << 1。
  • Index Quirks:控制 Fn65(load)与 Fn55(store)之后索引寄存器是否按寄存器数量后自增;开启后不再自增。
  • Jump Quirks:Bnnn 跳转在原始规范中为 PC = V0 + nnn;Super Chip 规范用指令高 4 位编码寄存器,变为 PC = Vx + nn。
  • Clip Quirks:默认精灵会绕屏幕边界环绕;开启后禁止环绕。
  • Logic Quirks:控制 AND、OR、XOR 等逻辑运算后 F 寄存器是否清零;默认保持未定义,开启后总是清零。

自定义与延伸阅读

README 的 Customization 部分另设 Keys 与 Debug Keys 小节,用于说明模拟器的操作按键与调试按键映射,具体键位请以仓库内文档为准。

在致谢方面,作者明确引用了 Octo 的 Mastering SuperChip 文档,以及 Chromatophore 的 HP48-Superchip 仓库——后者对野外常见的各种 quirks 行为做了深入剖析。仓库还列出了 Further Documentation 章节,供继续查阅。

学习建议

Chip 8 指令集规模小、结构清晰,很适合作为「写一个解释器/模拟器」的入门练手项目;本项目自带完整安装与参数说明,可先从跑通 ROM 开始,再读源码理解取指—译码—执行的循环。Quirks 一节则是理解「规范碎片化」与兼容性开关设计的好案例,配合作者提供的 Java、C 版本对照阅读,能更直观地比较不同语言下的实现取舍。

开源许可证与版权说明

许可证标识:MIT。源码、资源与依赖许可可能不同,请以官方仓库为准。本站仅做索引,不托管源码。

相似项目