home *** CD-ROM | disk | FTP | other *** search
/ Photo CD Demo 1 / Demo.bin / fbm / features next >
Text File  |  1990-06-24  |  5KB  |  142 lines
  1. **********************************************************************
  2. * Announcing Version 1 of the  "Fuzzy PixMap" (or FBM) image library *
  3. **********************************************************************
  4.  
  5. This package allows manipulation and conversion of a variety of color
  6. and black-and-white image formats.
  7.  
  8. Philosophy
  9.  
  10.     Each program can read any of the understood formats, and
  11.     can write any of the understood formats that make sense for
  12.     the image data.
  13.  
  14.     Programs are designed around specific image operations (sizing,
  15.     scaling, retoning, halftoning, quantizing, etc.), rather than
  16.     simply converting from one format to another.  For example,
  17.     converting a 4bit color GIF file to a 1bit Sun rasterfile
  18.     takes the following operations:
  19.     
  20.         read GIF format
  21.         map color values to grayscale
  22.         adjust aspect ratio (1.2 --> 1.0)
  23.         scale image up to be visible (320x200 --> 640x480 or 1152x864)
  24.         optionally sharpen the image (edge enhancement)
  25.         optionally clean up "snow" in image (flip isolated pixels)
  26.         halftone (Blue noise, Floyd-Steinberg, Jarvis, Threshhold)
  27.         write Sun rasterfile format.
  28.  
  29.     So there equivalent pipeline of fbm routines would be:
  30.     
  31.     clr2gray < foo.gif | fbnorm | fbext [ args ] | fbhalf [args] > foo.1bit
  32.     
  33.     That way you have maximum control over the resulting image size
  34.     and quality.
  35.  
  36. Inputs the following file formats
  37.  
  38.   o Sun rasterfiles    (1, 8, or 24 bits, color or grayscale)
  39.   o GIF files        (1 to 8 bits, color or grayscale)
  40.   o Amiga IFF files    (except HAM mode)
  41.   o PCX files        (b&w and color)
  42.   o PBM bitmaps        (P1 format only)
  43.   o Face files        (CMU format for 1bit files by Bennet Yee)
  44.   o FBM files        (my own format)
  45.   o Utah RLE files    (from the Utah Raster Toolkit)
  46.  
  47.     (automatically determines input format, and uncompresses
  48.      files compressed using 'compress')
  49.  
  50. Outputs the following formats
  51.  
  52.   o Sun rasterfiles    (1, 8, or 24 bits, color or grayscale)
  53.   o FBM files        (my own format)
  54.   o GIF files        (mapped color only)
  55.   o Amiga IFF files    (except HAM mode)
  56.   o PBM            (1bit files only)
  57.   o Face format        (1bit files only)
  58.   o Utah RLE files    (from the Utah Raster Toolkit)
  59.  
  60. With input converters for
  61.  
  62.   o raw images (like Amiga Digi-View files)
  63.   o Targa        By Ian MacPhedran
  64.   o PIC            By Ian MacPhedran
  65.   o QRT            By Butler Hines
  66.   o Amiga HAM        By C. Harald Koch
  67.   o Tiff format        By Michael Mauldin, using Sam Lefflers tifflib
  68.   o UseNet FaceSaver    By Dan Sahlin
  69.   o Microtek Postscript    By Gary Sherwin
  70.  
  71. With output converters for
  72.  
  73.   o PostScript        (1bit or 8bit grayscale files only)
  74.   o Diablo graphics    (1bit files only)
  75.   o Targa        By Ian MacPhedran
  76.   o Tiff Format        (using Sam Lefflers tifflib)
  77.  
  78. Operations
  79.  
  80.   o Extract rectangle (optionally resizing and changing aspect ratio)
  81.   o Change density and contrast (color and grayscale)
  82.   o Rotate  90, 180, or 270 degrees
  83.   o Quantize 24 bit RGB images to 8..256 colors
  84.         Modified Heckbert median cut
  85.   o Halftone grayscale using
  86.         Ulichney's Blue Noise dithering
  87.         Floyd-Steinberg dithering
  88.         Jarvis's Constrained averaging
  89.         Threshholding
  90.   o Edge Sharpening by Digitial Laplacian (color or grayscale)
  91.   o Convert color to grayscale (or compute "gray" colormap
  92.         so grayscale images can be viewed on frame buffers)
  93.   o Compute histograms of grayscale images
  94.   o Sample 1bit images to convert to grayscale
  95.   o Clean stray pixels in bitmaps
  96.   o Do edge detection
  97.   o Reverse black and white (negative image)
  98.  
  99.  
  100. Status
  101.  
  102.     Freely available for use, redistribution, incorporation into
  103.     other code.  Just don't remove the copyright notices or the
  104.     author(s) name(s) from any code.
  105.  
  106.     Written in C for BSD and Mach Unix Systems.
  107.     Tested on Vaxes, Sun Workstations, IBM RTs, Pyramids, and NeXTs.
  108.     
  109.     Self contained.  Does not require Sun include files or library
  110.     routines to manipulate Sun rasters.  Does require tifflib for
  111.     Tiff support and Utah Raster Toolkit for RLE support.
  112.  
  113. Availability
  114.  
  115.     Anonymous FTP, Use exactly these steps:
  116.     
  117.     % ftp nl.cs.cmu.edu        (or ftp 128.2.222.56)
  118.     User: anonymous
  119.     Password: your-name
  120.     ftp> binary
  121.     ftp> cd /usr/mlm/ftp
  122.     ftp> get fbm.tar.Z
  123.     ftp> bye
  124.  
  125.     An earlier version was posted to UseNet and is available in the UUNET
  126.     archives.  This version will also be posted to Usenet and included
  127.     in the uunet archives.
  128.  
  129. Acknowledgements
  130.  
  131.     GIF read support written by David Koblas.
  132.     GIF write support written by David Rowley.
  133.     Utah RLE Support written by Paul Milazzo.
  134.     Targa support by Ian MacPhedran.
  135.     Some IFF code by Jerry Morrison and Steve Shaw of Electronic Arts.
  136.     Edge detection and pixel cleaning by Gary Sherwin and Michael Mauldin.
  137.  
  138. Michael L. Mauldin (Fuzzy)        School of Computer Science
  139. Research Associate            Center for Machine Translation
  140. ARPA: mlm@NL.CS.CMU.EDU            Carnegie Mellon University
  141. Phone: (412) 268-5293            Pittsburgh, PA  15213-3890
  142.