Einsteigertutorial 1: Das erste GBA Programm und allgemeine Grundlagen.

Jetzt kommen wir schon zu unserem ersten Programm. Es ist ganz simple.
Damit ihr mal seht wie so ein Quellcode Aussicht! Ist zwar miniklein aber
jedenfalls etwas! Als erstes zeig ich euch den Code. Dann sag ich euch
wie ihr in compiliert und dann erkläre ich alles Schritt für
Schritt!

Also hier erstmal der Code:

#include "gba.h"

#include "screenmode.h"

int main(void)

{

        SetMode(MODE_3 | BG2_ENABLE);

        for(int c = 0; c <
38400; c++)

                VideoBuffer[c]
= (31 << 10);

        while(1);

}

Wenig, oder? Aber jetzt muss ich euch noch sagen wie man das hier
compiliert. Wenn ihr C/C++ schon könnt seht ihr das ihr die Header
Dateien braucht. Für alle Schreibfaulen oder nicht Schreibfaulen
hier ein Link zu den Code und zu den Headern: t1.zip

Wenn ihr es runtergeladen habt müst ihr es entpacken, in irgend einen
Ordner. Übrigens, die gba.h ist von eloist und die screenmode.h ist
von dovoto! Also Dank geht an sie, den sie haben uns einiges an Arbeit
abgenommen und machen es uns einiges leichter!

Jetzt erkläre ich mal jede Zeile einzeln das sie auch wirklich
jeder versteht! Also dann gehts mal los:

#include "gba.h"

Gba.h ist eine Header Datei mit vielen Typdefenierungen und
Adressen. Die sind sehr wichtig und praktisch. Sie ist von eloist, muss
mal gesagt sein! Genaueres dazu erkläre ich weiter unten!

#include "screenmode.h"

In der screenmode.h ist ein Macro drinnen das ganz einfach
zulässt den Bildmodus zu setzten! Mehr zu Bildmodus im nächsten
Kapitel da das schon einiges umfasst!

int main(void)

{

Die Hauptschleife wie bei jedem C/C++ Programm.

        SetMode(MODE_3 | BG2_ENABLE);

Hier das Macro aus der screenmode.h in action! Diese Macro
setzt den Bildmodus auf mode 3 und macht den Hintergrund an. Was da genau
passiert das erkläre ich im nächsten Kapitel, da das net so
einfach ist! Dieser Modus hat 240 x 160 Pixel.

        for(int c = 0; c <
38400; c++)

                VideoBuffer[c]
= (31 << 10);

Hier ist eine Schleife die 38.400 mal (Damit jeder Pixel mal
angesprochen wird 240 * 160 = 38.400) durch gelaufen wird. Sie füllt
den VideoBuffer (Das ist eine eine Speicher Adresse aus der gba.h sie
zeigt auf den Speicher der auf dem Bildschirm gemalt wird! Wer genau mal
wissen will, wie die Adresse genau lautet sollte sich mal die gba.h anschauen!
Wobei alle sollten sich mal die gba.h anschauen.) mit dem Wert Blau (BGR
Farben B=11111 G=00000 R=00000). Der Wert 31 ist binär 11111 und
das "<< 10" bewirkt das aus den 11111 so was wir 111110000000000.
Also das << schiebt einfach die einsen um 10 stellen nach rechts
und füllt alles mit 0 auf! Mit den << bzw >> kann man
auch super schnell und rechen unaufwendig eine Zahl mal 2 nehmen oder
durch 2 teilen den jede stelle wo es nach link verschoben wird verdoppelt
sich der inhalt. Wenn ihr es um 2 stellen nach links verschiebt vervierfacht
sich der Wert. Ist ganz praktisch zu wissen, aber genug C/C++ Tips!

        while(1);

Eine schöne Endlosschleife! Die unser Programm laufen
läst! Die Dinger sind ja eigentlich gefürchtet aber hier brauchen
wir eine!

}

Ende der main Schleife!

Jetzt kommt eine kleine und kurze Beschreibung
wie wir den Bildmodus setzten, was genau passiert und was der Modus 3
so kann.

SetMode(MODE_3 | BG2_ENABLE);

Dieser Befehl besteht aus mehren teilen hier die einzelnen Teile und ihr
Bedeutung ich hab die definitionen einfach aus der screenmode.h rausgeschrieben,
ich werd auch noch versuchen zu erklären was ein Macro ist falls
das net alle wissen:

#define MODE_3 0x3

Diese Mode_3 steht einfach für den Wert 3. Diese 0x3 ist ein Hex
Wert. Aber ihr müst jetzt umbeding in binär Zahlen denken da
es wir hier einen 16 bit Zahl haben (Warum erkläre ich später!)
also steht dann in dem Wert 0000000000000011.

#define BG2_ENABLE 0x400

Diese BG2_ENABLE steht auch einfach für den Wert 1024. Ja 1024 stimmt
da es eine hexadezimal Zahl ist und binär steht das ganze in unsere
16 bit Wert als 000010000000000.

#define SetMode(mode) REG_DISPCNT = (mode)


Und hier sieht man was genau passiert! SetMode steht stellvertrettend
für REG_DISPCNT. Aber was ist das? Das ist mal wieder eine Adresse
und die zeigt auf den Speicher im GBA der deinem GBA sagt in welchen Modus
er gehn soll! Wir schreiben in die Adresse das 000010000000011. Da diese
Zeichen | die beiden Werte zusammen fügt. Für alle dies genau
wissen wollen das ist der Bitwise-Inclusive-OR Operator. Eer fügt
einfach die zwei Werte zusammen auf binärer Basis zusammen. Kleines
Beispiel mit anderen Zahlen: 1001 | 0011 = 1011 so und eine kleine Grafik
die das selbsterklärend darstellt:

1001

0011

-------

1011

Ist fast wie beim addieren aber auch nur fast! Wenn bei der 1. oder 2.
Zahl eine 1 steht dann kommt unten eine 1 raus. Wenn bei beiden eine 1
steht kommt auch eine 1 raus und nur wenn bei keinem eine 1 steht kommt
eine 0 raus!

Ok jetzt wieder zurück zum Bildmodus diese Macro setz also unsere
Wert an die Adresse. Jetzt zeig ich euch auch mal wie diese Adresse aufgebaut
ist: