home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume19 / fbm / part03 / Features < prev    next >
Encoding:
Text File  |  1989-06-08  |  4.8 KB  |  146 lines
  1. ************************************************************************
  2. *   Announcing the "Fuzzy PixMap" (or FBM) image manipulation library  *
  3. ************************************************************************
  4.  
  5.             Current version 0.94
  6.  
  7. The FBM library is now available in Beta test form to interested
  8. parties.  This package allows manipulation and conversion of a variety
  9. of color and black-and-white image formats.
  10.  
  11. Philosophy
  12.  
  13.     Each program can read any of the understood formats, and
  14.     can write any of the understood formats that make sense for
  15.     the image data.
  16.  
  17.     Programs are designed around specific image operations (sizing,
  18.     scaling, retoning, halftoning, quantizing, etc.), rather than
  19.     simply converting from one format to another.  For example,
  20.     converting a 4bit color GIF file to a 1bit Sun rasterfile
  21.     takes the following operations:
  22.     
  23.         read GIF format
  24.         map color values to grayscale
  25.         adjust aspect ratio (1.2 --> 1.0)
  26.         scale image up to be visible (320x200 --> 640x480 or 1152x864)
  27.         optionally sharpen the image (edge enhancement)
  28.         optionally clean up "snow" in image (flip isolated pixels)
  29.         halftone (Blue noise, Floyd-Steinberg, Jarvis, Threshhold)
  30.         write Sun rasterfile format.
  31.  
  32.     So there equivalent pipeline of fbm routines would be:
  33.     
  34.     clr2gray < foo.gif | fbnorm | fbext [ args ] | fbhalf [args] > foo.1bit
  35.     
  36.     That way you have maximum control over the resulting image size
  37.     and quality.
  38.  
  39. Inputs the following file formats
  40.  
  41.   o Sun rasterfiles    (1, 8, or 24 bits, color or grayscale)
  42.   o GIF files        (1 to 8 bits, color or grayscale)
  43.   o Amiga IFF files    (except HAM mode)
  44.   o PCX files
  45.   o PBM bitmaps
  46.   o Face files        (CMU format for 1bit files by Bennet Yee)
  47.   o FBM files        (my own format)
  48.  
  49.     (automatically determines input format, and uncompresses
  50.      files compressed using 'compress')
  51.  
  52. Outputs the following formats
  53.  
  54.   o Sun rasterfiles
  55.   o FBM files
  56.   o GIF files        (mapped color only)
  57.   o Amiga IFF files    (except HAM mode)
  58.   o PBM            (1bit files only)
  59.   o Face format        (1bit files only)
  60.  
  61. With input converter for
  62.  
  63.   o raw images (like Amiga Digi-View files)
  64.   o Targa        By Ian MacPhedran
  65.   o PIC            By Ian MacPhedran
  66.   o QRT            By Butler Hines
  67.  
  68. With output converters for
  69.  
  70.   o PostScript         (1bit or 8bit grayscale files only)
  71.   o Diablo graphics    (1bit files only)
  72.   o Targa        By Ian MacPhedran
  73.  
  74. Operations
  75.  
  76.   o Extract rectangle (optionally resizing and changing aspect ratio)
  77.   o Change density and contrast (color and grayscale)
  78.   o Rotate  90, 180, or 270 degrees
  79.   o Quantize 24 bit RGB images to 8..256 colors
  80.         Modified Heckbert median cut
  81.   o Halftone grayscale using
  82.         Ulichney's Blue Noise dithering
  83.         Floyd-Steinberg dithering
  84.         Jarvis's Constrained averaging
  85.         Threshholding
  86.   o Edge Sharpening by Digitial Laplacian (color or grayscale)
  87.   o Convert color to grayscale (or compute "gray" colormap
  88.         so grayscale images can be viewed on frame buffers)
  89.   o Compute histograms of grayscale images
  90.   o Sample 1bit images to convert to grayscale
  91.  
  92. Status
  93.  
  94.     Beta test release, 0.9.  "Use at your own risk, bug fixes not
  95.     guaranteed, be happy with minimal documentation."  Bugs reported
  96.     so far have been fixed.
  97.  
  98.     Freely available for use, redistribution, incorporation into
  99.     other code.  Just don't make a profit off it or take my name
  100.     off of it.
  101.  
  102.     Written in C for BSD and Mach Unix Systems.
  103.     Tested on Vaxes, Sun Workstations, IBM RTs and Pyramids.
  104.     
  105.     Self contained.  Does not require Sun include files or library
  106.     routines to manipulate Sun rasters.
  107.  
  108. Availability
  109.  
  110.     Anonymous FTP
  111.  
  112.     Host:    nl.cs.cmu.edu (128.2.222.56)
  113.     User:    anonymous
  114.     Password:    name@site
  115.     Directory:    /usr/mlm/ftp/
  116.     Filename:    fbm.tar.Z
  117.     Transfer:    'image'
  118.  
  119.     Note: you must 'cd' to /usr/mlm/ftp directly, you cannot access
  120.     either /usr, or /usr/mlm alone.  Don't forget to specify 'image'
  121.     format transfer.
  122.  
  123.     Will be posted to UseNet when the code is stable and
  124.     the documentation is complete and accurate.
  125.  
  126. Acknowledgements
  127.  
  128.     GIF read support written by David Koblas.
  129.     GIF write support written by David Rowley.
  130.     Some IFF code by Jerry Morrison and Steve Shaw of Electronic Arts.
  131.     Edge detection and pixel cleaning by Gary Sherwin and Michael Mauldin
  132.  
  133. Rumours
  134.  
  135.     Future support is rumoured for TIFF files and MacPaint files.  Also it
  136.     may someday be able to write all of the formats that it can read.
  137.  
  138.     All that is needed to incorporate a new format is to write a routine
  139.     that reads the given image into memory and one that writes it out
  140.     again.  I will incorporate other code on a "whenever I'm not working
  141.     on my thesis" basis.
  142.  
  143. Michael L. Mauldin (Fuzzy)        School of Computer Science
  144. ARPA: Michael.Mauldin@NL.CS.CMU.EDU    Carnegie Mellon University
  145. Phone: (412) 268-3065            Pittsburgh, PA  15213-3890
  146.