View source for Displaying full-screen images

== Software needed ==
* [http://gbdk.sourceforge.net GBDK]
* [http://www.yvan256.net/projects/gameboy/PCX2GB-v215.zip pcx2gb]
* [http://www.gimp.org GIMP]

== Step 1 ==

Open the image you want to be displayed on the GB in the GIMP.<br>
[[Image:burger1.png]]<br>

Now we need to make this image an 8 bit pcx file.<br>
[[Image:burger2.png]]<br>

Go to Image -> Mode -> Indexed and change the max number of colors to 8.<br>
[[Image:burger3.png]]<br>

Resize the image to fit the GB's screen size.<br>
[[Image:burger4.png]]<br>

Save the image as a pcx file.<br>
[[Image:burger5.png]]<br>


== Step 2 ==

Now use this command with the image you saved in the same folder as pcx2gb:<br>

<pre> pcx2gb n d *imagenameyousaved*.pcx *tilesfilename*.c *mapfilename*.map</pre> 

Press enter a few times and your tiles and map files will be generated.<br>
Note: the screen may "glitch" up a few times and then turn black. This is normal. If you're stuck in the window, then CTRL+Tab out to return back. Also, the filename may need to be limited to 6 characters and not use hyphens. If the program doesn't work it's possible that the image was not in proper 4 color mode, but PCX2GB will not warn you of this.


== Step 3 ==


Now create your file to actually display the image on the GB.

<pre> 
#include <gb/gb.h>

#include "tiles.c"
#include "map.map"

void main()
{
     // Load up the tile data
     set_bkg_data(0,255,tiledata);

     // Switch to VRAM
     VBK_REG = 1;

     // Switch out of VRAM
     VBK_REG = 0;

     // Set screen x,y pos to 0,0 and draw the map 20,18(size of the screen)
     set_bkg_tiles(0,0,20,18,tilemap);

     // Show the background
     SHOW_BKG;

     // Turn the display on
     DISPLAY_ON; 
}
</pre> 


== Compile and done ==

After compiling and running my output looked like:<br>
[[Image:Gbburger.PNG]]