home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / misc / volume21 / rayshade / part10 / blurb.urt next >
Text File  |  1991-07-21  |  7KB  |  158 lines
  1.  
  2.                THE UTAH RASTER TOOLKIT
  3.  
  4. The Utah Raster toolkit is a collection of programs and C routines for
  5. dealing with raster images commonly encountered in computer graphics.  It
  6. provides the following major functions:
  7.  
  8.     * A device and system independent image format for storing images
  9.       and information about them.  Called the RLE format, it uses
  10.       run length encoding to reduce storage space for most images.
  11.  
  12.     * A library of C routines for reading, writing and manipulating
  13.       images stored in the RLE format.
  14.  
  15.     * A collections of programs for manipulating and displaying RLE
  16.       images.
  17.  
  18.  
  19. The Format:
  20.  
  21.   The device independent RLE file has two parts, the header, which stores
  22.   information about the image (size, position, channel information,
  23.   color maps, comments, etc), and the actual image data in a run length
  24.   encoded format.  The RLE format often requires about a third of the
  25.   available space for most "image synthesis" style images.  If the image
  26.   does not compress well, the RLE format stores it as straight pixel data
  27.   with little extra overhead.  The format was first developed around
  28.   1983 at the University of Utah.
  29.  
  30. The Library:
  31.  
  32.   C routines are provided for setting up and reading the image header,
  33.   and for reading and writing the image a scanline at a time.  Images can
  34.   be read or written using two different methods.  Using the "row" method,
  35.   the library performs the RLE encoding and decoding.  With the "raw" method,
  36.   scanlines are constructed directly with RLE opcodes.  Additional routines
  37.   are available for generating dither matrices (e.g., for display programs
  38.   running on devices with less than 24 bits of color).
  39.  
  40. The Tools:
  41.   applymap   - Apply color map values to pixel values.
  42.   avg4          - Downfilter an image by 1/4, generating a matte channel if one
  43.            didn't previously exist
  44.   crop          - Crop an image.
  45.   dvirle     - Convert TeX output into anti-aliased images.
  46.   fant          - Rotate and/or scale in image by an arbitrary (float) value.
  47.   mcut       - Quantize an image from 24 to eight bits using the median cut
  48.            algorithm.
  49.   mergechan  - Merge several channels from different files into a single
  50.            RLE file.
  51.   pyrmask    - Blend images using Gaussian pyramids.
  52.   repos      - Change the position in the RLE header.
  53.   rleClock   - Generate an image of a clock.
  54.   rleaddcom  - Add a comment to the RLE file's header.
  55.   rlebg      - Generate a solid or variable background.
  56.   rlebox     - Find the actual non-background area of an image.
  57.   rlecomp    - Digital image compositor.  Provides the operations over, atop,
  58.            in, out, xor, plus, minus and diff on two images.
  59.   rledither  - Floyd-Steinberg to a given color map.
  60.   rleflip    - Rotate an image by 90/180 degree increments.
  61.   rlehdr     - Dump the contents of the RLE header in human readable form.
  62.   rlehisto   - Generate the histogram of an RLE file.
  63.   rleldmap   - Load a color map into an RLE file from a variety of sources.
  64.   rlemandl   - Generate Mandlebrot sets as RLE files.
  65.   rlenoise   - Adds random noise to an image.    
  66.   rlepatch   - Overlay several smaller images over a larger one.
  67.   rleprint   - Print all pixel values.
  68.   rlequant   - Variance-based color quantization.
  69.   rlescale   - Generates gray scale and color scale RLE files.
  70.   rleselect  - Select specific images from a file.
  71.   rlesetbg   - Set the background color stored in the RLE header.
  72.   rleskel    - A skeleton application, for rolling your own.
  73.   rlespiff   - Simple contrast enhancement to "spiff up" images.
  74.   rlesplice  - Splice images together horizontally or vertically.
  75.   rlesplit   - Split a file containing several images into several files.
  76.   rleswap    - Swap, copy or delete channels in an RLE file.
  77.   rlezoom    - Enlarge or shrink an image with pixel replication.
  78.   smush      - Perform a simple Gaussian filter on an image.
  79.   to8          - Convert a 24 bit RGB image to an eight bit dithered one.
  80.   tobw          - Convert 24 bits to 8 bits black and white.
  81.   unexp      - Convert an "exponential" image to a displayable one.
  82.   unslice    - Quickly assemble an image from several horizontal strips
  83.  
  84.   Format conversion programs are provided for:
  85.     - Ascii (line printer pictures) (to)
  86.     - Cubicomp image format (from)
  87.     - GIF (to and from)
  88.     - MacPaint (to and from)
  89.     - PBMPLUS pgm (from) and ppm (to and from)
  90.     - PostScript (to)
  91.     - Sun rasterfiles (to and from)
  92.     - Targa image format (from)
  93.     - TIFF (to and from)
  94.     - Wasatch paint systems (from)
  95.     - Wavefront 'RLA' format (to and from)
  96.        - Simple pixel streams (color & B&W) (to and from)
  97.  
  98.   Display programs are provided for:
  99.   get4d         - SGI Iris 4D workstation
  100.   get_orion  - Orion displays
  101.   getap         - Apollo workstations
  102.   getbob     - HP Series 300 ("bobcat") running Windows 9000
  103.   getcx3d    - Chromatics CX1500 display
  104.   getfb      - BRL "libfb" displays
  105.   getgmr     - Grinnell GMR-27 (remember those?)
  106.   getiris    - Iris in raw 24 bit mode.
  107.   getmac     - Macintosh.
  108.   getmex     - Iris running Mex
  109.   getqcr     - Photograph images with the Matrix QCR-Z camera.
  110.   getren     - HP 98721 "Renaissance" display
  111.   getsun     - Suns running Suntools
  112.   getx10     - Workstations running the X10 window system
  113.   getx11     - Workstations running X11
  114.              - [Note display programs for a particular device are
  115.         simple to add]
  116.  
  117.   All the tools are designed to pipe together, so they can be used as 
  118.   filters on images much like the standard Unix tools filter text.
  119.  
  120. Plus:
  121.  
  122.   The raster toolkit also includes Unix man pages for the library and
  123.   commands, some sample images, and additional documentation.
  124.  
  125. System Requirements:
  126.  
  127.   We have successfully ported the Raster Toolkit to a number of Unix
  128.   systems, including 4.2/4.3bsd (Vax, Sun, etc), Apollo Domain/IX, HP
  129.   Series 300, SGI Iris, IBM RT and RS6000, Stardent GS-1000, Cray
  130.   running UNICOS.  Display programs are included for several devices.
  131.   Creating display programs for additional devices is a
  132.   straightforward task.
  133.  
  134. Distribution:
  135.  
  136.   For Internet sites, the toolkit may be obtained via anonymous FTP to
  137.   the sites listed below, in the file pub/urt-3.0.tar.Z.  Some sample
  138.   images are in the file pub/urt-img.tar.Z, and the file
  139.   pub/urt-doc.tar.Z contains some (somewhat out-of-date) "papers"
  140.   describing the toolkit.  We are still working out distribution
  141.   mechanisms for sites not connected to the Internet.  We will
  142.   probably be adding other archive sites; please send mail to one of
  143.   the addresses below if you don't see a site near you (particularly
  144.   if you are on the other side of the Atlantic or Pacific).  If you
  145.   would like to offer to be an archive site, please let us know, too.
  146.  
  147.     cs.utah.edu (128.110.4.21)
  148.     weedeater.math.yale.edu (130.132.23.17)
  149.     freebie.engin.umich.edu (35.2.68.23)
  150.  
  151.   Although the Raster Toolkit software is copyrighted, it may be freely 
  152.   re-distributed on a "GNU-like" basis.
  153.  
  154. If you have further questions, please direct them to
  155.     toolkit-request@cs.utah.edu
  156. or    urt-request@caen.engin.umich.edu
  157. (but not both).
  158.