Export Games and make Icon & Titlescreen



5 months ago

How to export games from the Arduino IDE to the SD card!

Get the binary

You can easily get the binary from the Arduino IDE:
either via "Sketch" -> "Export compiled Binary" or by hitting "Ctrl+Alt+S"

Export Binary via Arduino IDE

Now the compiled .bin file will appear next to your ino file:

ugly exported file path

The binary file is named example.ino.gamebuino_meta.bin, but that is a pretty long and ugly name, so let's just rename it to example.bin

cleaner renamed file

Now that we have the binary file, it is time to prepare the folder to put onto the SD card!

Folder of the SD card

The binary file is supposed to land in a folder with the same name (except if you specified a different one in config-gamebuino.h). It should look like this:

Simple game folder

Now toss that folder onto your SD card next to your other games and it sould appear in the game loader! You will see, however, that it is lacking both an icon and a title screen. We'll get to that in a bit.

Default iconDefault titlescreen

Adding an icon and a title screen

The icon and the title screen are added in the same way: You need to create a normal BMP image with an image editor you prefer. Even though you have all the colors available, it is still recommended to stick to the colors of the Gamebuino Palette.

The icon is a 32x32 pixels BMP named ICON.BMP, while the titlescreen is an 80x64 BMP named TITLESCREEN.BMP. Simply add both to the folder of your game and copy the folder back over to the SD card. In our example they are both just blue background with "yay" in yellow written on them.


Of course, your game should have more a more recognizable icon and title screen than this.


Grabbing the GMV files

You may have noticed some longer pause before it displayed the icon and the title screen. This is becaus the Gamebuino converted the BMP file to it's own internal format: a GMV file. Now, if you also put the GMV file into your game folder, other people using your game won't have to wait that little pause (this especially makes a huge difference with animated title screens).

IMPORTANT: it isn't enough to just copy the GMV files from the SD card, you will have to copy both the BMP and GMV files. This is because the Gamebuino magically flags the BMP files as "Hey, there is a GMV file matching to this image"

When done, your game folder will look something like this:

with GMVs

Animated title screen

As briefly mentioned, a title screen can be animated! For that, just stack all your 80x64 frames vertically in your TITLESCREEN.BMP. The entire thing will be then played back animated, at 25FPS. This is, for example, a five-frame animation:

animated titlescreen frames

And this is what it looks like in the loader:


You may have noticed that the loading times are way higher here, that is because there is more frames to process. This is why it is strongly recommended to provide the GMV files when using an animated title screen.

View full creation


NEW 2 months ago


J'ai essayé d'exporter mon appli mais le résultat est bizarre.

J'ai fait une icône et un titlescreen mais l'îcone qui s'affiche dans le menu ne ressemble pas à celui que j'ai fais et de plus le titlescreen ne s'affiche pas.

J'ai copié mon dossier avec le programme (.bin) et mes deux BMP (ICON et TITLESCREEN) mais ça bug.

Il y a t'il un cache à supprimer ? Ou une manipulation complémentaire au copier-coller du dossier ?

Merci d'avance


NEW 2 months ago

Ton programme (.bin) doit s'appeler comme le dossier dans lequel tu le mets. ICON.bmp et TITLESCREEN.bmp doivent être dans ce dossier et sauvegardés en 24 bits par exemple et là ils apparaiteront comme ils le doivent. Je suis en vacances alors si tu reposes une question ne t'tonnes pas si je mets du temps à répondre  ;)


2 months ago

Merci jicehel !

J'avais exporter mes images en 256 bits, mon erreur était là.


NEW 2 months ago

jicehel jicehel

Merci jicehel !

J'avais exporter mes images en 256 bits, mon erreur était là.


NEW 2 months ago

Super  ;)   Bonne soirée et bon début de création


NEW 1 month ago

Great tut!


NEW 1 month ago

Super tuto. I'll update my titilescreens when i'll be back after these so short holidays ...

Very simple, very useful when you start to make your first games. Dans un prochain tuto tu devrais expliquer comment utiliser le config-gamebuino.h (où il faut le mettre, ce que l'on peut faire avec et comment)


NEW 2 days ago

something something "title screen. This is becaus "
Because because needs a "e" at the end because else it would be incomplete

You must be logged in in order to post a message on the forum

Log in