******* BMP2PP *******
PowerPaint image utilities
Version 1.1 for Win32

Copyright (C) 1997  Marcel de Kogel

Hardware and Software Requirements
•	MS-Windows 95 or MS-Windows NT 4.0 or higher
•	8MB RAM (16MB Recommended)
•	A desktop size of at least 800x600. High colour or true colour mode highly recommended
•	A fast 486 or better microprocessor highly recommended

The latest version of this project can always be found on the ADAMEm distribution site at http://www.komkon.org/~dekogel/adamem.html

What's included
•	BMP2PP.exe	The executable
•	BMP2PP.rtf	This file

Installing and uninstalling
To install this software, copy BMP2PP.exe and BMP2PP.rtf to the same directory and run BMP2PP.exe. To uninstall, delete BMP2PP.exe, BMP2PP.rtf and BMP2PP.ini. The program does not make any changes to the registry, nor does it install any files in the WINDOWS and WINDOWS\SYSTEM directories.

PowerPaint file formats supported
These programs support the following file formats:
•	10k binary
•	40k workspace image
•	80k workspace image
PowerPaint files should have attribute $10 (user file) and file type 2 (Z80 binary).
The file format is as follows:
10k binary:
$0000-$13ff  	Pattern table of 256x160 image
$1400-$27ff	Colour table of 256x160 image
40k and 80k workspace images:
$0000-$13ff	Colour table of first cell (256x160 image)
$1400-$27ff	Pattern table of first cell
$2800-$3bff	Colour table of second cell
$3c00-$4fff	Pattern table of second cell
...
The cell layout is:
-------- --------
|cell 1| |cell 2|
-------- --------
-------- --------
|cell 3| |cell 4|
-------- --------
...
The first 16 columns of every cell are unused.
Please refer to a TMS9918 manual for a detailed description of the pattern and colour tables.

Available options
Colours
•	Palette: Select the colour palette you'd like to use in the converted images
•	Gamma: Select gamma-adjustment to apply to the bitmap image, 100 means no adjustment. Decrease this value to make your converted images darker, increase it to make them brighter
•	Brightness: Select brightness-adjustment to apply to the bitmap image, 50 means no adjustment
•	Convert to greyscale: Set this option to convert your bitmap images to greyscale prior to converting them to PowerPaint images
•	Create monochrome picture: Set this option to create black & white PowerPaint pictures
Dithering
•	Method: Select between no dithering, first-pass dithering, second-pass dithering and full dithering. If you convert images with few colours, e.g. screenshots from older home computers or game consoles, the conversion may look better when disabling dithering. The only advantage of one-pass dithering above full dithering is increased speed
•	Maximum error: Select a maximum dithering error. Decrease this if your PowerPaint images look too blurry, increase it if dithering seems to have too little effect
•	Noise level: Select dithering noise level. Increasing this might help remove visible patterns in your PowerPaint images
•	Weights: Select dithering error weights. If your PowerPaint pictures are to be displayed on older television sets, you might want to alter these to prevent too many isolated pixels. 3,5,7,1 and 1,7,5,3 are among the many usable alternatives
Scaling
•	Method: Select bitmap scaling method. Note the aspect ratio of the image will remain fixed
•	Use linear interpolation: Reset this option to disable linear interpolation when scaling images. When scaling very small images, the converted images might not be sharp enough when this option is set
Miscellaneous
•	Centring: If you want your PowerPaint images to be centred in a certain area, you can select it here
•	Filter: Select filter to apply to the bitmap image. The following filters are available:
•	Smooth: Smoothens the image a small amount
•	Smooth +: Smoothens the image a large amount
•	Detail: Enhances the detail of the image
•	Edge enhance: Enhances the edges of the image a small amount
•	Edge enhance +: Enhances the edges of the image a large amount
•	Find edges: Removes everything but the edges of the image
•	Contour: Makes the edges of the image dark and the rest bright
Of most use are the detail, edge enhance and edge enhance + filters
Please note that the only option that has effect when converting PowerPaint images to bitmap images is the palette option, but all are used when converting bitmap images to PowerPaint ones

TMS9918 palette
  Nr	Colour	R,G,B
  0	Transparent	unused
  1	Black	0,  0,  0
  2	Medium green	71,183, 59
  3	Light green	124,207,111
  4	Dark blue	93, 78,255
  5	Light blue	128,114,255
  6	Dark red	182, 98, 71
  7	Cyan	93,200,237
  8	Medium red	215,107, 72
  9	Light red	251,143,108
  10	Dark yellow	195,205, 65
  11	Light yellow	211,218,118
  12	Dark green	62,159, 47
  13	Magenta	182,100,199
  14	Grey	204,204,204
  15	White	255,255,255

Default V9938 palette
  Nr	Colour	R,G,B
  0	Transparent	unused
  1	Black	0,  0,  0
  2	Medium green	32,192, 32
  3	Light green	96,224, 96
  4	Dark blue	32, 32,224
  5	Light blue	64, 96,224
  6	Dark red	160, 32, 32
  7	Cyan	64,192,224
  8	Medium red	224, 32, 32
  9	Light red	224, 96, 96
  10	Dark yellow	192,192, 32
  11	Light yellow	192,192,128
  12	Dark green	32,128, 32
  13	Magenta	192, 64,160
  14	Grey	160,160,160
  15	White	224,224,224

Legal issues
This software may be used free of charge and may be distributed freely, as long as the archive isn't modified in any way and no profit is made from distributing it. Also, this software comes without any warranty, neither express nor implied: Use at your own risk.

History
1.1	30-07-1997	Fixed several bugs, cleaned up code and documentation, added some options
1.0a	18-07-1997	Fixed a bug that caused random access violations
1.0	17-07-1997	Initial release

Please send your comments to Marcel at
m.dekogel@student.utwente.nl