home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Fred Fish Collection 1.5
/
ffcollection-1-5-1992-11.iso
/
ff_progs
/
graphics
/
rayshad2.lha
/
ReadMe.Amiga
< prev
next >
Wrap
Text File
|
1992-08-05
|
5KB
|
108 lines
Rayshade 4.0 - Amiga release 0.5
June 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.
To run rayshade 4.0 PL6 a stack of at least 100000 bytes is needed.
Larger input files can even need 150000 or 200000 bytes (you can check this
with Xoper). The default value of 4000 bytes is not enough and will lead
to crashes soon after the start of rayshade. To set the stack to 100000
bytes you give the following AmigaDOS command in your shell:
stack 100000
+==========================================================================+
| Starting rayshade with a stack setting below 100000 is hazardous ! |
+==========================================================================+
For that reason I have included a checking routine which complains if you
have less than 100000 bytes stack available during start of rayshade. The
previous Amiga release (0.4) didn't have this checking routine (sorry).
If you have 81000005 gurus during termination of rayshade, the cause is
almost probably a wrong stack setting. In this case you should increase
your stack using the AmigaDOS "stack" command.
If you want to know your current stack setting use simply "stack" without
any parameters.
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: 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 have 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.