home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-Update.iso / NEXTSTEP / graphics / 3d / Geomview.README < prev    next >
Encoding:
Text File  |  1997-05-29  |  9.0 KB  |  231 lines
  1. Geomview is an interactive geometry viewing program written by the
  2. staff of the Geometry Center (mostly Daeron Meyer, Tim Rowley, Stuart
  3. Levy, Tamara Munzner, and Mark Phillips).  It can be used as a
  4. standalone viewer for static objects or as a display engine for other
  5. programs which produce dynamically changing geometry.  The current
  6. versons run on the following platforms:
  7.  
  8.     SGI IRIS workstations,
  9.     Sun4 workstations running X
  10.     Dec alpha workstations running X
  11.     HP workstations running X
  12.     486 PCs running Linux and X
  13.     probably many other Unix workstations running X
  14.     NeXT workstations
  15.     HP workstations running NeXTStep
  16.     486 PCs running NeXTStep
  17.  
  18. The distribution files are listed below.  Each of these names is
  19. actually a symbolic link to a file in this directory; the link always
  20. points to the most recent version of the corresponding file.
  21.  
  22. IMPORTANT: see the section on PATCH FILES at the end of this file to
  23. determine whether you also need to get any of the patch files along
  24. with the distribution files described here.
  25.  
  26. Each of the files below contain the entire Geomview distribution,
  27. including documentation, example files, and external modules.  Files
  28. ending in .Z are compressed with the standard Unix program "compress".
  29. Files ending in ".gz" are compressed with GNU compress (gzip) and are
  30. generally smaller than the corresponding .Z file, but you need gzip to
  31. uncompress them.  In all cases, the .Z and .gz files contain the same
  32. data; you only need to get one of the two.
  33.  
  34. geomview-sgi.tar.Z:
  35. geomview-sgi.tar.gz:
  36.     Compiled binaries for the SGI IRIS.  Uses GL graphics; this is
  37.     the fastest version of Geomview.  If you have an IRIS, get
  38.     this one.
  39.  
  40. geomview-next.tar:
  41.     Compiled binaries for the NeXTStep operating system.  This
  42.     contains fat binaries which will run on either a NeXT
  43.     workstation, 486 PC, or an HP workstation running NeXTStep
  44.     3.x.  Uses Quick Renderman graphics.
  45.  
  46. geomview-alpha.tar.Z:
  47. geomview-alpha.tar.gz:
  48.     Compiled binaries for the Dec alpha; uses XLib graphics.
  49.  
  50. geomview-sun4.tar.Z:
  51. geomview-sun4.tar.gz:
  52.     Compiled binaries for Sun4 workstations; compiled using SunOS.
  53.     Uses XLib graphics.  IMPORTANT: If you use Open Windows you
  54.     need to also get and apply the patch file
  55.     "geomview-1.5.0-sun4-patch1.tar.Z".  See PATCH FILES below for
  56.     details.
  57.  
  58. geomview-hp.tar.Z:
  59. geomview-hp.tar.gz:
  60.     Compiled binaries for HPUX; uses XLib graphics.
  61.  
  62. geomview-linux.tar.Z:
  63. geomview-linux.tar.gz:
  64.     Compiled binaries for Linux; uses XLib graphics.
  65.  
  66. geomview-rs6000.tar.Z:
  67. geomview-rs6000.tar.gz:
  68.     Compiled binaries for IBM RS6000; uses XLib graphics.
  69.  
  70. geomview-src.tar.Z:
  71. geomview-src.tar.gz:
  72.     The source code distribution --- includes source for all
  73.     versions of Geomview: SGI(GL), X, and NeXTSTep (Quick
  74.     Renderman).  The X version is known to compile on the
  75.     platforms listed above, and probably will compiled with
  76.     hopefully minor modifications on other Unix/X platforms.
  77.  
  78. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
  79.  
  80. manual.tar.Z:
  81.     The Geomview manual.  The manual is included in each of the
  82.     above distributions, but is available in this separate file in
  83.     case you just want to look at the manual without downloading
  84.     an entire distribution.  This manual file (manual.tar.Z) also
  85.     includes a dvi version of the manual, and separate PostScript
  86.     versions of the figures (these things are not part of the
  87.     regular distributions).
  88.  
  89. We recommend getting the binary distribution unless you specifically want
  90. to look at or modify the source code.  The source code takes anywhere
  91. from 15 minutes to 1.5 hours to compile, depending on the machine.
  92.  
  93. Disk space required:
  94.  
  95.     geomview-alpha.tar.Z, untarred               8 MB
  96.     geomview-hp.tar.Z, untarred                      7 MB
  97.     geomview-linux.tar.Z, untarred               8 MB
  98.     geomview-next.tar, installed              19 MB
  99.     geomview-sgi.tar.Z, untarred              17 MB
  100.     geomview-sun4.tar.Z, untarred              11 MB
  101.  
  102.     geomview-src.tar.Z
  103.     source only, untarred                  14 MB
  104.     source, compiled for SGI only              86 MB
  105.     source, compiled for Sun only              50 MB
  106.     source, compiled for Next (triple fat) only     142 MB
  107.  
  108.       Editing makefiles/Makedefs.global to set COPTS = -O
  109.       rather than the default COPTS = -g yields:
  110.  
  111.     source, compiled for SGI only, COPTS=-O          47 MB
  112.     source, compiled for Sun only, COPTS=-O          27 MB
  113.     source, compiled for NeXT, (triple fat), COPTS=-O 62 MB
  114.  
  115.  
  116.  
  117. Here is a list of CHANGES occuring from version 1.4.3 to version 1.5
  118. ====================================================================
  119.  
  120.    Substantial improvements to the 3D graphics in the X11 version of Geomview:
  121.     - Uses X Shared Memory extension (when available) for
  122.         quick rendering of polygons and lines to X11 framebuffer
  123.     - Support for 1, 8, or 24 bit deep X displays added
  124.     - Optional dithering for 8 bit displays
  125.     - Dithers 1 bit displays
  126.     - Optional zbuffering (for hidden line/surface removal) added
  127.     - Smooth shading added
  128.     - Support for line thickness > 1 added
  129.     - Clipping planes added
  130.  
  131.    Numerous fixes/additions to the X11 Geomview Motif interface:
  132.     - Window positioning commands work (under most window managers)
  133.         except for the Load and Save panels
  134.     - fixed edit menu
  135.     - added ability to type in RGB values in color panel
  136.     - added numeric displays for sliders on material panel
  137.     - added option menu on camera panel for choosing
  138.         hidden surface removal method
  139.     - added toggle button on camera panel for activating/deactivating
  140.         dithering of colors (only shows up in 8 bit mode)
  141.  
  142.    Unlike the beta-release X graphics, the new version transmits complete
  143.     images, not polygons, to the X server.  It's faster for local
  144.     displays; can be slow when the display-to-geomview connection
  145.     traverses a slow network link.
  146.  
  147.    Geomview motions:
  148.  
  149.      INCOMPATIBLE bug fix in the GCL command language:
  150.     Motions defined with respect to the object itself, e.g.
  151.      (transform world world world translate 0 0 1)
  152.     had been interpreted with the wrong sign.  This is now fixed.
  153.     Application programs which depended on this bug (including gvclock
  154.     and stereo) need to change accordingly.
  155.  
  156.      Documentation fix: GCL rotations (transform/transform-incr/transform-set)
  157.     are given in radians, not degrees.
  158.  
  159.      New motion-animation commands:
  160.     The (transform ...) command now allows a simple form of animation.
  161.     If given an amount of time, it arranges to move by exactly that amount
  162.     during approximately that many seconds, either at constant speed
  163.     or with smooth start and stop.
  164.  
  165.      Scaling now happens with respect to the selected "center" object,
  166.     not the object's own origin.  There's a new (transform ... scale ...)
  167.     subcommand.
  168.  
  169.    Keyboard input:
  170.      New (event-keys) and (event-pick) commands can suppress geomview
  171.     interpreting keyboard input as commands and rightmouse-clicks as
  172.     picking, in graphics windows.  Useful for modules which want to impose
  173.     their own interpretations on events.
  174.  
  175.    Non-Euclidean spaces:
  176.      Newly created cameras now correctly live in the current (possibly
  177.     non-Euclidean) space.   They had been always Euclidean,
  178.     despite misleading window titles.
  179.     
  180.    N-D projection:
  181.      New "nOFF" object is a collection of 0-, 1- or 2-dimensional polygons
  182.     in N-dimensional space.
  183.      N-D coloring projection axes can be with respect to any coordinate system.
  184.  
  185.    Two-sided surface coloring:
  186.      The "backdiffuse" material field, if defined, is interpreted as the
  187.     reverse-side's diffuse color.  Works whenever software shading
  188.     is enabled (i.e. always on generic-X systems); also works on those
  189.     SGI systems whose hardware supports two-sided GL lighting.  There's
  190.     no control panel for this feature yet but GCL commands can, e.g.
  191.     (merge-ap world { material { backdiffuse .7 .5 0 } })
  192.  
  193.  
  194.    There were a number of portability improvements in the X version,
  195.     fixing bugs for Sun/Solaris, HP-UX, Linux, DEC OSF, AIX.
  196.  
  197.    Code is now more careful to avoid floating-point exceptions, which
  198.     cause trouble on some machines.
  199.  
  200.    Yacc and lex, which were needed for one library, are no longer essential.
  201.  
  202.  
  203. PATCH FILES
  204. ===========
  205.  
  206. The following patch files apply to version 1.5.0.  To apply one of
  207. these patches, unpack the patch file in the same directory where you
  208. unpacked the distribution file.  Both the distribution and the patch
  209. files untar to create a subdirectory called Geomview; the patch files
  210. untar on top of the distribution --- they replace and/or add files to
  211. the existing tree.
  212.  
  213.     geomview-1.5.0-sun4-patch1.tar.Z:
  214.     geomview-1.5.0-sun4-patch1.tar.gz:
  215.     This fixes a bug which causes the Open Windows server to crash
  216.     when Geomview is run.  If you want to use Geomview with Open
  217.     Windows, you must get this patch.  You can apply this patch to
  218.     the sun4 binary distribution, and/or to the source-code
  219.     distribution.  To apply to the sun4 binary distribution, just
  220.     unpack it.  To apply to the source distribution, unpack it and
  221.     then follow the instructions in the file
  222.     Geomview/README-sun4-patch1.
  223.  
  224.     geomview-1.5.0-patch1.tar.Z
  225.     geomview-1.5.0-patch1.tar.gz
  226.     This patch provides some files that are missing from all of
  227.     the above distributions and which are necessary in order
  228.     to run certain external modules.  In particular, you need
  229.     to get this file if you want to run the NDview, NDdemo,
  230.     and Not Knot Flythrough modules.
  231.