wheatman / pancake

A tool for using libsm64.

Pancake

TODO: add logo

Pancake is a library to interface with libsm64, a modified version of the SM64 decompilation currently included with Wafel.

FAQ

I'm probably going to get these questions a lot, so here goes.

Why "Pancake"?

There are two tools currently in use by the SM64 TASing community: STROOP and Wafel, which together comprise the name of a very certain Dutch dessert: stroopwafel. Since this library complements both STROOP and Wafel, I decided to go with the name Pancake, since people eat pancakes with stroopwafels, and as a subtle nod to pannenkoek2012.

If STROOP and WAFEL are both acronyms, what does PANCAKE stand for?

Pointer ANalyzer Collecting Access to Known Engine.
(shoutouts to Notchmath for coming up with like 75% of this)

Is it faster than Wafel API?

Pancake is likely slightly slower, but it is still blazing fast.
Reasons include:

• libdwarf (the only DWARF parser I found for Windows) is slow
• Wafel caches the address of globals during data path compilation, Pancake doesn't (for safety reasons)

How do I use it?

Download from the GitHub releases, the folders in your zip should explain themselves. Documentation is available on this repo's GitHub Pages.

If you want to build it on your own computer, see below.

Building it yourself

This is just your standard CMake project. As such, you can build it like so:

mkdir build && cd build
cmake ..
cmake --build .

I recommend using the Ninja generator if you're using VSCode, as that guarantees access to a compilation database. As a sidenote, no one has built libsm64 on a Mac, and as such you can only use Windows or Linux.

I think I will need more setup to allow use of find_package, but ExternalProject should work OK.

Legal issues, acknowledgements, etc.

I am currently not willing to license Pancake as open source, simply due to the non-licensing of the Super Mario 64 decompilation. If I can be 100% sure Nintendo isn't going to chase after me, I will officially open-source this.