home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d03xx / d0334.lha / FBM / Features < prev    next >
Text File  |  1990-03-21  |  5KB  |  142 lines
  1. ************************************************************************
  2. *   Announcing the "Fuzzy PixMap" (or FBM) image manipulation library  *
  3. ************************************************************************
  4.  
  5.             Current version 0.9
  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.  
  65. With output converters for
  66.  
  67.   o PostScript         (1bit or 8bit grayscale files only)
  68.   o Diablo graphics    (1bit files only)
  69.  
  70. Operations
  71.  
  72.   o Extract rectangle (optionally resizing and changing aspect ratio)
  73.   o Change density and contrast (color and grayscale)
  74.   o Rotate  90, 180, or 270 degrees
  75.   o Quantize 24 bit RGB images to 8..256 colors
  76.         Modified Heckbert median cut
  77.   o Halftone grayscale using
  78.         Ulichney's Blue Noise dithering
  79.         Floyd-Steinberg dithering
  80.         Jarvis's Constrained averaging
  81.         Threshholding
  82.   o Edge Sharpening by Digitial Laplacian (color or grayscale)
  83.   o Convert color to grayscale (or compute "gray" colormap
  84.         so grayscale images can be viewed on frame buffers)
  85.   o Compute histograms of grayscale images
  86.   o Sample 1bit images to convert to grayscale
  87.  
  88. Status
  89.  
  90.     Beta test release, 0.9.  "Use at your own risk, bug fixes not
  91.     guaranteed, be happy with minimal documentation."  Bugs reported
  92.     so far have been fixed.
  93.  
  94.     Freely available for use, redistribution, incorporation into
  95.     other code.  Just don't make a profit off it or take my name
  96.     off of it.
  97.  
  98.     Written in C for BSD and Mach Unix Systems.
  99.     Tested on Vaxes, Sun Workstations, IBM RTs and Pyramids.
  100.     
  101.     Self contained.  Does not require Sun include files or library
  102.     routines to manipulate Sun rasters.
  103.  
  104. Availability
  105.  
  106.     Anonymous FTP
  107.  
  108.     Host:    nl.cs.cmu.edu (128.2.222.56)
  109.     User:    anonymous
  110.     Password:    name@site
  111.     Directory:    /usr/mlm/ftp/
  112.     Filename:    fbm.tar.Z
  113.     Transfer:    'image'
  114.  
  115.     Note: you must 'cd' to /usr/mlm/ftp directly, you cannot access
  116.     either /usr, or /usr/mlm alone.  Don't forget to specify 'image'
  117.     format transfer.
  118.  
  119.     Will be posted to UseNet when the code is stable and
  120.     the documentation is complete and accurate.
  121.  
  122. Acknowledgements
  123.  
  124.     GIF read support written by David Koblas.
  125.     GIF write support written by David Rowley.
  126.     Some IFF code by Jerry Morrison and Steve Shaw of Electronic Arts.
  127.     Edge detection and pixel cleaning by Gary Sherwin and Michael Mauldin
  128.  
  129. Rumours
  130.  
  131.     Future support is rumoured for TIFF files and MacPaint files.  Also it
  132.     may someday be able to write all of the formats that it can read.
  133.  
  134.     All that is needed to incorporate a new format is to write a routine
  135.     that reads the given image into memory and one that writes it out
  136.     again.  I will incorporate other code on a "whenever I'm not working
  137.     on my thesis" basis.
  138.  
  139. Michael L. Mauldin (Fuzzy)        School of Computer Science
  140. ARPA: Michael.Mauldin@NL.CS.CMU.EDU    Carnegie Mellon University
  141. Phone: (412) 268-3065            Pittsburgh, PA  15213-3890
  142.