home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / modelers / geomview / source.lha / Geomview / README < prev    next >
Encoding:
Text File  |  1993-11-17  |  8.7 KB  |  227 lines
  1.                       Geomview/OOGL Release 1.4.1
  2.                          The Geometry Center
  3.               November 16, 1993
  4.               -----------------
  5.  
  6. INTRODUCTION
  7. ------------
  8.                                    
  9. This is version 1.4.1 of Geomview/OOGL. It runs on Silicon Graphics
  10. IRIS workstations, on NeXT computers under NeXTStep 3.0, and on NextStep/Intel
  11. under NeXTStep 3.1. Work is underway on an X version. 
  12.  
  13. Geomview is an interactive geometry viewing program.  OOGL, which
  14. stands for Object Oriented Graphics Library, is the library upon which
  15. Geomview is built.
  16.  
  17. NOTE: Please read the file REGISTER.  We need to know how our users
  18. are using Geomview so that we can better serve you.
  19.  
  20. In addition, if you use geomview please send an email note to
  21. geomview-users-request@geom.umn.edu requesting to be added to the
  22. geomview-users mailing list; this list is for announcements regarding
  23. geomview and for geomview users to communicate with each other.  See
  24. the details in the GEOMVIEW E-MAIL section below.
  25.  
  26. INSTALLATION
  27. ----------------
  28.  
  29. See the INSTALL file for installation details.  Disk space required:
  30.     geomview-next.tar, installed            15.5 MB
  31.     geomview-sgi.tar.Z, untarred            12.5 MB
  32.     geomview.tar.Z
  33.     source only, untarred                   7 MB
  34.     source, compiled for Next (fat binaries) & SGI     107 MB
  35.     source, compiled for SGI only              80 MB
  36.  
  37.       Editing makefiles/Makedefs.global to set COPTS = -O
  38.       rather than the default COPTS = -g yields:
  39.  
  40.     source, compiled for SGI only, COPTS=-O          61 MB
  41.     source, compiled for NeXT, fat binaries, COPTS=-O 52 MB
  42.  
  43. MORE ABOUT GEOMVIEW
  44. -------------------
  45.  
  46. Geomview represents the current state of an ongoing effort at the
  47. Geometry Center to provide interactive geometry software which is
  48. particularly appropriate for mathematics research and education.  In
  49. particular, geomview can display things in hyperbolic and spherical
  50. space as well as Euclidean space.
  51.  
  52. Geomview allows multiple independently controllable objects and
  53. cameras.  It provides interactive control for motion, appearances
  54. (including lighting, shading, and materials), picking on an object,
  55. edge or vertex level, snapshots in SGI image file or Renderman RIB
  56. format, and adding or deleting objects is provided through direct
  57. mouse manipulation, control panels, and keyboard shortcuts.  External
  58. programs can drive desired aspects of the viewer (such as continually
  59. loading changing geometry or controlling the motion of certain
  60. objects) while allowing interactive control of everything else.
  61.  
  62. Geomview supports the following simple data types: polyhedra with
  63. shared vertices (.off), quadrilaterals, rectangular meshes, vectors,
  64. and Bezier surface patches of arbitrary degree including rational
  65. patches. Object hierarchies can be constructed with lists of objects
  66. and instances of object(s) transformed by one or many 4x4 matrices.
  67. Arbitrary portions of changing hierarchies may be transmitted by
  68. creating named references.
  69.  
  70. Geomview can display Mathematica graphics output; for information
  71. on this see the file OOGL.m.doc in the "doc" subdirectory.
  72.  
  73.  
  74. EXTERNAL MODULES
  75. ----------------
  76.  
  77. Geomview comes with several "external modules" --- programs that
  78. communicate with geomview through a command language.  The list of
  79. currently installed modules appears in the "Applications" browser on
  80. geomview's main panel.  To invoke a module, click the mouse on the
  81. appropriate line in this browser.  The modules in this distribution
  82. are:
  83.  
  84. MODULE       PLATFORMS    DESCRIPTION
  85.  
  86. 4dview:        S    4-dimensional slicing & rotation
  87. CellularAutomata: S     cellular automata animation
  88. animate:    SN    flip through a sequence of objects
  89. clipboard:    S    cut, copy and paste geometric objects
  90. corners:    S    create vector skeleton of object
  91. crayola:    SN    interactively color objects
  92. drawbdy:    SN    compute and draw the boundary of an object
  93. flythrough:    S    interactive version of "Not Knot" hyperbolic flythrough
  94. ginsu:        S    interactively slice objects
  95. graffiti:    SN    draw line segments on objects
  96. gvclock:    SN    3D clock, demonstrates real-time motion
  97. hinge:        S    hinge copies of a polyhedron around its edges
  98. maniview:    S    3-manifold viewer
  99. nose:        SN    demonstrates picking
  100. pssnap:        SN    generate PostScript snapshot
  101. stereo:        S    hardware, crosseyed, red/cyan stereo (beta version)
  102. sweep:        SN    generate objects of rotation from line segments
  103. tackdown:    S    redefine an object's "home" position
  104. transformer:    S    explicitly control an object's transformation matrix
  105. trigrp:        S    explore triangle symmetry groups
  106. warp:        SN    interactively deform an object
  107.                                     
  108.     
  109. AUXILIARY PROGRAMS
  110. -------------------
  111.  
  112. PROGRAM        PLATFORMS    DESCRIPTION
  113.  
  114. anytooff:    SN    convert any OOGL object into OFF format
  115. bdy:        SN      compute the boundary edges of a geom as a VECT file
  116. geomstuff:    S    pipe your program's OOGL data to geomview via a pipe
  117. math2oogl:    SN    convert Mathematica graphics object to OOGL format
  118. offconsol:    SN      consolidate duplicate vertices in an OFF file
  119. oogl2rib    SN    convert OOGL to RenderMan RIB (see OOGL.m.doc)
  120. togeomview:    SN    pipe GCL commands or geometry to a copy of geomview,
  121.                   invoking geomview if necessary
  122.  
  123. (S means SGI version exists, N means NeXTStep version exists)
  124.  
  125. DOCUMENTATION
  126. -------------
  127.  
  128. A comprehensive manual is in the "doc" subdirectory.
  129.  
  130. The file doc/oogltour gives an introduction to the OOGL file format,
  131. which is the format of geometry files that geomview reads.  More
  132. details are in the manual.
  133.  
  134. Further documentation is in the "man" directory, which contains Unix
  135. manual pages in both nroff source and formatted form.  Each external
  136. module, as well as geomview itself, has a manual page. Of particular
  137. interest are:
  138.  
  139.     man/cat1/geomview.1    geomview man page
  140.     man/cat5/geomview.5    geomview command language reference
  141.                   manual
  142.     man/cat5/oogl.5        OOGL file format reference manual
  143.     doc/OOGL.m.doc        documentation for interface to
  144.                   Mathematica
  145.  
  146.  
  147.  
  148. GEOMVIEW E-MAIL
  149. ---------------
  150.  
  151. There are three electronic mail addresses for communication regarding
  152. geomview:
  153.  
  154. geomview-users@geom.umn.edu:
  155.  
  156.     This is a mailing list of people using geomview and can be used
  157.     for communication between users regarding geomview problems,
  158.     questions, experiences, etc.  The geomview authors are also a part
  159.     of this list and will respond to questions posted to it.  We also
  160.     use this list to make announcements about new releases and other
  161.     things of interest to users.  To be added to or removed from the
  162.     geomview-users list, send a note to geomview-users-request@geom.umn.edu
  163.  
  164. software@geom.umn.edu:
  165.  
  166.     This is the "official" support line; it reaches the geomview
  167.     authors directly.  In general if you have a question or comment
  168.     that may be of interest to other users, send it to the
  169.     "geomview-users" address.  Use "software" for communication
  170.     intended just for the authors; in particular, send bug reports and
  171.     suggestions for improvement to this address.
  172.  
  173. registry@geom.umn.edu
  174.  
  175.     Use this address to tell us what you are doing with Geomview.  The
  176.     Geometry Center is funded by the National Science Foundation, and
  177.     it is important that we be able to report to NSF the ways in which
  178.     our software is being used.  If you use Geomview in your work
  179.     please send us a note at this address telling us what you are
  180.     doing with it.  See the file REGISTRY for more details.  Please do
  181.     not send bug reports or questions to this address; use
  182.     "software@geom.umn.edu" for that.
  183.  
  184.  
  185. HISTORY
  186. -------
  187.  
  188. This project began in the sumer of 1988 with the work of Pat Hanrahan
  189. on a viewing program called MinneView.  Shortly thereafter Charlie
  190. Gunn begin developing OOGL in conjunction with MinneView.  In the time
  191. since then, many people have contributed, including Stuart Levy, Mark
  192. Meuer, Tamara Munzner, Steve Anderson, Mario Lopez, Todd Kaplan. 
  193.  
  194. In 1991, OOGL was rewritten and a new viewer geomview was begun.  Both
  195. geomview and the new OOGL have a core of device-independent common
  196. code. Currently there are device drivers for SGI GL, PhotoRealistic
  197. RenderMan, and Quick RenderMan on the NeXT. The NeXT version of
  198. geomview was written by Daniel Krech and Scott Wisdom.  Scott Wisdom
  199. wrote the Photo Realistic and Quick RenderMan OOGL drivers. The SGI
  200. version of geomview and OOGL was written by Stuart Levy, Tamara
  201. Munzner, and Mark Phillips.  The geomview common kernel was written by
  202. Stuart Levy, Tamara Munzner, and Mark Phillips, with contributions
  203. from Nathaniel Thurston and Celeste Fowler.
  204.  
  205. MISCELLANEOUS
  206. -------------
  207.  
  208. For a list of changes between versions, see the file CHANGES.
  209.  
  210. Geomview is copyrighted software.  Please read the file COPYING in
  211. this directory before using or distributing Geomview.
  212.     
  213. The file MANIFEST contains a list of the files in this distribution.
  214.  
  215.  
  216. KNOWN BUGS
  217. ----------
  218.  
  219. Picking does not work if any part of any object is behind the camera plane.
  220.  
  221.  
  222. IMPROVEMENTS/WISH LIST
  223. ----------------------
  224.  
  225. More modules will be converted to NeXTStep, and the way modules are
  226. handled on under NeXTSTEP should improve.
  227.