Farbrausch 演示场景工具源码合集(fr_public)
Farbrausch 2001—2011 年 demo 工具源码合集,使用 C++,涉及 demoscene 与 D...
Chip8Python · craigthomas/Chip8Python
Chip8Python 是一个用 Python 编写的 Chip 8 模拟器,按仓库说明同时支持 XO Chip 与 Super Chip,并标称兼容 Octo。项目以 MIT 协议开源,README 提供 Ubuntu 与 Windows 安装步骤,以及运行 ROM、调整屏幕缩放等使用说明;仓库 topics...
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 为例)大致步骤:
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。python3-pip)。~/.bashrc 末尾追加相关环境变量并 source,再执行 mkvirtualenv chip8 创建环境。pip install -r requirements.txt 安装依赖。Windows 大致步骤:
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 等。--shift_quirks、--index_quirks、--jump_quirks、--clip_quirks、--logic_quirks。README 用相当篇幅解释 Chip 8 语言规范在演进中出现的碎片化问题:Super Chip 的一个版本悄然改变了几条指令的语义,导致为「纯」Chip 8 编写的程序在采用新规范的模拟器上出错。项目参考 Octo 的做法,提供若干 quirks 标志:
y 与目标寄存器 x,写作 Vx = Vy << 1;新规范则忽略 y,写作 Vx = Vx << 1。Fn65(load)与 Fn55(store)之后索引寄存器是否按寄存器数量后自增;开启后不再自增。Bnnn 跳转在原始规范中为 PC = V0 + nnn;Super Chip 规范用指令高 4 位编码寄存器,变为 PC = Vx + nn。README 的 Customization 部分另设 Keys 与 Debug Keys 小节,用于说明模拟器的操作按键与调试按键映射,具体键位请以仓库内文档为准。
在致谢方面,作者明确引用了 Octo 的 Mastering SuperChip 文档,以及 Chromatophore 的 HP48-Superchip 仓库——后者对野外常见的各种 quirks 行为做了深入剖析。仓库还列出了 Further Documentation 章节,供继续查阅。
Chip 8 指令集规模小、结构清晰,很适合作为「写一个解释器/模拟器」的入门练手项目;本项目自带完整安装与参数说明,可先从跑通 ROM 开始,再读源码理解取指—译码—执行的循环。Quirks 一节则是理解「规范碎片化」与兼容性开关设计的好案例,配合作者提供的 Java、C 版本对照阅读,能更直观地比较不同语言下的实现取舍。
Farbrausch 2001—2011 年 demo 工具源码合集,使用 C++,涉及 demoscene 与 D...
该仓库为 Java 语言项目,名称 BuildGDX 由「Build」与「GDX」组合,推测与 B...
id Software 以 GPL 许可证发布的《雷神之锤3竞技场》(Quake III Arena)源...
id Software 以 GPL 发布的《Doom 3 BFG Edition》C++ 源代码。发布包不含游...