------------------------
Teddy Painter 0.01 alpha
------------------------

Please, Please, Please, At least read section 3 and 6.  If you do now, and 
then complain to me about it, I will have my vengence (being A Life in Hell, 
I am on good terms with Satan.  yhbw.)

Oh yeah, bits of this doc are out of date :).

Catch me at alih@wow64.org!

1. License.
	Get the boring shit up here where you can see it ;).  All the files
	contained within are licensed under the terms of the GNU GPL.  See
	the file "COPYING" for the boring text. We now return to your regulary 
	scheduled program.

2. What you need.
	To run this under DOS, you need:
		a) A 386 or better.  My code is not well optimized though, so
		you are better off something better, and it does stuff like
		interlacing by blitting, so u prolly need vesa or pci bus to
		really be effective.  Apologies in advance. (Yo Sorex :)

		b) VGA or better.  Oh come on, doesnt everyone? ;)

		c) A mouse.  With driver.
		
		If you wanna compile on this platform, you will also need
		Allegro, and djgpp (PGCC varient *strongly* reccommended!)

	To run under Linux, you need:
		The same stuff as per DOS, and additionally
		SVGAlib, working.  Newer version can aparently use VESA 
		now, so *most* people should be able to run this.  I dont
		know how to code X, but see the TODO if you wanna code an
		X windows version.

		If you have all this, you should be able to compile (you do
		have gcc, right? :) just fine.


3. A short note.
	Back in September, 1997, I had the idea to code a c64 painter for PC.
	I did, and it was crap.  So in December, I re-coded it from scratch.
	A few times.  Then, I added lots of useless features, and played with TGA import
	far too much.

	To cut a long story short, From Febuary '98 to August '98, I really 
	did fuck all on it.  Then, I got prodded, and re-coded bits to make
	it not crash, after Light showed interest in it (Yo!).

	From August until October, It stagnated again.  It was destined
	to sit on my drive forever.  I decided to release what I had under 
	the GPL, in the hope that (a) Somone would prod me, so more gets done,
	and more importantly (b) Someone else writes some code for it :).

	So, yes, it is unfinshed, unoptimized, and just plain crap.  The code
	is full of ugly hacks, yes.  Some stuff just plain doesnt work, yes.
	So read the TODO file, load up painter.c, and fix it, dammit!.

4. So, what can it do then.
	Okay.... It can edit pics for the C64, that's what!.
	It handles Multicolor, Multicolor Interlace, FLI, Interlaced FLI,
	AFLI, and Hires.
	It has palette orginisation, although this *really* needs improvment.
	Zoom, grid, etc.

5. What is missing?
	The major things that *neeeeeeed* coding are (more are in the file
	"TODO")
		1) Cut and Paste.  Really.
		2) Add a mask layer when calling filters, prolly linked to
		cut'n'paste.
		3) make it more configurable.
		4) Change the RGB-IN code to use floyd/steinberg dithering.
		   Infact, totally re-write this code.  (see include/rgbout.c)
		5) Better Dialog Boxes.
		5) Other stuff that I have forgotten.

6. What is Really broken.
	RGB saving totally doesn't work.	

	Saving Files smaller than 320x200 usually doesnt work atm.  Use
	"Crop to screen" first to avert this.

	Usuable but with known problems are TGA import (Must be 24 bit, RGB,
	uncompressed Only), RGB import (effects Both TGA import, and Plugins) 
	

7. How do I operate it?
	First, you can start with a file by giving it as an argument to the
	exe (so "paint demopic/demoifli.pic" to see the demo pic).

	Once in the program, The following should be of help:
		1) Hold the right mouse button to see the toolbar.  Color
		change is here, too, and the default color is black (Yeah,
		I know this was wrong ;).
		2) To change the grafix mode, Select "Image Properties" 
		   from the "Type" Menu.  This will also Re-Calculate all the
		   color squares.
		3) To create a new pic, Go to the file menu and select "New".
		4) for Multiple point stuff (Like Line, Etc), Click once, then
		   click again at the end.  You will see a preview :).
		5) play with all the stuff on the menu ;).  Most of it should
		   be self explanitory after a while ;).

8.  What Shorcuts are available?
	'1': Freehand Tool
	'2': Line Tool
	'3': Connected Lines
	'4': Circle Tool
	'5': Horizontal Fill
	'6': Flood Fill
	'7': Gradient Fill
	
	'p': Fillmask Fill (Used for filling multiple sections with one
	     gradient :)

	'[', ']': Decrease/Increase Pencolor.
	
	'+', '-': Decrease/Increase Pensize.

	'o': Palette Editor

9.  Who do I blame for this crap?
	A Life in Hell (ALiH for short ;).  E-mail him at alih@wow64.org, and
	your complaint will be blisfully ignored (joking! :).  Or speak to 
	him in his natural habitat of #c-64.

10.  Anything else?
	Yeah, If you wanna re-write this doc, e-mail me!.  If you wanna code
	on this, *PLEEZE* e-mail me.  If you wanna gimmie Money/a synth,
	*PLEEZE PLEEZE* e-mail me.  If you wanna spam me, send me votesheets,
	advertise x99, advertise anything that I dont want, Fuck Off!.
