Programs for manipulating Sun icons

[Jef Poskanzer]

While we're on the subject, some Sun-Spots readers might not be aware of
my "Portable Bitmap" package.  This package started the same way as
Jonathan Bowen's, as just a bunch of hacks for converting between bitmap
formats, but I and others have been adding to it for a couple of years
now.

The package was recently posted to the comp.sources.misc newsgroup, so it
should be available from various archive servers.  It is also available
via anonymous FTP from expo.lcs.mit.edu (18.72.0.126) as
contrib/pbm.tar.Z.

I have appended the README, but it's pretty long...
---
Jef

             Jef Poskanzer   jef at rtsg.ee.lbl.gov   ...well!pokey

= = = = = = = = = =

                       Portable Bitmap Toolkit
                       Version of 12dec88
                    Previous distribution 31oct88


Included are a number of programs for converting various bitmap formats
to and from a portable format; plus some tools for manipulating the
portable bitmaps.

Changes since the comp.sources.misc distribution of 31oct88:

    Added pbmreduce.
    Added imgtopbm, tifftopbm, pcxtopbm, and pbmtogo.
    Minor bugfix to pbmtolj.

Changes since the X.V11R3 distribution of 31aug88:

    The cbm format has been revised to support run-length encoding.
    Pbmtops now does run-length encoding.

Major changes since the X.V11R2 distribution of 28mar88:

    The pbm format now has a "magic number".
    New conversion filters: brushtopbm, giftopbm, pbmtolj, pbmtomacp,
      pbmtoxwd, and pbmtox10wd.
    Icontopbm converter has a better parser -- it knows to skip over
      any extraneous comments at the beginning of the icon file.
    Pbmtops generates a different PostScript wrapper program -- it should
      handle huge bitmaps better.
    Xwdtopbm now handles byte-swapping correctly.
    Pbmmake takes a flag to specify the color of the new bitmap.
    Pbmpaste now implements 'or', 'and', and 'xor' operations as well
      as the default 'replace'.


Files in this distribution:

    README		this
    FORMATS		descriptions of the various bitmap formats
    Makefile		guess

    brushtopbm.c	convert from Xerox doodle brushes to portable bitmap
    cbmtopbm.c		convert from compact bitmap to portable bitmap
    giftopbm.c		convert from GIF to portable bitmap
    icontopbm.c		convert from Sun icon to portable bitmap
    imgtopbm.c		convert from GEM .img format to portable bitmap
    macptopbm.c		convert from MacPaint to portable bitmap
    pcxtopbm.c		convert from PC paintbrush format to portable bitmap
    rasttopbm.c		convert from Sun raster to portable bitmap
    tifftopbm.c		convert from TIFF format to portable bitmap
    xbmtopbm.c		convert from X10 or X11 bitmap to portable bitmap
    xwdtopbm.c		convert from X10 or X11 window dump to portable bitmap
    xxxtopbm.c		convert from UNKNOWN BITMAP to portable bitmap

    pbmtoascii.c	convert from portable bitmap to ASCII graphic form
    pbmtocbm.c		convert from portable bitmap to compact bitmap
    pbmtogo.c		convert from portable bitmap to GraphOn graphics
    pbmtoicon.c		convert from portable bitmap to Sun icon
    pbmtolj.c		convert from portable bitmap to HP LaserJet
    pbmtomacp.c		convert from portable bitmap to MacPaint
    pbmtops.c		convert from portable bitmap to PostScript
    pbmtoptx.c		convert from portable bitmap to Printronix
    pbmtorast.c		convert from portable bitmap to Sun raster
    pbmtoxbm.c		convert from portable bitmap to X11 bitmap
    pbmtox10bm.c	convert from portable bitmap to X10 bitmap
    pbmtoxwd.c		convert from portable bitmap to X11 window dump
    pbmtox10wd.c	convert from portable bitmap to X10 window dump

    pbmcatlr.c		concatenate portable bitmaps left to right
    pbmcattb.c		concatenate portable bitmaps top to bottom
    pbmcrop.c		crop a portable bitmap
    pbmcut.c		cut a rectangle out of a portable bitmap
    pbmenlarge.c	enlarge a portable bitmap N times
    pbmfliplr.c		flip a portable bitmap left for right
    pbmfliptb.c		flip a portable bitmap top for bottom
    pbminvert.c		invert a portable bitmap
    pbmmake.c		create a blank bitmap of a specified size
    pbmpaste.c		paste a rectangle into a portable bitmap
    pbmreduce.c		reduce a portable bitmap N times, using Floyd-Steinberg
    pbmtrnspos.c	transpose a portable bitmap x for y

    libpbm[1-5].c	a few utility routines
    pbm.h		header file for libpbm
    libpbm.h		internal header file for libpbm
    macp.h		definitions for MacPaint files
    tiff.h		definitions for TIFF files
    x10wd.h		definitions for X10 window dumps
    x11wd.h		definitions for X11 window dumps
    bmaliases		csh script to make aliases for converting formats
    *.1			manual entries for all of the tools
    pbm.5		manual entry for the pbm format
    bitreverse.h	useful include file

    Jef Poskanzer
    jef at rtsg.ee.lbl.gov
    {ucbvax, lll-crg, sun!pacbell, apple, hplabs}!well!pokey