(This file is word-wrapped to the length of this line; it's 80 characters long.)

This is a small program written in assembly language to calculate the Mandelbrot
set. It is currently has a very low version number, and for a reason; it's very
immature (new) software. It does no error-checking aside from checking the
number of arguments passed to it. (Run it without any arguments to see the usage
line.) Passing any string as the width or height which is not composed of only
numeric characters (0-9) is likely to cause the program to read your input as a
very high number, which will (likely) cause the sys_brk call to fail; however,
I do not detect this (yet), and thus it will try to write off the end of the
data segment, and segfault.

The output is 32-bit, uncolourmapped, uncompressed TGA. I might implement RLE
sometime in the future, (although I still don't really understand how TGA's RLE
is supposed to work,) but for now you can pipe the output to a file and open it
with an image viewer.

The number of iterations is hardcoded into the program. If you want to change
it, then you need to change the ITER equate in mandel.asm, change the ITER
define in mpalette.php, run mpalette.php, and then re-assemble mandel.asm.

This is a 32-bit program. It used to be 64-bit, but no more. 64-bit made zero
difference in this program.

This program is copyright (c) 2007 Geoffry Song (that's me! :) It's licensed
under the Artistic license, attached.

Files in this archive are:
This README
The LICENSE file, from OSI (LICENSE)
A precompiled binary (mandel)
(The following files are needed for assembly)
The source code (mandel.asm)
The palette (mpalette.inc)
The symbols.inc file from LSCR (included) (lscr/include/symbols.inc)
ASCII-to-Integer routine from Reverend (atoi.inc)
ASCII-to-Float routine from Reverend (atof.inc) (Not needed yet)
FASMLIB proc macros (proc.inc,proc32.inc)
FASMLIB idata/udata macros (data.inc)
(The following aren't neeeded, but were used by me in development)
A PHP script to generate the palette (mpalette.php)
A PHP version of the program, which was used as a base (mandel.asm)
The TGA header, used for development (tgaheader.*)
(Note: The TGA header is now in the main program itself, and is only here for
the sake of completeness.)
The rest of the LSCR package to comply with the license (lscr/*)



--UCM
