# DMG-report

DMG and CGB (Game Boy and Color GameBoy) game programming tutorials in assembly compiled with [RGBDS](https://github.com/rednex/rgbds)

| ![minimal_background_scroll](images/minimal_background_scroll.asmclip.gif) | ![better_sprite_moves](images/better_sprite_moves.asmclip.gif) | ![palette_change_animation](images/palette_change_animation.asmclip.gif) | ![hello_world_background](images/hello_world_background.asmclip.gif) |
| -- | -- | -- | -- |
| ![color_palette_exploration](images/color_palette_exploration.asmclip.gif) | ![background_color_gradient](images/background_color_gradient.asmclip.gif) | ![custom_graphics](images/custom_graphics.asmclip.gif) | ![background_2x_height](images/background_2x_height.asmclip.gif) |

The goal of this repository is to contain minimal code designed to teach the basics of creating assembly games for the GameBoy and GameBoy Color. This repository assumes two things: You'll be compiling with [RGBDS](https://github.com/rednex/rgbds) and that you'll be testing with [BGB](http://bgb.bircd.org/).

We start with teaching how to scroll the background, then move to sprite movement, capturing input from the gameboy's joypad, and then setting colors on the background and sprites.

#### Compiling

You can compile each example by running the running the following script:
```
rgbasm -o <filename.obj> <filename.asm>
rgblink -o a.gb <filename.obj>
rgbfix -v -p0 a.gb
rm <filename.obj>
```
so building the file `01_minimal_template.asm` as an example:
```
rgbasm -o 01_minimal_template.obj 01_minimal_template.asm
rgblink -o a.gb 01_minimal_template.obj
rgbfix -v -p0 a.gb
rm 01_minimal_template.obj
```
Now you can run the built game with bgb: Start up bgb and drag and drop / open the file. Or you can launch it through the command-line:
linux:
`wine ~/path/to/bgb/bgb.exe a.gb`
windows:
`path/to/bgb/bgb.exe a.gb`


## Other Assembly examples

![https://github.com/tbsp/simple-gb-asm-examples](https://github.com/tbsp/simple-gb-asm-examples)