 PP2bmp.bas
 A program that converts pp256 tilesets to BMPs
 by Richard Eric M. Lope BSN RN aka relsoft 2006
 http://rel.betterwebber.com
 Sample tileset by Adigun Azikiwe Polack and Relsoft
 Organic.put by AAP
 shootxxx.put by Rel(ripped)

 features:
 * converts pp256 files to linear bmps
 * converts pp256 files to multi frame bmps
 * converts variable sized tilesets
 * saves the indices for easy loading in any API (FBGFX, SDL, etc)
 usage:
 pp2bmp pp256filename pp256palette [flags]
 
 flags:
 --multi
    converts the file to BMPs in the /multi folder. One bmp per frame."
 --index
    converts the file to BMP then saves an index of how to load the
    tileset if it the size of each frame is different from each other.
 see convert.bat
 see convert_index.bat
 see convert_multi.bat

 notes:
 1. data pointers are in ushort for pp256 compatibility.
 2. the tileindex load helper is saved as "filename.txt"
    firstline = max_element to allocate or dim the  array that would
               hold the sprites.
    secondline = is the maximum number of images
    3rd line = is the current image index
    4th line
          1st entry = image number
          2nd entry = bmp x-pixel(column) you should start to "GET" from
          3rd entry = width of tile
          4th entry = height of tile
          5th entry = data pointer offset you should save the "GETted" frame
  PS. Since the data right now is in ushort format,  the data pointer offset
      should be multiplied by 2 if you are using bytes and divided by 2 if
      you are using integers. It's easy to figure out really. :*)


I have included a sample loader(loader.bas) for you to play with.

