home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d596 / rayshade.lha / Rayshade / ReadMe.Amiga < prev    next >
Text File  |  1992-02-01  |  4KB  |  92 lines
  1.                      Rayshade 3.0 - Amiga version 0.8
  2.  
  3.                                 August 1991
  4.  
  5. This  version of Rayshade for the Amiga has been compiled with SAS/C 5.10b.
  6. It  is  ported  over  from the UNIX version available in comp.sources.unix,
  7. which can be obtained via ftp from the uunet.uu.net server.
  8.  
  9. For documentation refer to rayshade.tex (has to be TeX'ed with troffman.sty
  10. from the tr2tex distribution) or rayshade.man.
  11.  
  12. The ZOO-files have been compressed with ZOO 2.10 from fish disk 527 and have
  13. to be extracted with the same version. To install rayshade to your harddisk
  14. (called DH0: here) you have to issue the following commands:
  15.  
  16. makedir dh0:Rayshade
  17. cd dh0:Rayshade
  18. df0:c/zoo x df0:Rayshade/RayshadeA
  19.  
  20.  
  21.                         Examples for using Rayshade
  22.  
  23. To process the example input file h2o.ray from the distribution, you type:
  24.  
  25. rayshade -R 64 64 -O h2o.rs h2o.ray
  26.  
  27. With a PAL A2000B & 68010 CPU  this image should be calculated in less than
  28. 5 minutes.
  29.  
  30. The  -R  option  above sets the resolution to 64 * 64 pixels, the output is
  31. written  to h2o.rs and can be processed with rs2fbm for quantizing with FBM
  32. (fbquant)  or  it  can  be  directly  fed  into  HamLab  to  produce  a HAM
  33. IFF-picture.
  34.  
  35. If  you  set  up  your own input file it's always best to begin computing a
  36. picture with low resolution (e.g.  64*64 or 128*128 pixels) and if the test
  37. picture  was fine, proceed to higher resolution for the final picture (e.g.
  38. rayshade -R 512 512 -O h2o.rs h2o.ray).
  39.  
  40. Raytracing  is  a  very time consuming task, so you should think of setting
  41. the  priority  of  your  cli/shell to -1 with "Changetaskpri -1" before you
  42. start  Rayshade.   A  stack  of 64kB should be enough for most input files,
  43. sometimes a stack of 100000 Bytes is required.
  44.  
  45. Because  I  had  too little spare time to clean up the sources (comment the
  46. changes)  I distribute it as context diffs to the original sources plus the
  47. amiga  specific files.  You can use Patch from fish disk 296 to apply these
  48. patches  to  the  original sources, just type "Patch <diffs.flex" after you
  49. have copied the amiga specific files in your source directory.
  50.  
  51. If you distribute this program, please distribute it always in complete form:
  52. RayShadeA.zoo                Documentation, examples & binaries, diffs.flex
  53. RayShade30.zoo               The original Rayshade 3.0 source
  54.  
  55. The  68020 & 68881 version (you really must have *BOTH* to use it) is named
  56. RS_881.  This version has been compiled with -m2 and -f8 options and should
  57. be tested a bit more (any volunteers ?).
  58.  
  59. ---------------------------------------------------------------------------
  60. rs2fbm  is  a utility for conversion of Rayshade output to FBM format.  FBM
  61. is a image manipulation toolkit for image file format conversion (PCX, IFF,
  62. GIF,  Sun raster files etc.), resizing of images, color quantization and so
  63. on.     The    Amiga   version   of   FBM   is   available   via   ftp   at
  64. rusmv1.rus.uni-stuttgart.de.
  65.  
  66. Usage: rs2fbm input.rs [output.fbm]
  67.  
  68.        if output.fbm is omitted, then the output is written to stdout.
  69. ---------------------------------------------------------------------------
  70. Rayshade output can be converted to HAM-IFF-images with Hamlab, a shareware
  71. program also available at rusmv1.rus.uni-stuttgart.de. The Amiga version of
  72. tr2tex is available at the same site.
  73. HamLab is also on Fish disk 466.
  74. ---------------------------------------------------------------------------
  75.  
  76.  
  77. This Rayshade version was ported to the Amiga by:
  78.  
  79. Martin Hohl
  80. Robert-Leicht-Strasse 132
  81. W-7000 Stuttgart 80
  82. F.R. Germany
  83.  
  84. eMail:       zrzo0370@rusmv1.rus.uni-stuttgart.de
  85.              zrzo0111@helpdesk.rus.uni-stuttgart.de
  86.  
  87.                                 DISCLAIMER:
  88. In  no  case  the authors of rayshade will be responsable or liable for any
  89. damages  or  losses  of  data  you might have by using the Amiga version of
  90. Rayshade.   Using  Rayshade  is  at  your own risk.  Since Rayshade is free
  91. software it comes without any warranty.
  92.