Skip to content

Latest commit

 

History

History
82 lines (61 loc) · 2.24 KB

readme.md

File metadata and controls

82 lines (61 loc) · 2.24 KB
Raw

LibGBA - CPP

What is it?

It's a C++ library for GBA homebrew development. Focused on better API and abstraction, so programmers can focus more on game logic and call functions for effects instead of thinking in a too low-level way.

Requirements

A lot of statements are being written with C++11/14/17 features, so, the requirements are:

  • Toolchain: DevKitPro (to compile for GBA ARMv4 ISA and ARM7TDMI processor).
  • Compiler: GCC 7.1 or above;
  • Build-system: Meson

Examples

Building

To build this project, after installing the Requirements and cloning this repository, enter the cloned repository's directory and run:

$ meson build --cross-file cross_file.ini

If you want to build examples as well, add -Dbuild-tests=true to the command:

$ meson build -Dbuild-tests=true

Running examples

After building the examples (see Building), you'll need a GBA emulator. My personal recommendations are:

  • MGBA: an open-source fully-featured GBA emulator with a lot of cool debugging tools. Can also link with GDB for a professional in-depth debugging.
  • Visual Boy Advance-M: continuation of the almighty legendary VisualBoyAdvance.

Examples are compiled into the build/tests directory. So to run, say, alphablend example, you should open build/tests/alphablend.gba with your emulator.

Documentation

To-Do's

Check issues.

Bibliography

There are two main contributions for the knowledge necessary to make this library: one is the greatly well explained tutorials TONC by J Vijn (which I really want to thank him for making it), and the other is the great GBA Techical Manual by Martin Korth.