Its a simple paint program for the palm that works in 2 and 4 bit grayscale and 8 bit colour. The program saves the bmp produced in the format used by the PToolBox Library for Pocket C which makes it a useful programmers tool as well as a bit of fun for the general palm user. Supports images of infinite size, or as much as your palm can handle!

Note: This program is Freeware. Use it at your own risk I can offer no guarantee.

Requirements - Works on any Palm or Handspring with version 2.0 or up of the Palm OS(I don't guarantee this but it should in theory)

Installation - You MUST install these files for the program to work correctly!

MADPaint.prc - Application File (All OS)

madpaintgui1bit.prc - 1bit GUI icons for MADPaint (All OS)

madpaintgui2bit.prc - 2bit GUI icons for MADPaint (OS3.0+)

madpaintgui4bit.prc - 4bit GUI icons for MADPaint (OS3.3+)

madpaintgui8bit.prc - 8bit GUI icons for MADPaint (OS3.5+)

PocketC.prc - Runtime Version for if you don't have PocketC

Mathlib.prc - Required by PocketC

PToolboxLib730.prc - Required by PocketC

These files are optional...

sample1bit.prc - 1bit sample image database for MADPaint (All OS)

sample2bit.prc - 2bit sample image database for MADPaint (OS3.0+)

sample4bit.prc - 4bit sample image database for MADPaint (OS3.3+)

sample8bit.prc - 8bit sample image database for MADPaint (OS3.5+)

To view the sample images first install the relevent file (1bit,2bit,4bit,8bit) and then when you start the program on your palm type 'sample' as the database name.

Choosing your File Name - Type a filename into the box that appears when you run the program

Choosing your Colour Depth - Type the appropriate number in the box that appears when you run the program (1 = Black and White, 2 = 4 grays, 4 = 16 grays, 8 = 256 Colours) If your palm is incapable of displaying the selected colour depth it will use the default of black and white.

Choosing the size of your image - You will be asked for the size of image when opening a new one, just enter the number of pixels wide and high you want the image. To change the size at any time simply press the pen onto the image size indicator in the top left of the screen.

Changing the grid size - Simply press on the grid icon in the bottom left of your screen and enter the number of pixels wide you want your grid segments to be.

Free Hand Pencil - Draws a line in the selected colour wherever you put tthe pen

Brush - Same as Free Hand but a thicker line

Rectangle - Draws a rectangle when you drag one out

Spray Can - I think you get the idea

Circle - Same as rectangle but a circle

Line - Draws a line where you drag

Blend - Blends together the pixels surrounding the one where you put the pen (Works best in 16 grays)

Flood Fill - Fills the selected shape with the current colour

Insert BMP - Draws the current bmp that has been loaded from memopad (See Advanced Section) or copied using the copy function wherever you put the pen

Rough Pencil - Overlays onto the colour under where you put the pen, produces an effect like a scratchy pencil.

Brightness - Shifts brightness of pixels under pen towards the selected colour.

Increase Contrast - Increases the contrast of an image where you put the pen.

Undo - One level of undo.

Move - Moves picture around inside frame.

Copy - Copies the selection that you drag out to the Insert BMP tool.

Colour Picker - Copies the colour you choose from the current image.

Text - Places the text you specify on the bitmap where you drag, in the current colour.

About - Tells you a little about the program and what the buttons do.

Aswell as using graffiti keys to shortcut to tools (even those that are not displayed on the screen) you can type the character 'a' to rotate an image 90 degrees clockwise (This only works for square images at present).

Datebook - Save Current Bmp

Phone Book - Load a Bmp

Page Up - Change tool set to one above the current

Page Down - Change tool set to one below the current

To Do - Load bmp form Memopad (See Advanced Section)

Memopad - Open Different File

PToolboxLib stores bmps in .prc files and numbers them from 0 upwards. This is why when you start a new file in MADPaint the current bmp number is displayed as "0 of -1".

If you open a bmp record with a number larger than the current number of bmps in the file then MADPaint will ask you to define the width and height of the new bmp in pixels. Note: if the current number of bmps in the file is 12 and you save a bmp into the record 15 it will be added to the end of the file as record number 13.

Loading a bmp from Memopad - To do this place the appropriate Hex string into a memopad record with a name on the first line, for example...

This is the code for a space invader like the one used for the icon of the Insert BMP function. Many programs are available to create these strings on your PC or Mac, and a lot of them are freeware. I would recommend the one I wrote - PalmBMP, for obvious reasons. However I also mention it because it can create codes in my own format for transfering grayscale and colour bitmaps to the palm using memopad. You can find it at my site...

When you press the To do button you will be asked to enter the name of the memopad record. Then you will be asked for the format of the record, for PocketC Hex format write P, and for MADant format write M. If you choose P you will then be asked for the width and height of the bmp.

You are now ready to insert your memopad bmp into the current bmp record you have open, simply select the Insert BMP tool and press on the screen where you want it, when you take your pen off again the bmp will be dropped onto the screen.

If you find any errors in the program or would like it explained better, or if you want to get me to add more too it; Don't hesitate to contact me at...

Special Thanks to Joseph Stadolnik for his library PToolBox. It truely is the essential tool for the Pocket C programmer! - Get Joe's library at his website...