GPaint32 1.1 - small painting tool for the GP32
-----------------------------------------------



HISTORY:
--------

Thanks for feedback, I tried to implement all features for now.
Special thanks for showing me additional possibilities like using this tool
for creating raw images for Mr.Spiv's b2fxec and telling about input filters
for various graphics packages.

1.1 - Some Bug fixes, mainly loading images works now correctly.
      Added quite a few features, took away some:
      
      + added 90 rotating w/ left shoulder button (thx woogal)
      + added possibility to clear to bg-colour in menu (thx woogal)
      + added index number in palette menu (thx woogal)
      + added colour grabbing with right shoulder button (thx delsabre)
      + changed cursor position in palette menu to current color (thx delsabre)
      - export to .h function died for now (might do a perl/python converter
        for this possibly as it's not such a pain in the ass to do string
	manipulations there)
      - switching colours using shoulder buttons has gone.


1.0 - Initial crap release



1. ABOUT GPAINT32
-----------------

I was looking for a decent possibility to do artwork compliant to the standard
GP32 color palette. The only way I've come across was using Paintshop Pro with
a premade GP32 palette and then convert the picture to a c-header-file for use
with my GP32 projects. But using a demo version of Paintshop Pro, converting
that stuff and especially using windows is not what i consider decent. ;)
After i spent a couple of thoughts on doing a small linux painting tool, I
thought, what the heck, do it for GP32. This way you exactly know how the
image really looks like on the machine. After doing some tests I found drawing
on my GP32 quite entertaining.



2. WHAT DOES IT HAVE?
---------------------

GPaint32 has only one mode at the moment, a 32x32 grid for painting tiles and
sprites. It has a fore- and a background colour (A+B buttons) for quick
corrections, it uses the plain standard GP32 palette (it's okay except for
missing grey tones), it can save and load images without a lot of filename
hassles (more later), quick cycling through palette with the shoulder buttons.
And it has the possibility of exiting it. ;)



3. WHAT DOES IT LACK?
---------------------

- The 'Export to .h'-function doesn't work right at the moment.
- There is no 'Clear Screen' tool, in fact there are no line, circle and box
  tools either. ;)
- Tell me!



4. HOW DOES IT WORK?
--------------------

Directional Pad...			Control cursor in menus/grid
A/B in drawing screen...		Draw foreground/background colour
A/B in palette screen...		Select foreground/backgroudn colour
A in menu screen...			Activate menu item
Start...				Switch between menu screen and
					drawing screen
Select...				Switch between palette screen and
					drawing screen
Left Shoulder button...			Rotate image 90 clockwise
Right Shoulder button...		Grab colour under cursor as
					foreground colour


I thought a lot about entering filenames and stuff. The easiest way in my
opinion was to save the images with the filenames 'imgXX.img' where XX is a
number between 1 and 99 that you choose with left/right while in menu.



5. HOW TO IMPORT MY IMAGES TO [insert favourite gfx program]?
-------------------------------------------------------------

Although not designed for something like this, some people (thx delsabre &
woogal) found ways to import GPaint32 image files for PaintShop Pro and
TheGimp, I'll simply quote them here:

PSP (thanks delsabre):

"1) In the 'Files of type' dropdown list select 'Raw file format'.
 2) Open the IMG file
 3) A dialog box should appear asking you how it should format the image, 
 put in this info:
 
 Width: 32
 Height:32
 Color channels: Single channel (greyscale)
 Header size: 0
 Interleaved
 Order RGB

 When it opens up it will be in greyscale, and probably look funky. Just go 
 to 'Colors->Load pallete...' choose the GP32 .pal file and select 'Maintain 
 indexes' (if you haven't made a .pal file from the GP32 pallete yet open up 
 a 256 color bitmap that uses it and go to 'Colors->Save pallete...' then 
 save it)."

TheGimp (thanks woogal):

"Just found this plugin you can use to open the images in the gimp -
 http://www.ne.jp/asahi/linux/timecop/loader.html

 Select RAW as your file type, and enter 32 for the width and height 
 and Indexed as the image type. Then apply your gp32 palette."

The GP32 palettes for PaintShop and gimp are available from my page (thanks 
jegHegy and woogal for sending me).



6. WHAT ABOUT USING THOSE IMAGES FOR SPIVVY'S B2FXEC?
-----------------------------------------------------

Yeah right, woogal pointed me to the fact that those images are well suited
for using as app-icons for b2fxec. The only thing you'll need to do is rotate
your image 90 clockwise by pressing the left shoulder button once. Save the
image and use it with b2fxec:

b2fxec -t MyAppsName -a MyName -B img1.img myapp.bin myapp.fxe

I made the Icon for GPaint32 the same way. ;)




A lot of that stuff might change in the future, depending on the feedback I
get. As I did this one just as a quick'n'dirty tool for myself, I've done
almost all I need, but if someone begs for features, I might as well add them.


DonSkeeto

dnskt[at]gmx[dot]de / www.don32.tk
