Rayshade 4.0 - Amiga release 0.4

                                 May 1992

This  version of Rayshade for the Amiga has been compiled with SAS/C 5.10b.
It  is  ported  over  from the UNIX version available via anonymous ftp at
weedeater.math.yale.edu (130.132.23.17) in pub/rayshade.4.0.
Rayshade v4.0 was written by Craig Kolb and Rod Bogart during 1990-1991.

For documentation refer to rayshade.tex (has to be TeX'ed with troffman.sty
from the tr2tex distribution) or rayshade.man.

Raytracing  is  a  very time consuming task, so you should think of setting
the  priority  of  your  cli/shell to -1 with "Changetaskpri -1" before you
start Rayshade.

Because  I  had  too little spare time to clean up the sources (comment the
changes)  I distribute it as context diffs to the original sources plus the
amiga  specific files.  You can use Patch from fish disk 296 to apply these
patches  to  the  original sources, just type "Patch <diffs" after you have
copied the files in your source directory.

If you distribute this program, please distribute it always in complete form:
rs40ami.zoo                Amiga binaries, diffs, makefiles
raysh4PL6.zoo              The original Rayshade 4.0 source, patchlevel 6

To generate rayshade for Amiga from the source code you have to do the
following:
1) unpack raysh4.zoo with zoo 2.1 and "cd" to directory "raysh4"
2) unpack rs40ami.zoo
3) "cd rayshade", apply rayshade.diffs with "patch <rayshade.diffs"
4) "cd" to "libray", apply libray.diffs with "patch -p <libray.diffs"
5) "cd" to "libshade", apply libshade.diffs with "patch <libshade.diffs"
6) "cd" to "etc/rsconvert", apply rsconvert.diffs with "patch <rsconvert.diffs"
Now the source code is ready to compile. In every directory there is a makefile
suitable for lmk. The makefiles are named as follows:
makefile         makefile for the plain vanilla 68000 version (FFP math)
makefile.20      makefile for 68020 & FFP version
makefile.881     makefile for 68020 & 68881 version
You will have to build libshade and libray before you can compile rayshade.

A  note  to  rsconvert:   The  makefile  and  the binary is a 68020 & 68881
version  only  for  now.  A 68000 version will follow on a later disk.  You
will  have to edit the converted Rayshade 3.0 input files and clean them up
before feeding it to rayshade 4.0.  Furthermore you almost probably will to
play  around  with  the  parameters  for reflectivity and specular color to
avoid the white spots in your picture.

Patch is on AmigaLibDisk 296.
A version of Zoo 2.10 is on AmigaLibDisk 527.

The  68020 & 68881 version (you really must have *BOTH* to use it) is named
"Rayshade.881".  This version has been compiled with -m2 and -f8 options.

A bug has been fixed since Rel.  0.3:  SAS/C 5.10B doesn't generate correct
code  for  (int)DoubleVar,  the  fix  was  to  use  (int)(floor(DoubleVar))
instead.  This bug was only in the version compiled with -f8 option.

---------------------------------------------------------------------------
rs2fbm  is  a utility for conversion of Rayshade output to FBM format.  FBM
is a image manipulation toolkit for image file format conversion (PCX, IFF,
GIF,  Sun raster files etc.), resizing of images, color quantization and so
on. The Amiga version of fbm is on the fish disks.

Usage: rs2fbm [-4] input.rs [output.fbm]

       if output.fbm is omitted, then the output is written to stdout.
---------------------------------------------------------------------------
Rayshade output can be converted to HAM-IFF-images with Hamlab, a shareware
program available on AmigaLibDisk 466.
---------------------------------------------------------------------------

This Rayshade version was ported to the Amiga by:

Martin Hohl
Robert-Leicht-Strasse 132
W-7000 Stuttgart 80
F.R. Germany

eMail:       martinh@solaris.tynet.sub.org


                                DISCLAIMER:
In  no  case  the authors of rayshade will be responsable or liable for any
damages  or  losses  of  data  you might have by using the Amiga version of
Rayshade.   Using  Rayshade  is  at  your own risk.  Since Rayshade is free
software it comes without any warranty.