home *** CD-ROM | disk | FTP | other *** search
/ Encyclopedia of Graphics File Formats Companion / GFF_CD.ISO / formats / p3d / spec / p3d_gen.txt < prev   
Encoding:
Text File  |  1994-06-01  |  8.7 KB  |  204 lines
  1.             PSC P3D VERSION 2.2 AVAILABLE
  2.             -----------------------------
  3.  
  4.    The fifth release of the Pittsburgh Supercomputing Center's P3D
  5. software is now (finally!) available.  This software uses lisp with slight
  6. extensions to store three-dimensional models; we are using it as the
  7. standard format for 3D models within the PSC.  A simple lisp
  8. interpreter is included with the P3D release, so there is no need to
  9. have access to any vendor's lisp to run this software.
  10.  
  11.    The copyright to the P3D software is owned by Carnegie Mellon
  12. University, of which the Pittsburgh Supercomputing Center is a
  13. department.  We copyright it so that no one can grab it and market it
  14. as their own.  Feel free to copy it and distribute it around your own
  15. site, and to modify it.  We ask that you do not redistribute it, as we
  16. want new users to get it from us so we can keep track of it and
  17. maintain a mailing list.  If you have modifications to the code or bug
  18. reports, or would like to arrange to redistribute it, please contact
  19. us.  This code is provided 'as is' without expressed or implied
  20. warranty;  the PSC makes no representations about its suitability for
  21. any particular purpose.
  22.  
  23.  
  24. HIGHLIGHTS
  25.  
  26. The most fundamental change with this release is that the P3D interpreter
  27. now stores geometrical implementation in a much more compact form.  This
  28. will allow models of roughly twice the earlier size to fit in a machine's
  29. physical memory.
  30.  
  31. There have been numerous improvements to the Motif user interface to
  32. the P3D interpreter.  That interface can now generate flybys of P3D
  33. models, for example.  The interface will also link and run with the
  34. GL renderer on Silicon Graphics and IBM RS6000 platforms.
  35.  
  36. The DrawP3D library has been improved considerably.  Two interactive
  37. renderers, a version of the Painter renderer and an interface to Silicon
  38. Graphics GL, have been added.  This means that programs calling
  39. DrawP3D can now draw directly to a workstation screen.  Numerous bugs
  40. have also been patched.
  41.  
  42. MarchP3D has been completely rewritten to take advantage of the new
  43. functionality of DrawP3D, and now uses DrawP3D's isosurface routine
  44. rather than that from the Scry package from Lawrence Berkeley Labs.
  45. This is now a much more useful and flexible tool.  It can, for
  46. example, now do on-screen rotations of the isosurfaces it generates.
  47.  
  48. The Sun Phigs renderer has been rewritten to match the new version of
  49. Sun Phigs, and will link and run with the Motif or Xview user interfaces.
  50.  
  51.  
  52. RENDERERS
  53.  
  54. The P3D software currently supports nine renderers.  They are:
  55.  
  56. Painter, a Painter's Algorithm renderer.  This runs on just
  57. about everything, but requires the PSC's DrawCGM library and
  58. can only draw flat-shaded polygons.  If you need the DrawCGM
  59. library, get the GPlot software distribution by anonymous
  60. FTP from calpe.psc.edu, in the directory pub/gplot.
  61.  
  62. Silicon Graphics Inc. GL language renderer interface.  This
  63. is the recommended renderer for SGI workstations and IBM R6000
  64. workstations.
  65.  
  66. Generic Phigs renderer interface.  This renderer should work with
  67. only minor modification on any implementation of Phigs, but because
  68. (like generic Phigs) it does not handle light sources it is not
  69. the recommended renderer on any platform.
  70.  
  71. Sun Phigs+ renderer interface.  This renderer works with
  72. Sun Phigs.  Try this renderer if you have a Sun platform, 
  73. and if you don't like the results, switch to the Painter 
  74. renderer.
  75.  
  76. DEC Phigs+ renderer interface.  This renderer should work with
  77. DEC Phigs.  It is the recommended renderer for DEC platforms
  78. with 24 bit displays and graphics accelerators, for example
  79. accelerated DECStation 5000's.  For 8 bit DECStations, one might
  80. want to try both this renderer and the Painter renderer.
  81.  
  82. Dore renderer, which is an interface to the Kubota Pacific Dore
  83. renderer software.  This is the recommended renderer for
  84. Stardent workstations.
  85.  
  86. Rayshade ray tracer renderer interface.  This renderer is an
  87. interface to Craig Kolb and associates' Rayshade ray tracer
  88. (version 3.0, patch level 5).  It produces some very nice images,
  89. very slowly.  The current implementation is a first release
  90. of the interaface and does not properly support all P3D
  91. model elements (for example, vertex colors).
  92. See the associated document in the 'doc' subdirectory for
  93. more information on the limitations of the renderer, but don't
  94. get too discouraged by them;  it can still do an excellent job
  95. on a wide range of models.  This renderer should run on any
  96. platform.  The Rayshade renderer also uses the DrawCGM library
  97. by default, but can be switched to using the Utah Raster Library
  98. by applying the proper -D option to the compilation of
  99. src/rayshade/outputp.c .  Note that some optimizing compilers
  100. have problems with some of the routines in src/rayshade;  if
  101. you have problems with the ray tracer try recompiling some or
  102. all of these routines without -O.  This renderer supports
  103. facilities for doing multiple scenes for animation purposes.
  104.  
  105. ART ray tracer interface.  This renderer is an interface to
  106. the ART ray tracer, distributed with the VORT package.  VORT
  107. is available by anonymous FTP from gondwana.ecr.mu.oz.au.
  108. This is currently the best free high-quality renderer for P3D.
  109. The ART folks have been very generous in supporting new
  110. features for us, and now almost all aspects of P3D are well
  111. supported.  This renderer also supports facilities for doing
  112. multiple scenes for animation purposes.  See doc/art_ren.t for
  113. further information.  This renderer interface should run on
  114. any platform.
  115.  
  116. Pixar RenderMan interface.  This renderer links against
  117. Pixar's RenderMan renderer interface to produce high quality
  118. rendered images.  This software is generally significantly
  119. faster than a ray tracer, for example ART.  The software was
  120. developed using Pixar's own Developer's Renderman product, but
  121. in theory it should work with any renderer with a
  122. Renderman-compatible interface.  Contact us if you don't have
  123. the library but are interested in an executable which can
  124. output models in the RenderMan 'RIB' format.  This renderer
  125. and Developer's Renderman should run on any Unix platform.
  126.  
  127.  
  128. GETTING THE CODE
  129.  
  130.    The code is available via anonymous FTP from the machine
  131. ftp.psc.edu.  If you do not already have the PSC's GPlot and DrawCGM
  132. software, you can get that also from the same machine.  (You will need
  133. GPlot/DrawCGM if you are using the Painter renderer, which is the
  134. recommended renderer on machines lacking special 3D graphics
  135. hardware).  To install the software on a Unix system, do the
  136. following:
  137.  
  138.   - FTP to ftp.psc.edu (internet address 128.182.62.148).
  139.  
  140.   - Log in as anonymous, with your name as password.
  141.  
  142.   - cd to the directory pub/p3d (the GPlot software is in pub/gplot).
  143.  
  144.   - Set file transfer mode to Binary or Image.
  145.  
  146.   - Get p3d_2_2.tar.Z, (or p3d_2_2.tar if your machine doesn't
  147.     have the 'uncompress' utility).
  148.  
  149.   - Move the tar file to an otherwise empty directory on your machine.
  150.  
  151.   - Uncompress the tar file with the command 'uncompress p3d_2_2.tar'.
  152.     If this doesn't work, you should have gotten the uncompressed
  153.     version;  see above.
  154.  
  155.   - Extract the contents of the tar file with the command 
  156.     'tar -xvf p3d_2_2.tar' .  (On Silicon Graphics machines, you
  157.     will want to use the command 'tar -xvof p3d_2_2.tar'.)
  158.  
  159.   - Follow the directions in the README file contained in the tar file.
  160.  
  161. To install the software on a VMS system, do the following:
  162.  
  163.   - FTP to ftp.psc.edu (internet address 128.182.62.148).
  164.  
  165.   - Log in as anonymous, with your name as password.
  166.  
  167.   - cd to the directory pub/p3d (the GPlot software is in pub/gplot).
  168.  
  169.   - Get tar2vms.c, a freely distributable tool copyrighted by Sid Penstone,
  170.     Dept. of Electrical Engineering, Queen's University, Kingston, Ontario,
  171.     Canada K7L3N6.
  172.  
  173.   - Set file transfer mode to Binary or Image.
  174.  
  175.   - Get p3d_2_2.tar, giving it the local name p3d_2_2.tar .
  176.  
  177.   - Move the tar file and tar2vms.c to an otherwise empty directory on 
  178.     your machine.
  179.  
  180.   - Compile and link tar2vms.c.  It's a stand-alone program needing no
  181.     libraries except the usual sys$library:vaxcrtl.olb.
  182.  
  183.   - Give the following commands to unpack the tar file:
  184.  
  185.       $ assign p3d_2_2.tar tape
  186.       $ tar2vms:== $dev:[directory]tar2vms.exe   
  187.                   (where dev and directory are your current default device
  188.                    and directory).
  189.       $ tar2vms xv
  190.  
  191.   - Follow the directions in the README file contained within the tar file.
  192.  
  193.  
  194.    If you get this software, please send your name and network address
  195. to me at welling@psc.edu so that we can send you announcements of
  196. updates and bug fixes.  If you find bugs, that is also the address to
  197. which to send the bug reports.
  198.  
  199.  
  200. -Joel Welling
  201.  Pittsburgh Supercomputing Center
  202.  welling@psc.edu
  203.  
  204.