Picture Maker V1.3 by Philippe Gervaise aKa CandyMan
----------------------------------------------------

- ?!? What's this ?
> Easy, it's a program to make pictures on your TI89 !!
- Cool, but how it works ?
> Easy (yeah).
- Yes ... But how ?
> Ah ? OK ... let's go :

	Eventually, before launch PicMaker if you must modify pictures
	(to save to a correct format with the correct size).

	Valid file formats are :
	  BMP : Windows Bitmap
          -> 8  BPP (256 colors)
          -> 24 BPP (16 Millions colors)
          -> IMPORTANT !! Horizontal size must be a multiple of 8
          -> IMPORTANT !! Vertical size must be a multiple of 2
          -> Uncompressed
	  GIF : Graphic Interchange Format, Compuserve format
          -> Any number of colors (from 2 colors to 256 colors)
          -> 87a version or 89a version (87a is best)
          -> Non Interlaced
          -> One or more pictures (animation)
        ICO : Windows Icon
          -> Any size (16x16 to 64x64 and more)
          -> Any number of colors (from 2 colors to 16 Millions of color)
          -> One or more (if more than one, ask the user to choose an icon)
          -> UnCompressed
        ANI : Animated Cursor
          -> Any size
          -> Any number of colors
          -> UnCompressed

	You have two way to execute Picmaker :
	  _Normal Way  : Just launch without any parameters. A file browser
	    will appear.
	  _Extende Way : You can indicate which files you want to transform.
	    The file browser will not appear. With this you can transform
	    a lot number of files in one time. For this use a filemask
          (*.bmp for example).
          

	When the file/files is/are chosen, choose the output format :
	   _ASM file : For asm programmers, it convert files into text data.
	     In this case choose base format (binary, decimal or hexa). Planes
	     are written with the DoorsOS putsprite convention (for each
	     plane).
         _Picture file : Default output format. It make a file ready
	     to send to the TI (an expression).

	After, you have to choose the numbers of colors. It's 2, 4 or 8. I think
	the best is 4 (8 is not a real 8 gray level mode). In multiple files, you
	choose the number of colors for all files.

	Then, the program start to create file (or files) ready to send to
	the TI (Expression).

- Thanks
> What ?
- Nothing
> Nothing what ????
- Bye
> Eh !!!
- ...


Source is no longer available because it's too big (it's about 75Ko,
3300 lines and the archive is big enough ...).




Bug(s) :
--------
   For few GIFs there is a problem ...




Be careful :
------------
   If the program crash with a runtime error, check if the problem
is from you (as bad file, disk errors ...). Else there is a problem
with the source picture (bad file, unrecognized header ...).
   Don't forget that pictures (except GIF) must have an horizontal
that can be divided by 8 and a vertical size that can be divided by 2.




What's new (See pv.txt) :
-------------------------
  Multiple files by command line.
  Now Support 256 color bitmaps (3 times lower than 16 Million color).
  Now Support GIF files (any colors, any number of pictures).
  Now Support ICO files (any colors, any number of pictures).
  Now Support ANI files (any colors).




Contact :
---------

You can send me a mail at :
	CandyMan@i-france.com (or CandyMan@ifrance.com)

There is also my web page :
	http://www.i-france.com/candyman
or    http://www.ifrance.com/candyman
