Thar0 / gbd

Zelda 64 Graphics Binary Debugger

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Graphics Binary Debugger

The Graphics Binary Debugger, gbd, will inspect an N64 graphics task for errors and try to point out crashing GBI commands. Currently, it only targets F3DZEX and S2DEX2 for Zelda Ocarina of Time MQ Debug, it's scope is intended to be expanded upon in the future. This does not attempt to accurately simulate the microcode task or the workings of the RDP, it only seeks to validate arguments to GBI commands.

It is still rather primitive, but good enough to debug several kinds of common crashes.

Usage

gbd <path to RAM dump> <start address>

Currently, the only way to use gbd is by dumping the contents of RDRAM to a file. AUTO can be entered in place of a start address to use the default start address.

Building

Run make to build the program. Building requires libiconv be installed with --enable-static. Either install it yourself or run make libiconv to install it to /usr/local/lib. If you would like to install libiconv elsewhere you can override ICONV_PREFIX in the Makefile.

Building for windows is also supported. The steps are the same, merely add TARGET=windows in the make commands. If running make libiconv for windows, it will be installed locally to the gitignored libiconv-win directory.

About

Zelda 64 Graphics Binary Debugger

License:GNU Lesser General Public License v3.0


Languages

Language:C 97.8%Language:Makefile 2.2%