README file for SciGen 0.77b

Content of this README file:
--What's new in this version
--What does it do ?
--Bugs & things that dosen't work properly
--How to use


What's new in this version (0.77b)
=======================================
Two bug were fixed (hence the 0.02 addition to version number):
you can now generate 1bpp and 4bpp pictures.

0.77b
more bugs were fixed. most of them were created in the buggy-0.77 version.
code was cleaned a bit. and a bug that made 4bpp pictures being drawn weird
was fixed as well.
16-bpp reading that was enabled in 0.77a is once again disabled due to the fact
that I've no idea how does it color-thing works. it dosen't use a color table, nor
regular RGB code.


What does it do ?
========================================
SciGen can read BMP files and generate a lovely colorful-html file that will
look like the picture itself, only it will be using digits instead of pixels.



Bugs & things that dosen't work properly
========================================

Program does not read 16-bpp bmp files.



IF YOU FIND MORE BUGS AND THINGS YOU REALLY WANT TO REPAIR - DO IT YOURSELF. SOURCE IS FREE 
AND I'M OUT OF BUSINESS :-)




How to use
=========================================
There are three ways to use the program. the simple one: just double click on it and
follow the instructions.
the other simple one - just drag your bmp file over the program exe and drop it.
the 'advanced' way is to run the program with parameters:
scigen %1 [%2] [%3]
%1 - the input file name (with the BMP suffix)
%2 (optional) - if you want to use Widening, means, have two digits for each pixel
you should write 'W' or 'widening'.
%3 (optional) - if you want to have black-background (white is deafult) you should
write 'black' or 'b' in this parameter.

few examples:
scigen flower.bmp w b
will produce 'flower.html' file that uses widening and black background

scigen flower.bmp black
will produce a file that will use black-background with no widening.




HAVE FUN!

(for questions, always happy to answer. post to: Nope@galon.org.il)



FEW LAST NOTES TO ANY FUTURE DEVELOPERS:
I've added SciGen lots of remarks so it should be relatively easy to understand.
the 'structure' in the file is totally unnecessary, and is only a relic from the 
days this program used for something different.

version 0.77
just adding code and it's all look SO MESSY! bah, think I shoul've planned what to do
before started writing.

version 0.77b
didn't notice, but until this version program used to read the bytes (in 1 and 4 bpp)
from the end to the beginning. this caused a minor bug in 4bpp (switched between each
two near-pixels) and a big bug in 1bpp - program reversed eight pixels each time.
this bug is, however, fixed.
also added an option to use 16bpp. but noticed it dosen't use rgb color (but how can it?
only 2^16 numbers, while RGB needs 2^24),  nor color table (which is fine, couse color
table ot 2^16*3 bytes is kinda insane..).


that's about it.










