home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 309.lha / PBM_PLUS / README < prev    next >
Encoding:
Text File  |  1980-12-04  |  8.5 KB  |  214 lines
  1.                   Extended Portable Bitmap Toolkit
  2.                       Distribution of 13sep89
  3.                    Previous distribution 06sep89
  4.  
  5.  
  6. Included are a number of programs for converting various image formats
  7. to and from portable formats; plus some tools for manipulating the
  8. portable formats.  The package is broken up into four parts (five parts
  9. if you count this one, the zeroth part).  First is PBM, for bitmaps (1
  10. bit per pixel).  Then there is PGM, for grayscale images.  Next is PPM,
  11. for full-color images.  Last, there is PNM, which does content-independent
  12. manipulations on any of the three formats.
  13.  
  14. These parts are semi-independent; if you're only going to deal with
  15. bitmaps, you don't have to install PGM and PPM, and this makes PNM run
  16. faster; if you want PGM, you must install PBM but can leave PPM out;
  17. but if you want PPM, you must install both PGM and PBM.  PNM is optional
  18. but recommended.
  19.  
  20.  
  21. To install:
  22.  
  23.     Unpack the files.
  24.     Decide whether you want to use Imakefiles or Makefiles.  If you want
  25.       to use Makefiles:
  26.  
  27.     Edit the top-level Makefile, find each line with the string
  28.       "CONFIGURE", and follow the directions for setting configuration
  29.       options.
  30.     Likewise edit pbmplus.h.
  31.     Likewise edit pbm/Makefile, ppm/Makefile, and pnm/Makefile;
  32.       pgm/Makefile does not currently have any configuration options.
  33.     Make.
  34.     When you're happy that things work ok, make install.
  35.     
  36.     If you want to use Imakefiles instead:
  37.  
  38.     Edit the top-level Imakefile, find each line with the string
  39.       "CONFIGURE", and follow the directions for setting configuration
  40.       options.
  41.     Likewise edit pbmplus.h.
  42.     Likewise edit pbm/Imakefile, ppm/Imakefile, and pnm/Imakefile;
  43.       pgm/Imakefile does not currently have any configuration options.
  44.     Edit Makefile and */Makefile, look towards the end for the
  45.       definition of TOP, and change it to point to your X11 tree.
  46.     Save the original Makefiles, in case you later want to switch back
  47.       to using them.
  48.     Touch Imakefile, since you just editted Makefile.
  49.     Make Makefile, make Makefiles, make depend, then make.
  50.     When you're happy that things work ok, make install.
  51.  
  52.  
  53. I've tested this stuff under 4.2 BSD, 4.3 BSD, on Sun 3's, Sun 386's, on
  54. Sequents and Vaxen.  Nevertheless, I'm sure bugs remain.  Feedback is welcome;
  55. send bug reports, enhancements, checks, money orders, etc. to the addresses
  56. below.  Be sure to mention what version you have when sending bug reports!
  57.  
  58.     Jef Poskanzer
  59.     pokey@well.sf.ca.us
  60.     {ucbvax, lll-crg, sun!pacbell, apple, hplabs}!well!pokey
  61.  
  62.  
  63. Files in pbmplus.shar:
  64.  
  65.     README        this
  66.     CHANGES        list of changes between the various versions of PBM
  67.     FORMATS        list of the formats supported
  68.     OTHER.SYSTEMS    list of other free image-processing software
  69.     TIPS        useful techniques and rules of thumb for PBM
  70.     Makefile        guess
  71.     Imakefile        for X11-type installations
  72.     pbmplus.h        header file for PBM, PGM, PPM, and PNM
  73.  
  74.     compataliases    csh script for compatibility with old versions
  75.  
  76.  
  77. Files in pbm.shar?:
  78.  
  79.     Makefile        guess
  80.     Imakefile        for X11-type installations
  81.  
  82.     brushtopbm.c    convert Xerox doodle brushes to portable bitmap
  83.     cmuwmtopbm.c    convert CMU window manager format to portable bitmap
  84.     g3topbm.c        convert Group 3 FAX to portable bitmap
  85.     icontopbm.c        convert Sun icon to portable bitmap
  86.     gemtopbm.c        convert GEM .img format to portable bitmap
  87.     macptopbm.c        convert MacPaint to portable bitmap
  88.     mgrtopbm.c        convert MGR format to portable bitmap
  89.     pcxtopbm.c        convert PC paintbrush format to portable bitmap
  90.     rasttopbm.c        convert Sun raster to portable bitmap
  91.     tifftopbm.c        convert TIFF format to portable bitmap
  92.     xbmtopbm.c        convert X10 or X11 bitmap to portable bitmap
  93.     xwdtopbm.c        convert X10 or X11 window dump to portable bitmap
  94.  
  95.     pbmtoascii.c    convert portable bitmap to ASCII graphic form
  96.     pbmtobbnbg.c    convert portable bitmap to BBN BitGraph graphics
  97.     pbmtocmuwm.c    convert portable bitmap to CMU window manager format
  98.     pbmtogo.c        convert portable bitmap to GraphOn graphics
  99.     pbmtoicon.c        convert portable bitmap to Sun icon
  100.     pbmtolj.c        convert portable bitmap to HP LaserJet
  101.     pbmtomacp.c        convert portable bitmap to MacPaint
  102.     pbmtomgr.c        convert portable bitmap to MGR format
  103.     pbmtoptx.c        convert portable bitmap to Printronix
  104.     pbmtorast.c        convert portable bitmap to Sun raster
  105.     pbmtoxbm.c        convert portable bitmap to X11 bitmap
  106.     pbmtox10bm.c    convert portable bitmap to X10 bitmap
  107.     pbmtoxwd.c        convert portable bitmap to X11 window dump
  108.  
  109.     pbmlife.c        apply Conway's rules of Life to a portable bitmap
  110.     pbmmake.c        create a blank bitmap of a specified size
  111.     pbmmask.c        create a mask bitmap from a regular bitmap
  112.     pbmpaste.c        paste a rectangle into a portable bitmap
  113.     pbmreduce.c        reduce a portable bitmap N times, using Floyd-Steinberg
  114.     pbmupc.c        create a Universal Product Code bitmap
  115.  
  116.     libpbm[1-4].c    a few utility routines
  117.     pbm.h        header file for libpbm
  118.     libpbm.h        internal header file for libpbm
  119.     macp.h        definitions for MacPaint files
  120.     tiff.h        definitions for TIFF files
  121.     x10wd.h        definitions for X10 window dumps
  122.     x11wd.h        definitions for X11 window dumps
  123.     bitreverse.h    useful include file
  124.     *.1            manual entries for all of the tools
  125.     pbm.5        manual entry for the pbm format
  126.  
  127.  
  128. Files in pgm.shar?:
  129.  
  130.     Makefile        guess
  131.     Imakefile        for X11-type installations
  132.  
  133.     fitstopgm.c        convert FITS format to portable graymap
  134.     fstopgm.c        convert Usenix FaceSaver file to portable graymap
  135.     hipstopgm.c        convert HIPS format to portable graymap
  136.     psidtopgm.c        convert PostScript "image" data to portable graymap
  137.  
  138.     pgmtopbm.c        convert portable graymap to portable bitmap
  139.     pgmtops.c        convert portable graymap to Encapsulated PostScript
  140.  
  141.     pgmenhance.c    edge-enhance a portable graymap
  142.     pgmhist.c        print a histogram of the values in a portable graymap
  143.     pgmnorm.c        normalize contrast in a portable graymap
  144.  
  145.     libpgm[1-3].c    a few utility routines
  146.     pgm.h        header file for libpgm
  147.     libpgm.h        internal header file for libpgm
  148.     dithers.h        useful include file
  149.     *.1            manual entries for all of the tools
  150.     pgm.5        manual entry for the pgm format
  151.  
  152.  
  153. Files in ppm.shar?:
  154.  
  155.     Makefile        guess
  156.     Imakefile        for X11-type installations
  157.  
  158.     giftoppm.c        convert GIF to portable pixmap
  159.     ilbmtoppm.c        convert Amiga IFF ILBM to portable pixmap
  160.     imgtoppm.c        convert Img-whatnot to portable pixmap
  161.     mtvtoppm.c        convert MTV ray-tracer output to portable pixmap
  162.     qrttoppm.c        convert QRT ray-tracer output to portable pixmap
  163.     rasttoppm.c        convert Sun raster file to portable pixmap
  164.     tgatoppm.c        convert TrueVision Targa file to portable pixmap
  165.     xwdtoppm.c        convert color X10 or X11 window dump to portable pixmap
  166.  
  167.     ppmtogif.c        convert portable pixmap to GIF
  168.     ppmtoilbm.c        convert portable pixmap to Amiga IFF ILBM
  169.     ppmtopgm.c        convert portable pixmap to portable graymap
  170.     ppmtops.c        convert portable pixmap to color Encapsulated PostScript
  171.     ppmtorast.c        convert portable pixmap to Sun raster file
  172.     ppmtoxwd.c        convert portable pixmap to color X11 window dump
  173.  
  174.     ppmarith.c        perform arithmetic on two portable pixmaps
  175.     ppmconvol.c        general MxN convolution on a portable pixmap
  176.     ppmcscale.c        scale the colors in a portable pixmap
  177.     ppmpat.c        create a pretty pixmap
  178.     ppmquant.c        quantize colors down to a specified number
  179.     ppmrotate.c        rotate a portable pixmap
  180.     ppmscale.c        scale a portable pixmap
  181.     ppmshear.c        shear a portable pixmap
  182.     ppmhist.c        print a histogram of a portable pixmap
  183.  
  184.     convolscripts/*    ppmconvol scripts
  185.  
  186.     libppm[1-5].c    a few utility routines
  187.     ppm.h        header file for libppm
  188.     ppmcmap.h        header file for colormap routines in libppm
  189.     ppmdraw.h        header file for simple drawing routines in libppm
  190.     libppm.h        internal header file for libppm
  191.     tga.h        definitions for TrueVision Targa files
  192.     *.1            manual entries for all of the tools
  193.     ppm.5        manual entry for the ppm format
  194.  
  195.  
  196. Files in pnm.shar?:
  197.  
  198.     Makefile        guess
  199.     Imakefile        for X11-type installations
  200.  
  201.     pnmcat.c        concatenate portable anymaps
  202.     pnmcrop.c        crop all like-colored borders off a portable anymap
  203.     pnmcut.c        select a rectangular region from a portable anymap
  204.     pnmenlarge.c    enlarge a portable anymap N times
  205.     pnmflip.c        perform one or more flip operations on a portable anymap
  206.     pnminvert.c        invert a portable anymap
  207.     pnmpaste.c        paste a rectangle into a portable anymap
  208.     pnmtile.c        replicate a portable anymap into a specified size
  209.  
  210.     libpnm[1-4].c    a few utility routines
  211.     pnm.h        header file for libpnm
  212.     *.1            manual entries for all of the tools
  213.     pnm.5        manual entry for the pnm format
  214.