Préparer ses images pour la DS avec PAGfx

Un outil simple mais indispensable est livré directement avec PAlib. Utilisable en paramétrant un fichier de configuration ou en utilisant son interface utilisateur, PAGfx permet de convertir des images au format les plus courants : bmp, jpg, gif et png. Je vais vous présenter ici l’utilisation de PAGfx via son interface utilisateur.

Dossier PAGfx

Vous trouverez le logiciel dans le dossier de tools de PAlib : C:\devkitPro\palib\tools\PAGfx

J’ai créé un dossier images2convert qui contiendra mes images, il est important de noté que les images à convertir doivent obligatoirement se trouver dans le dossier ou un des sous-dossiers de PAGfx.

Le logiciel se lance à partir du fichier PAGC Frontend.exe. Vous pouvez passer par le fichier PAGfx.ini pour configurer directement votre conversion. Pour des raisons de simplicités (et un peu de fainéantise ^^), nous lancerons l’interface graphique.

Vous obtiendrez la fenêtre ci-dessous (avec son petit escargot).

PAGfx

Explication en quelques mots de l’interface. Vous pouvez voir 3 onglets pour les trois types d’images. J’ai déjà présenté les Sprites et les Backgrounds mais je n’ai pas parler des Textures. Comme vous avez peut-être devinez, elles sont utiles pour la 3D. Mais nous allons nous concentrer sur 2D ici.

Un élément important est le gros carré magenta par défaut qui représente la couleur de transparence. Elle peut être le blanc #FFFFFF, le noir #000000, le vert #00FF00 ou le magenta #FF00FF. En général on utilise le magenta ou le noir.

Passons à la pratique, sélectionnez l’onglet voulu puis cliquez sur Add File(s) en haut à gauche. Sélectionnez alors le ou les fichiers que vous souhaitez convertir.

Voici ce que ça donne pour un Sprite :

PAGfx Sprite

Filename et Path sont respectivement le nom et le chemin du fichier. ColorMode est nombre de couleurs utilisées dans le mode de compression de l’image, cela définit aussi le poids qu’aura l’image dans la RAM, plus il y a de couleurs plus c’est lourd, 256couleurs est le meilleur choix. Palette est le nom que vous utiliserez dans le code pour désigner un palette de couleur. Nous approfondirons le concept des palettes quand nous parlerons des sprites dans un prochain article.

Passons maintenant au Background :

PAGfx Background

C’est la même chose que pour les sprites. La seule différence est qu’on ne spécifie pas un mode de couleurs mais un type de Background, BgMode. Nous approfondirons ces différents types dans un prochain article sur les backgrounds.

Un fois tout ça définit, et bien c’est tout ! Il suffit de cliquez sur :

Si tout se passe bien vous verrez une fenêtre noire (une invite de commande) apparaitre quelques instants. Vous pourrez ensuite récupérer les fichiers générés dans le dossier de PAGfx comme ci-dessous. Pour chaque image convertie vous obtiendrez 2 fichiers : un pour l’image et un pour sa palette. En plus de ces fichiers vous obtiendrez 2 fichiers, all_gfx.c et all_gfx.h.

Fichiers générés dans le dossier PAGfx

Copiez tous ces fichiers générés (comme ci-dessus) dans le dossier source de votre projet. Pour utiliser vos images, ils vous suffit d’inclure les 2 fichiers all_gfx:

1
2
3

// PAGfxConverter Include
#include "gfx/all_gfx.c"
#include "gfx/all_gfx.h"

Tout est prêt pour commencer à rentrer dans le vif du sujet ! La prochaine fois nous commencerons à nous amuser avec les Sprites.