
Randim version 5.0
Adrian Robert, 04/2001

Program to generate images using iterated function systems with randomized
parameters.  See randim.doc for further description.

Written for Unix with X11R5 or later.

Tested on:	Linux 2.0.x, 2.2.x R6
		IRIX 5.3, R5
		SunOS 4.1.3, R5


Compilation
-----------

1) Edit the Makefile as desired.  The main thing likely to change is the
   variable for the lib directory, which is where the program looks for the
   default colormap file "randim.map".  (Other maps can be used as well; see
   below.)  You can also set where the binary will be installed.  You might
   need to set the location of your X libraries.

2) Type "make".

Most portability problems are likely to be with either the "isnan()" call in
drawprep.c (try isnanf() if you don't have isnan()), or with the shift
parameter used for generating random numbers (see init() in randim.c and the
function apply_trans() in draw.c).


3) Type "make install" to install the binary in the 'BINDIR' you specified in
   the Makefile and all of the files in the 'Colormaps' subdirectory in the
   'LIBDIR' you specified.


Running
-------

The program is run by the command 'randim'.  If you give it an argument it
will treat it as the name or path of a colormap file to open to use in place
of the default "$LIBDIR/randim.map".  It will search for the file or path both
from the directory in which you invoke randim and in the LIBDIR.

The colormap files are in the same format as for the popular fractal drawing
program "Fractint".  In fact, the files included with this distribution were
taken from an earlier distribution of the X-windows version of Fractint.  The
format is simple: each line specifies a color in the format 'r g b', where
each color is specified by a decimal number between 0 and 255 inclusive.
Currently randim will only accept such files that have 256 color entries in
them -- i.e., that have a full 8-bit-sized colormap.



Enjoy!

