home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / developm / source / macraysh.sit / RAYSHADE-M.README
Encoding:
Text File  |  1992-06-21  |  4.8 KB  |  138 lines
  1. Welcome to Rayshade-M !
  2.  
  3. Addendum - 6/21/92 - Paul Shields
  4. Below are some notes from the author of Rayshade-M, I would like to add a few comments to those.
  5.  
  6. Because the author has included all the source code and is encouraging others to continue work on Rayshade-M I would be interested in finding out if anyone is interested in starting a small group devoted to improving Rayshade-M. I would be willing to serve as a central coordinator for any efforts, ensuring that there was only one version that contained the most up-to-date version of the project.
  7.  
  8. If there is any interest in this please contact me at
  9.  shielp@rpi.edu.
  10.  
  11. Paul Shields
  12.  
  13.  
  14.   Rayshade-M is a Macintosh port by Adam Lock, of the poular Unix ray tracer
  15. Rayshade. The original rayshade was written by Craig Kolb and others. The 
  16. source has been taken from version 4 patch 0, with some additions from other
  17. patch releases.
  18.  
  19.   For the first time it is possible to design a scene from within the ray 
  20. tracer itself, and make changes online. This makes the task of constructing 
  21. scenes much easier than previously. It is no longer necessary to learn 
  22. the Rayshade scene description language, since everything is controlled 
  23. through windows and dialogues. Because the scene is represented visually,
  24. it is possible to 'fine tune' a scene without the laborious task of 
  25. continually rendering test images. Once the scene is finished, a rayshade
  26. script can be generated which is compatible with all other versions.
  27.  
  28. I have added a few features which make Rayshade-M much better suited to the
  29. Macintosh:
  30.  
  31.   - Fully reentrant code. Rayshade-M is capable of loading more than one
  32.     script per application lifetime.
  33.  
  34.   - Full control of rendering thorugh the Macintosh WIMP system.
  35.  
  36.   - On screen image generation
  37.  
  38.   - Images saved in PICT format
  39.  
  40.   - Built scene editor allows the user to create new scenes and alter existing
  41.     ones. The scene is shown on-screen in a 3 window orthographic projection,
  42.     and as an object list.
  43.  
  44.   - Script generator. A script is generated from the scene being editted, which
  45.     is compatible with all other versions of Rayshade. The generator currently
  46.     has no support for animation, or external files such as color maps.
  47.  
  48. Because of time restrictions, I was unable to include any editor support for
  49. CSGs, animation or some types of light. Scenes which contain any of these are
  50. still parsed and rendered, however the editor does not allow for creation or
  51. manipulation of these objects.
  52.  
  53. In order to run Rayshade-M you will need:
  54.  
  55.   - Mac II with at least 4 megs free, a math coprocessor and 32bit 
  56.     Color QuickDraw
  57.  
  58.   - 640x480 resolution monitor (or better). 24 bit displays will produce the
  59.     best on-screen representation of what the image looks like. Monitors with
  60.     less colors will show a dithered version of the image.
  61.  
  62.  
  63. The Future
  64. ==========
  65.  
  66. I am no longer in the position where I am able to fix the bugs or add new
  67. features to rayshade-M. Therefore, I have included the source so that if you
  68. think the program has potential, you can change things yourself. I have
  69. included my email address at the end of this .readme so that you know where
  70. to reach me if you have to. Please note that this address expires at the 
  71. end of June 1992 !
  72.  
  73.  
  74. Contents
  75. ========
  76.  
  77. In rayshade-M.sit:
  78.  
  79.    Ray               -     executable
  80.  
  81.    Source            }
  82.    Headers           }
  83.    rayshade.pi.rsrc  }---  Source code, project and resource files
  84.    adsANSI           }
  85.    rayshade.pi       }
  86.  
  87.    Pix               -     Directory of example pictures in PICT format
  88.  
  89.    + Some Examples
  90.  
  91. In rayshade-M.manual.sit:
  92.  
  93.    rayshade-M.manual -     Some user documentation
  94.  
  95.  
  96. The user documentation is a bit old. I did have a more recent syntactically
  97. correct version, but I cant find it !
  98.  
  99.  
  100. Known major bugs
  101. ================
  102.  
  103.   - Window refreshes get extremely irritating with large scenes
  104.   - Scripts must be located in the Rayshade-M directory
  105.   - Object deletion is flawed and fails sometimes
  106.   - Large object lists are often corrupted
  107.   - Texturing mapping looks odd at higher ray tree depths
  108.  
  109.   + Plus numerous smaller bugs
  110.  
  111. The motto here is save often !
  112.  
  113.  
  114. Wishlist
  115. ========
  116.  
  117.   - Wireframe 3d preview
  118.   - Replacement of the object creation dialogue with a drag and click style
  119.     design system
  120.   - Editor support of animation and CSG
  121.   - Fractal heightfield generation
  122.   - No bugs !
  123.   - Better memory management
  124.   - Support for extra features which have been produced for Rayshade, such as
  125.     rotsplines, projectors, colored blobs etc.
  126.   - Better object orientation within the code
  127.   - Image mapping using PICT input files
  128.   - Support for the Utah Raster Toolkit.
  129.   - Support for atmospheric effects such as fog & mist
  130.  
  131.  
  132.  
  133. ===============================================================================
  134.   o      Adam Lock cmp9133@sys.uea.ac.uk
  135.  < \
  136.  / >     University Of East Anglia, England
  137. ===============================================================================
  138.