https://github.com/felixjones/gba-plusplus

C++ library for writing Game Boy Advance apps and games
https://github.com/felixjones/gba-plusplus

Last synced: 3 months ago
JSON representation

C++ library for writing Game Boy Advance apps and games

• Host: GitHub
• URL: https://github.com/felixjones/gba-plusplus
• Owner: felixjones
• License: other
• Archived: true
• Created: 2019-09-01T14:09:02.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2023-08-19T13:30:36.000Z (about 1 year ago)
• Last Synced: 2024-05-12T06:33:10.820Z (6 months ago)
• Language: C++
• Size: 348 KB
• Stars: 70
• Watchers: 4
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-gba-dev-zh - gba-plusplus - libgba 和 libtonc 的现代 C++替代。 (图书馆)

README

        
# gba-plusplus has been replaced by gba-hpp!

[Go to gba-hpp (github.com/felixjones/gba-hpp)](https://github.com/felixjones/gba-hpp)

# gba-plusplus

[![Documentation Status](https://readthedocs.org/projects/gba-plusplus/badge/?version=latest)](https://gba-plusplus.readthedocs.io/en/latest/?badge=latest)

Code samples and tutorials available on the [project Wiki](https://github.com/felixjones/gba-plusplus/wiki).

Modern drop-in C++ library for the Game Boy Advance. Zlib license.

Feel free to ask for help on the [gbadev Discord](https://discord.io/gbadev).

For a CMake GBA development toolchain see our sister project: [gba-toolchain](https://github.com/felixjones/gba-toolchain).

# Example

```C++

#include 

using namespace gba;

using video_memory_type = std::array, 160>;

static auto& video_memory = *reinterpret_cast( 0x06000000 );

struct bgr555_type {

    uint16 red : 5;

    uint16 green : 5;

    uint16 blue : 5;

};

int main() {

    reg::dispcnt::write( { .mode = 3, .layer_background_2 = true } );

    

    video_memory[80][120] = uint_cast( bgr555_type { .red = 31 } );

    video_memory[80][136] = uint_cast( bgr555_type { .green = 31 } );

    video_memory[96][120] = uint_cast( bgr555_type { .blue = 31 } );

    

    while ( true ) {}

    __builtin_unreachable();

}

```

# About

gba-plusplus is a light-weight C++ abstraction of the Game Boy Advance hardware.

* Hardware tested

* Assembler inspected

* Optimized for `-Og` and `-O3`

* C++17

* Both GCC and Clang compatible

* Compatible with [Tonclib](https://www.coranac.com/man/tonclib/main.htm) and [libgba](https://github.com/devkitPro/libgba)

## *NOT* a game engine

We make close-to-zero assumptions about the type of GBA game you are making.

## Zero tools

We do not restrict you to use any particular file formats or force you to use any additional tools.

## Explicit

The API is verbose and hides as little as possible.

Register names match the familiar documentation.

We respect the programmer, the code you write to shoot yourself in the foot will read like code that is shooting you in the foot.

# Extensions

The `gba/ext/` headers provide features outside of the core GBA hardware.

Some of these may depend on external libraries, such as [agbabi](https://github.com/felixjones/agbabi).

# In-development

We welcome all forms of feedback in the form of GitHub issues. The API will change when necessary, but don't worry all releases will be archived.