home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-Update.iso / NEXTSTEP / unix / graphics / urt.README < prev   
Encoding:
Text File  |  1997-06-12  |  5.3 KB  |  149 lines
  1. -*- Text -*-
  2. This is the Utah Raster Toolkit distribution version 3.0 of June, 1990.
  3. The Utah Raster Toolkit is now distributed from the University of
  4. Michigan and the University of Utah.
  5.  
  6. Major changes from version 2.0 are detailed (as much as possible) in the
  7. CHANGES file.  One change to be aware of, if you have toolkit programs
  8. of your own is that many function and data structure names have
  9. changed.  See CHANGES for details.
  10.  
  11. The source-only distribution contains the following subdirectories
  12.     cnv:        File conversion directory.  A collection of
  13.             utilities for converting to and from the Utah
  14.             RLE format.
  15.  
  16.     etc:        Contains some other sample programs that may
  17.             or may not be useful, but may be interesting to
  18.             look at if you are writing RLE programs.
  19.  
  20.     get:        Contains programs to display RLE images on various
  21.             types of displays, and instructions on how to
  22.             roll your own (see the README)
  23.  
  24.     include:    Necessary ".h" files for the library and toolkit.
  25.  
  26.     lib:        Sources for the RLE library.
  27.  
  28.     man:        Manual pages for the library and tools.
  29.  
  30.     tools:        Sources for the tools.
  31.  
  32.     tex:        Source for dvi to rle conversion program.
  33.             Also has dviselect program.  Requires U of
  34.             Maryland MC-TeX distribution (see README).
  35.  
  36.     img:        Contains a couple of uuencoded (use uudecode
  37.             to get them back) RLE files.
  38.  
  39. The FTP distribution contains the following directories, as well.
  40.             The following two directories are in urt-doc.tar.Z.
  41.     doc:        Contains long narrative descriptions of
  42.             the RLE file format and the Toolkit.
  43.             Documentation files are in Scribe ".mss" format,
  44.             PostScript ".ps" form, and cleartext (".doc).
  45.             A formatted version of the toolkit paper appeared
  46.             in the Proceedings of the USENIX 3rd Graphics
  47.             Workshop.
  48.     doc/pics:    Postscript form of the raster images for the
  49.             toolkit paper.
  50.  
  51.     img:        Includes some interesting RLE image files.
  52.             Distributed as urt-img.tar.Z.
  53.  
  54. To make and install the toolkit, you should:
  55.     0. If you got the source-only distribution, remove all the
  56.        urt.kit?? and kit*isdone files:
  57.         rm urt.kit?? kit*isdone
  58.  
  59.     1. Edit config/urt (I recommend making a copy and editing that
  60.        instead) to reflect your site configuration.  The
  61.        definitions in this file should be relatively self-
  62.        explanatory.  See config/README for more details.  If you
  63.        want to understand what is going on, look at the comments
  64.        in the makedef.awk script.
  65.  
  66.        You should also look at the other files in the config
  67.        directory, as one of them may already be correct for you.
  68.        All the configuration files compile as many of the
  69.        conversion tools as possible for the given machine.  If you
  70.        don't want some of these tools, comment out the corresponding
  71.        lines. 
  72.  
  73.     2. Configure the makefiles by running
  74.         Configure config/urt
  75.        If you have made a different config file, substitute its
  76.        name for config/urt, of course.  Once you have done this
  77.        once, you can use 'make config' instead.
  78.  
  79.     3a. If you have set the "RL" path in the config file to
  80.        something besides "lib" (presumably the same as LIB_DEST),
  81.        you must first
  82.         cd lib; make install
  83.        Then do 3b.
  84.  
  85.     3b. Run 'make' in this directory.  This will
  86.        compile the library and tools you have selected.
  87.  
  88.     4. Run 'make install' in this directory.  Alternatively, you
  89.        can combine 3a, 3b, and 4 by just running 'make install'
  90.        right away.
  91.  
  92. This version of the toolkit has been successfully compiled on the
  93. following machines (with the corresponding configuration file
  94. indicated in parentheses):
  95.     Sun 3 (SunOS 4) with cc (config/sun3) and gcc
  96.     Sun 4 (SunOS 4) (config/sun4)
  97.     DEC 3100 (Ultrix 3.1) (config/dec)
  98.     IBM RT (AIX ??) (config/ibm-rt)
  99.     SGI Iris 4D (IRIX 3.2) (config/iris4d)
  100.     Apollo (SR 10.2) (config/apollo)
  101.     Stardent GS1000 (config/stellar)
  102.     HP 9000/3xx,8xx (HP-UX 7.03) (config/hpux300 config/hpux800)
  103.     Macintosh (A/UX) [note - getmac program does not work on A/UX]
  104.     Macintosh (MacOS) with MPW [at least library and getmac program]
  105.     Cray 2 (UNICOS) (config/cray)
  106.  
  107. If you find bugs, make improvements, write new tools or conversions, 
  108. or have questions or suggestions, please send them to the address below.
  109.  
  110. If you want to write your own tool, we suggest that you start with
  111. tools/rleskel.c.  This has all the right code it it for opening image
  112. files for input and output, for processing multiple images per file,
  113. error checking, etc.
  114.  
  115. Our thanks to some beta testers (and contributors): 
  116.     Eric Haines, 3D Eye
  117.     Gregg Townsend, CS Dept., U of Arizona
  118.     John Peterson, Apple Computer
  119. And to all of you who submitted new programs or ideas for new
  120. features, especially Craig Kolb (Yale), whose 'rayshade' program provided
  121. (indirectly) the incentive for this release.
  122.  
  123. A special thanks to Martin Friedmann, MIT Media Lab, who almost
  124. totally revamped the 'getx11' program, so that it now works correctly,
  125. and is the most featurful of all the toolkit programs.
  126.  
  127. Spencer W. Thomas
  128. EECS Department
  129. University of Michigan
  130. Ann Arbor, MI 48109
  131.  
  132. Rod G. Bogart
  133. Computer-Aided Engineering Network
  134. University of Michigan
  135. Chrysler Building
  136. Ann Arbor, MI 48109
  137.  
  138. James Painter
  139. Computer Science Department
  140. University of Utah
  141. Salt Lake City, UT 84112
  142.  
  143. When you get a copy of the toolkit, from whatever source, please let us
  144. know at one of the addresses below.  That way, we will be able to keep
  145. you apprised of changes and updates.
  146.  
  147. toolkit-request@cs.utah.edu
  148. toolkit-request@caen.engin.umich.edu
  149.