Développement GameBoy #6 : La couche « Background »

Afficher / masquer la couche Background

Pour commencer, on va parler des deux macros permettant d'afficher et de masquer la couche Background.

Par défaut, la couche est masquée, il faudra donc la rendre visible si on veut être en mesure de tester les exemples suivants :

SHOW_BKG;

Et on peut la masquer à nouveau via la macro suivante :

HIDE_BKG;

Copier des tiles dans la mémoire vidéo

Pour afficher des tuiles, il faut commencer par les copier dans la mémoire vidéo, cela se fait à l'aide de la fonction suivante :

void set_bkg_data(UINT8 first_tile, UINT8 nb_tiles, unsigned char *data);

• first_tile : la case mémoire à partir de laquelle on va placer les tuiles (si on met 16 par exemple, la première tuile de notre tileset se trouvera dans la case 16, la seconde dans la case 17,... C'est ce numéro que l'on retrouvera dans la tilemap).
• nb_tiles : nombre de tuiles à copier dans la mémoire vidéo.
• *data : pointeur vers les données de nos tuiles.

Je ne remets pas d'exemple pour cette fonction, on en a déjà un de bien détaillé dans l'article « Développement GameBoy #4 : Afficher des images »

Afficher des tiles (et les relire)

Une fois les tuiles dans la mémoire vidéo de la GameBoy, il faut lui indiquer où les afficher. Pour ce faire, il faut lui fournir une tilemap.

Pour envoyer une tilemap dans la mémoire vidéo, il faut utiliser la fonction suivante :

void set_bkg_tiles(UINT8 x, UINT8 y, UINT8 w, UINT8 h, unsigned char *tiles);

• x, y : Coordonnées de destination de notre tilemap (là où elle sera collée sur la couche Background). Les coordonnées sont exprimées en tuiles (entier entre 0 et 31).
• w, h : Largeur et hauteur de notre tilemap, exprimées en tuiles (entier entre 0 et 31).
• *tiles : pointeur vers les données de la tilemap.

Cette fois encore, un exemple est disponible dans l'article « Développement GameBoy #4 : Afficher des images ».

En plus de nous permettre de coller des tilesmaps sur la couche Background, GBDK nous fournit une seconde fonction permettant de récupérer ces données (pour savoir à quoi ressemble la couche à un instant donné) :

void get_bkg_tiles(UINT8 x, UINT8 y, UINT8 w, UINT8 h, unsigned char *tiles);

• x, y : Coordonnées d'origine de la zone à copier, exprimées en tuiles (entier entre 0 et 31).
• w, h : Largeur et hauteur de la zone à copier, exprimées en tuiles (entier entre 0 et 31).
• *tiles : pointeur vers un tableau où seront copiées les données. Attention, il faut bien penser à allouer suffisamment de mémoire pour contenir les données (par exemple 56 octets si w = 8 et h = 7).

Par exemple, si on veut dupliquer une partie de la couche Background, on peut écrire le code suivant :

void main(void) {
    // Tableau suffisamment grand pour stocker le contenu que l'on va copier
    UINT8 house[8 * 7];

    // [...] Mettre des trucs dans la couche Background

    // On duplique une partie de la couche Background
    get_bkg_tiles(5, 4, 8, 7, house);
    set_bkg_tiles(5, 12, 8, 7, house);
}

Déplacer / faire défiler le Background

GBDK nous fournit deux fonctions différentes pour déplacer le Background :

• scroll_bkg(), qui fait défiler la couche Background relativement à sa position actuelle,
• et move_bkg(), qui déplace la couche à la position absolue demandée.

void scroll_bkg(INT8 x, INT8 y);

• x, y : déplacement à appliquer (par exemple +1, -1,...). Attention, cette fois-ci, le déplacement est exprimé en pixels et non en tuiles !

void move_bkg(UINT8 x, UINT8 y);

• x, y : coordonnées où l'on souhaite déplacer la couche Background (coordonnées du coin en haut à gauche de l'écran). Les coordonnées sont exprimées en pixels.