Einsteigertutorial 3: Joypad und DMA

Bei einem Spiel ist die
Steuerung ein ganz wichtiger Punkt. Was wäre ein Spiel ohne Steuerung?
Und was wäre ein Spiel ohne GUTER Steuerung? Man darf die Steuerung in
einem Spiel nie hinten anstellen, also dies ist ein ganz wichtiger Punkt
hier, und er sollte genau studiert werden. Wobei, eigentlich ist es einfach!
Um Genau zu sein ist es sogar verdammt einfach. Also einfach mal anschauen
und verstehen! Als erstes hier noch das File mit den 2 Beispielprogrammen:
t3.zip

Das erste Beispiel, dass wir jetzt besprechen, ist die Datei "t3-1.cpp".
Die "make t3-1.bat" compiliert das ganze und spuckt das Programm
aus in die Rom "t3-1.gba". Nun startet mal die Rom und schaut
euch an, was das Programm kann. Also ihr seht dann das:

src="http://andreas.abi-2005.org/devgba/artikel/hurik/dt3/t3-1.jpg" width="240" height="160">

Drückt ihr nach rechts, dann kommt das:

src="http://andreas.abi-2005.org/devgba/artikel/hurik/dt3/t3-2.jpg" width="240" height="160">

Drückt ihr nach Links, kommt ihr wieder zum ersten, und
das die ganze Zeit! Toll, nicht? (Ich steh auf Selbstdarstellung! =) )
Na aber egal. In dem Beispiel benutzt ihr nur 2 Tasten, aber das reicht
vollkommen, da man die Tasten gleich anspricht, und wenn ihrs bei einer
Taste könnt, könnt ihr es bei allen! Aber hier, jetzt analysieren wir
den Quellcode Zeile für Zeile:

#include "gball.h"

Das ist meine Include Datei. Sie ist eigentlich Dovotos Headers zusammen
geworfen! Wobei ich sie leicht verbessert, andersweitig ergänzt habe,
und auch neuere Version genommen habe, die von anderen (z.B. Starmonkey)
verbessert wurden.

#include "hurik.h"

#include "slideshow.h"

Das sind die Bilddateien, die mit Dovotos pcx->gba Programm
in Header umgewandelt worden sind.

int main(void)

{

Start der Hauptschleife.

    SetMode(MODE_4
| BG2_ENABLE);

Setzt den Bildmodus auf Mode 4
und schaltet den Bachground Nummer 2 an.

    for(c =
0; c < 256; c++)

        BGPaletteMem[c] = hurikPalette[c];

Kopiert die Palette des des ERSTEN Bildes in den Speicher.
Da wir am Start, bevor man irgendwas drückt, das erste Bild sehen wollen.
Falls sich jemand fragt, woher die c Variable kommt, obwohl wir die gar
net deklariert haben, dem muss ich sagen, dass diese in der gball.h deklariert
wird. Ist einfach meine Countervariable, die man immer brauchen kann.

    for(c =
0; c < 19200; c++)

        VideoBuffer[c] = hurikData[c];

Kopiert die Bilddaten des ERSTEN Bildes in den Speicher.



    while(1)

    {

Das ist hier eine Endlosschleife, die das Programm am Leben
lässt, sodass es bis in die Ewigkeit läuft!

        if(!(*KEYS
& KEY_LEFT))

        {

Das ist eine ganz simple Abfrage, ob die eine Taste gedrükt
wurde (KEYS), und ob es die Linke war (KEY_LEFT). Wichtig ist nur, dass
das ganze "!(*KEYS & KEY_LEFT" in der Form dasteht! Und
das war schon das ganze Tastengeheimnis. Nach dem Programm gibts noch
ne Übersicht zu allen Tasten! Super einfach wie gesagt!

            for(c
= 0; c < 256; c++)

                BGPaletteMem[c]
= hurikPalette[c];

Kopiert die Palette des des ERSTEN Bildes in den Speicher.

            for(c
= 0; c < 19200; c++)

                VideoBuffer[c]
= hurikData[c];

Kopiert die Bilddaten des ERSTEN Bildes in den Speicher.

        }

Ende der Tastenifabfrage.

        if(!(*KEYS
& KEY_RIGHT))

        {

Siehe oben. Genau das Gleiche, nur halt passiert hier was bei
der rechten Taste.

            for(c
= 0; c < 256; c++)

                BGPaletteMem[c]
= slideshowPalette[c];

Kopiert die Palette des des ZWEITEN Bildes in den Speicher.

            for(c
= 0; c < 19200; c++)

                VideoBuffer[c]
= slideshowData[c];

Kopiert die Bilddaten des ZWEITEN Bildes in den Speicher.

        }


    }

}

Erste Klammer ist das Ende der Tastenschleife. Zweite Klammer
schliesst die Endlosschleife ab, die das Programm am Leben lässt. Die
letzte und dritte Klammer schliesst das Programm ab.



So jetzt noch eine Übersicht aller Tasten:

KEY_A

KEY_B

KEY_SELECT

KEY_START

KEY_RIGHT

KEY_LEFT

KEY_UP

KEY_DOWN

KEY_R

KEY_L

So, ich denke, dass alles Selbsterklärend ist.

Also das wars schon! Also viel Spass mit eurem Wissen und
macht jetzt schön mit dem 2 Teil des Tuts weiter, mit DMA. Viel Spass!

src="http://andreas.abi-2005.org/devgba/artikel/hurik/dt3/t3-3.jpg" width="240" height="160">

Hier sieht man gut, dass die Pallete kopiert wurde, aber
nur die halben Bilddaten. Einfach nicht schön. Und was machen wir jetzt?
Nein, wir benutzten nicht einen Bildmodus mit Backbuffer! Warum? Das wäre
zu einfach! Ausserdem will ich das ihr DMA lernt. Also dann startet mal
die Rom "t3-2.gba", und schaut euch das an, und ihr werdet sehen,
dass hier das Programm genau gleich ist, bis auf das, dass keine Grafikfehler
entstehen. Aber bevor wir das Programm auseinandernehmen, ein paar Informationen
zu DMA. DMA heist DirectMemoryAcces. Und mit DMA können wir Daten von
A nach B kopieren und das noch schnell, um genau zu sein verdammt schnell,
und schneller geht es nicht (Auf dem GBA.)! Also was mit DMA zu kopieren
ist der schnellste Weg. Und das brauchen wir hier. Denn der andere Weg
war zu langsam. Es gibt 4 verscheidene DMA Modi.

#include "gball.h"

#include "hurik.h"

#include "slideshow.h"

int main(void)

{

    SetMode(MODE_4 | BG2_ENABLE);

Bis hier ist alles wie oben! Aber nun was ist das das unten? Sieht seltsam
aus! Das schauen uns wir mal genauer an!

    REG_DMA3SAD
= (u32)hurikPalette;

    REG_DMA3DAD = (u32)BGPaletteMem;

    REG_DMA3CNT = 256 | DMA_16NOW;

Was ist den das für ein Gebilde? Da kopieren wir Daten mit
DMA. Und jezt erkläre ich das hier mal genauer.

REG_DMA3SAD ist eine Speicheradresse. Ihr seht das DMA3, dass sagt, dass
wir DMA 3 Modus benutzen. SAD steht für "Sourceadress" und,
das heist übersetzt "Quelladresse". Und das ist hier die Quelle,
woher wir die Daten kopieren. So einfach.

REG_DMA3DAD ist auch eine Speicheradresse, wer häts gedacht =) ! Die ist
genau so wie die da oben, bis auf dass statt dem S ein D da ist. Und das
DAD steht für "Destinationadress", und das heisst "Zieladresse".
Also das ist die Adresse, wo wir die Daten hinkopieren. Einfach oder?

REG_DMA3CNT ist auch eine Adresse, nur hier kommen jetzt Daten rein. Diese
Speicher Adresse ist etwas komplexer. Hier ein kleines Bild, das die Adresse
einfach mal ein bischen besser darstellt:

Ok, das wars schon. Wie gesagt echt einfach! Schaut mal in die gball.h
bei DMA. Da stehen ein paar Definitionen, wie ihr einfach die Werte setzen
könnt. Das wars schon. Echt einfach, oder? Ihr müsst ja nicht alle Hintergründe
wissen, so lange ihr könnts reicht das fürs erste. Aber es gibt noch eine
kleine Falle! Schaut euch das mal an.

    REG_DMA3SAD
= (u32)hurikData;

    REG_DMA3DAD = (u32)VideoBuffer;

    REG_DMA3CNT = 192000 | DMA_16NOW;

Hier kopieren wir die Bilddaten in den Speicher. Nur irgendwie
stimmt hier was nicht! Und was? Eigentlich müssten wir 38400 Bytes kopieren,
weil ja 240 * 160 = 38400. Aber jetzt werden die Bilddaten in 8 Bit Werten
gespeichert, aber wir kopieren 16 Bit Werte. Also müssen wir nur halb
so viel hinschreiben. Das wärs schon, und diesmal endgültig alles. Einfach
oder? Der Rest des Codes müsste selbsterklärend sein.

    while(1)

    {

        if(!(*KEYS & KEY_LEFT))

        {

            REG_DMA3SAD
= (u32)hurikPalette;

            REG_DMA3DAD
= (u32)BGPaletteMem;

            REG_DMA3CNT
= 256 | DMA_16NOW;

            REG_DMA3SAD
= (u32)hurikData;

            REG_DMA3DAD
= (u32)VideoBuffer;

            REG_DMA3CNT
= 192000 | DMA_16NOW;

        }

        if(!(*KEYS & KEY_RIGHT))

        {

            REG_DMA3SAD
= (u32)slideshowPalette;

            REG_DMA3DAD
= (u32)BGPaletteMem;

            REG_DMA3CNT
= 256 | DMA_16NOW;

            REG_DMA3SAD
= (u32)slideshowData;

            REG_DMA3DAD
= (u32)VideoBuffer;

            REG_DMA3CNT
= 192000 | DMA_16NOW;

        }

    }

}