home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-3.iso / Graphics / 3d / WireFrame.1.2.README < prev   
Encoding:
Text File  |  1992-06-14  |  5.8 KB  |  156 lines

  1.  
  2. Howdy.
  3.  
  4. WireFrame is a limited virtual reality/3D modeler consisting of 3D 
  5. wireframe (vector drawings) objects in a 3D space. It's not quite finished
  6. yet, but is interactive now, and quite cool. It's in colour too,
  7. so you'll benefit from seeing it like that on a colour monitor,
  8. and suffer slower redraw times too...
  9.  
  10.  
  11. ***** IMPORTANT *************************************************
  12.  
  13. Raytracer Output is in ppm format. You'll need Lennart Lovstrand's
  14. ImageViewer to view it. If you don't have ImageViewer set up as a default
  15. for ppm THEN DO NOT RAYTRACE!!!! It'll open up the images in Edit! (Yuck).
  16.  
  17. Right now it is possible to perform multiple raytracing jobs locally,
  18. but ONLY ONE PARALLEL JOB!!! If you do two distributed jobs, then
  19. they WILL overwrite each other. Well, they may, I don't really know
  20. since I didn't write the raytracer :-).
  21.  
  22. ***** IMPORTANT *************************************************
  23.  
  24. As well, William Heelan has written a distributed raytracer for the 
  25. NeXT. The parallel part is still in proof-of-concept mode, and 
  26. may take LOTS of hard disk space in /tmp when running (ESP. for 
  27. large images). The default is for single-machine mode. If you want
  28. to run in distributed mode, you need to have a list of remote 
  29. hosts in the file WireFrame.app/remotes. You can maintain and
  30. add/subtract from this list through a hosts panel in the application,
  31. accessable under "Actions" of the main menu.
  32.  
  33. You can only raytrace Light, Spheres and Planes at the moment,
  34. but we'll add more functionality in time.
  35.  
  36. Raytracer output is in ppm format. You'll need a special viewer
  37. for that, and hopefully you've gotten ImageViewer from the 
  38. archives to view this.
  39.  
  40. DON'T FORGET TO INCLUDE LIGHT IN YOUR SCENE!!!
  41.  
  42. I can't go on more about the Raytracer, because I'm too tired now,
  43. but I did try to make the interface as good as I could (for the 
  44. short term). Right now the raytracing terms are a little technical,
  45. and I plan to change that.
  46.  
  47. *******************************************************************
  48.  
  49. To install:
  50.  
  51. From the command line type
  52.  
  53.     tar fvx WireFrame1.1.tar
  54.     open WireFrame1.1.README &
  55.     open WireFrame1.1.pkg &
  56.     open WF_Worlds+Info.pkg &
  57.  
  58. And then press "Install" in the installer for both packages.
  59.  
  60. Alternatively, use a program such as Opener or UnTar by 
  61. double clicking the icon for WireFrame1.1.tar, and then
  62. double click the icons for the .pkg files.
  63.  
  64. SYNOPSIS
  65.     
  66. Changes from 1.1:
  67.  
  68. 1) Added a wireframe inspector, allowing for dynamic changes to the wire frame.
  69. 2) Linked in the ray tracer written by William Heelan.
  70.  
  71. Ray Tracer features:
  72.     Raytracing of spheres and planes
  73.     Distribution of raytracing across a network of NeXT machines
  74.     Transparency
  75.  
  76. 3) Added fields to the .wireframe discription:
  77.  
  78. "Author"
  79. "Info"
  80. "Index Of Refraction"
  81. "Specular Reflectance"
  82. "Diffusive Reflectance"
  83. "Specular Transmittance"
  84. "Diffusive Transmittance"
  85. "Specular Reflective Power"
  86.  
  87. 4) Jump To feature allows you to move any wireframe to any position, and allows you to move yourself to any position.
  88. 5) The rotate around selection feature now works properly. As well you can set the origin of rotation arbitrarily.
  89. 6) Added a hosts inspector that allows you to modify the list of remote hosts for distributed ray tracing
  90. 7) You can now set the background colour to be anything. 
  91. 8)  Made the default save, save to binary. The ascii version was just too flaky, but you can still read and write both versions, and can even intermix binary and ascii wireframes in worlds.
  92. 9) Added rotation around arbitrary centers. May be a little strange getting the hang of it though.
  93. 10) Added a "jump to center" that allows you to enter an arbitrary point which o move the viewer, or an object.
  94.  
  95. Changes from 1.0:
  96.  
  97. 1) Fixed a bug pointed out by Todd Nathan. If you drag in the 
  98. Instance browser past the end of the browser you'd crash every time.
  99. 2) Todd Nathan made a nice little tutorial on making wireframes
  100. by hand. I touched it up a bit and included it into the 
  101. distribution.
  102. 3) Everything is now set up for installation by the installer.
  103. The .world files won't be read unless you install WireFrame in
  104. ~/Apps or /LocalApps, etc. The installer does this for you now.
  105. 4) As well, the installer puts the .world files and the manual
  106. into ~/Library/WireFrame
  107. 5) Double clicking on a .world package will now start WireFrame
  108. and load the world into the WireView. I just added this a couple
  109. of seconds ago, so I don't know if it's entirely debugged...
  110.  
  111.  
  112. Changes from the old WireFrame0.6:
  113.  
  114. 1) Dynamic deletion of wireframes
  115. 2) selection of individual wireframes
  116. 4) transformation of selected wireframes
  117. 5) .world directories. These are just directories full of 
  118. .wireframe files. WireFrame1.0 recognizes these as a grouping
  119. of wireframes
  120. 6) read/write of .world directories
  121. 7) I built an editor, but it sucked so I disabled it. If you are 
  122. daring, you can extract the interface and undisable it. It really
  123. sucks though.
  124. 8) I've added a couple of new objects (Octagon, something else too...)
  125. 9) A quick print feature (doesn't work too well).
  126.  
  127.  
  128.  
  129. Future directions:
  130.  
  131. 1) This will be an animation package. It will send output of a scene
  132. to a raytracer, and give a shaded representation of the scene in 
  133. TIFF format.
  134. 2) I'm in the process of building a scripting engine. This will allow
  135. you to record a passage through the 3D world you've created, and play
  136. it back as a movie.
  137. 3) Better controls. I don't like what I have, there's just too many
  138. things to press. For the scripting, I'll build something like a 
  139. flight simulator's controls.
  140. 4) Animated wireframes. These will allow a set of wireframes to 
  141. describe several frames of an object. Thus when a wireframe moves,
  142. it'll animate...
  143. 5) Grouping of wireframes into a single wireframe would be good.
  144. 6) I'm going to build a cool game out of all this one day...
  145. 7) A better editor is on the way...
  146.  
  147.  
  148. If you have ANY ideas, or interesting worlds/wireframes, send them 
  149. to me!
  150.  
  151. - darcy
  152.  
  153. samurai@cs.mcgill.ca
  154. darcy@solutions.ca
  155.  
  156.