home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-3.iso / Graphics / 3d / ThreeD.06.README < prev    next >
Encoding:
Text File  |  1996-05-15  |  5.2 KB  |  136 lines
  1. -------------------------------------------------------------------------
  2. ThreeD  -  Version 0.60  -  September, 1995  -  by Kieran Jones
  3. -------------------------------------------------------------------------
  4.  
  5. 1. System Requirements
  6.  
  7.    Platforms:    Quad-fat MAB for Next, Intel , HP and Sun.
  8.  
  9.    O/S:        NeXTSTEP Version 3.3
  10.  
  11.  
  12. 2. Distribution
  13.  
  14. ThreeD is distributed as a compressed tar file called ThreeD_06_NIHS.tar.Z. It contains the following two files:
  15.  
  16.     ThreeD.app            quad-fat application file
  17.     ThreeDmanual.rtfd        reference manual file
  18.  
  19. ThreeD is freeware. You may freely copy, distribute and use the program 
  20. and its reference manual. All copies of the program should include the 
  21. on-line help files and the info panel identifying the program and its 
  22. author, and be accompanied by the complete contents of the reference 
  23. manual. Please see the "Legal Notes" section of the manual for the 
  24. standard legal disclaimers.
  25.  
  26.  
  27. 3. General Description
  28.  
  29. ThreeD is a basic three-dimensional scene modeling and rendering program 
  30. based on NeXT's 3DKit and Pixar's RenderMan. The program has the following 
  31. general capabilities:
  32.  
  33. - It allows the interactive creation of a 3-D scene consisting of a 
  34.   variety of basic geometric shapes such as cones, cylinders and spheres. 
  35.   The geometry, position and shader appearance of each shape can be changed at 
  36.   any time.
  37.  
  38. - Three variable light sources are available to illuminate the shapes in a 
  39.   scene.
  40.  
  41. - The camera can be moved about in a variety of ways within a scene to 
  42.   view the latter from any location.
  43.  
  44. - A scene can be saved to a file at any time and be read in later for 
  45.   further modification. Its RIB code can also be saved to a file.
  46.  
  47. - A scene can be rendered photorealistically at any time. The result is 
  48.   displayed on-screen and can be saved as a TIFF image file.
  49.  
  50. - A rudimentary animation capability allows a sequence of frames to be 
  51.   generated and played back, simulating shape motion.
  52.  
  53.  
  54. 4. Specific Release Description
  55.  
  56. ThreeD Version 0.6 is a minor update of the initial Version 0.5 release. 
  57. Version 0.6 incorporates the following changes:
  58.  
  59. 4.1 New Features
  60.    
  61. - Displacement and Light shader types are now supported. Prior to Version 0.6 
  62.   only Surface shaders were available. A new control has been added to the 
  63.   Shape Inspector panel to support multiple shaders.
  64.  
  65.   Note that although the interface allows all six RenderMan shader types to be
  66.   specified only the Surface, Displacement and Light types are actually
  67.   implemented and have any effect.
  68.     
  69. - Three additional spatial operations related to shapes are now available: 
  70.     
  71.     + Locate to shape:
  72.         
  73.     A shape can made to translate itself such that its origin is 
  74.     coincident with that of another shape or with the world space origin.
  75.         
  76.     + Orient with shape:
  77.         
  78.     A shape can be made to rotate itself such that its axes are oriented 
  79.     with those of another shape or with the world space axes.
  80.         
  81.     + Coincide with shape:
  82.           
  83.     Combines the above two operations, making a shape fully coincident in 
  84.     space with another shape or with the world space origin and axes.
  85.     
  86.     The manual has been updated to describe the use of these features.
  87.     
  88. 4.2 Bug Fixes
  89.     
  90. - Drag/dropping of custom shader files is now accepted only if they have a
  91.   ".slo" extension. Files having any other extension are ignored when 
  92.   dragged into the scene view. Prior to Version 0.6 dragging and dropping 
  93.   a file whose extension was not ".slo" crashed the program.
  94.  
  95. - The values of all shader arguments are now copied when duplicating a 
  96.   shape. Prior to Version 0.6 the shader arguments of a duplicated shape 
  97.   were set to default values, ignoring the actual values set for the original.
  98.       
  99. - Modification of shader parameters now causes ThreeD to regard the scene as
  100.   having been modified. Prior to Version 0.6 ThreeD failed to notice that shader
  101.   parameter modification changed a scene.
  102.  
  103. - Camera and shape translations now work correctly regardless of camera
  104.   orientation. Prior to Version 0.6 rotating the camera to certain 
  105.   orientations could cause translation displacements to become near-zero, 
  106.   making it impossible to translate the camera or shapes by the correct amount.
  107.  
  108. - The colour panel that is brought up when modifying a shader colour parameter
  109.   now stays on-screen after the parameter has been set.
  110.  
  111.  
  112. 5. Known Problems
  113.  
  114. In addition to the known problems listed in the manual, the following bugs 
  115. exist:
  116.  
  117. a) Specifying a .slo shader file containing invalid or corrupt shader data 
  118.    causes ThreeD to crash. ThreeD performs no checks on the validity of the 
  119.    contents of any shader files it uses. It assumes that any .slo file is a 
  120.    valid RenderMan shader language function and attempts to use it as such.
  121.  
  122. b) Saving a scene containing a shape that uses the "texmap" shader with its 
  123.    "texname" parameter undefined (value = "none") causes ThreeD to crash. The 
  124.    "texname" parameter must be set to the full pathname of a texture map file. 
  125.    Example texture map files are located in /NextLibrary/Textures/and have a 
  126.    file extension of .tx.
  127.  
  128.  
  129. 6. User Comments
  130.  
  131. Comments can be emailed to the author at the following address:
  132.  
  133.     kjones@vcn.bc.ca
  134.  
  135. Please note that the above new address replaces the old one given in the ThreeD info panel and reference manual.
  136.