PBMPLUS(1L) Misc. Reference Manual Pages PBMPLUS(1L) NAME pbmplus - enhanced portable bitmap toolkit DESCRIPTION The pbmplus toolkit allows conversions between image files of different format. By means of using common intermediate formats, only 2*N conversion filters are required to support N distinct formats, instead of the N^2 which would be required to convert directly between any one format and any other. The package also includes simple tools for manipu- lating portable bitmaps. The package consists of four upwardly compatible sections: pbm Supports monochrome bitmaps (1 bit per pixel). pgm Supports grayscale images. Reads either pbm or pgm formats and writes pgm format. ppm Supports full-color images. Reads either pbm, pgm, or ppm formats, writes ppm format. pnm Supports content-independent manipulations on any of the three formats listed above, as well as external formats having multiple types. Reads either pbm, pgm, or ppm formats, and generally writes the same type as it read (whenever a pnm tool makes an exception and "promotes" a file to a higher format, it informs the user). DESCRIPTION OF CONTENTS PBM atktopbm convert Andrew Toolkit raster object to portable bitmap brushtopbm convert Xerox doodle brushes to portable bitmap cmuwmtopbm convert CMU window manager format to portable bitmap g3topbm convert Group 3 FAX to portable bitmap icontopbm convert Sun icon to portable bitmap gemtopbm convert GEM .img format to portable bitmap macptopbm convert MacPaint to portable bitmap Sun Microsystems Last change: 27 September 1991 1 PBMPLUS(1L) Misc. Reference Manual Pages PBMPLUS(1L) mgrtopbm convert MGR format to portable bitmap pbmmerge merge wrapper routine pbmto10x convert portable bitmap to Gemini 10x printer graphics pbmtoascii convert portable bitmap to ASCII graphic form pbmtoatk convert portable bitmap to Andrew Toolkit raster object pbmtobbnbg convert portable bitmap to BBN BitGraph graphics pbmtocmuwm convert portable bitmap to CMU window manager format pbmtoepson convert portable bitmap to Epson printer graphics pbmtog3 convert portable bitmap to Group 3 FAX pbmtogem convert portable bitmap into GEM .img file pbmtogo convert portable bitmap to GraphOn graphics pbmtoicon convert portable bitmap to Sun icon pbmtolj convert portable bitmap to HP LaserJet graphics pbmtomacp convert portable bitmap to MacPaint pbmtomgr convert portable bitmap to MGR format pbmtopi3 convert portable bitmap to Atari Degas .pi3 pbmtoplot convert portable bitmap into Unix plot(5) file pbmtoptx Sun Microsystems Last change: 27 September 1991 2 PBMPLUS(1L) Misc. Reference Manual Pages PBMPLUS(1L) convert portable bitmap to Printronix graphics pbmtoxbm convert portable bitmap to X11 bitmap pbmtox10bm convert portable bitmap to X10 bitmap pbmtoybm convert portable bitmap into Bennet Yee "face" file pbmtozinc convert portable bitmap to Zinc Interface Library icon pbmlife apply Conway's rules of Life to a portable bitmap pbmmake create a blank bitmap of a specified size pbmmask create a mask bitmap from a regular bitmap pbmreduce reduce a portable bitmap N times, using Floyd-Steinberg pbmtext render text into a bitmap pbmupc create a Universal Product Code bitmap pi3topbm convert Atari Degas .pi3 to portable bitmap xbmtopbm convert X10 or X11 bitmap to portable bitmap ybmtopbm convert Bennet Yee "face" file into portable bitmap PGM fitstopgm convert FITS format to portable graymap fstopgm convert Usenix FaceSaver(tm) format to portable graymap hipstopgm convert HIPS format to portable graymap lispmtopgm Sun Microsystems Last change: 27 September 1991 3 PBMPLUS(1L) Misc. Reference Manual Pages PBMPLUS(1L) convert a Lisp Machine bitmap file into pgm format pgmbentley Bentleyize a portable graymap pgmedge edge-detect a portable graymap pgmenhance edge-enhance a portable graymap pgmhist print a histogram of the values in a portable graymap pgmmerge merge wrapper routine pgmnorm normalize contrast in a portable graymap pgmoil turn a portable graymap into an oil painting pgmramp generate a grayscale ramp pgmtexture calculate textural features on a portable graymap pgmtofits convert portable graymap to FITS format pgmtofs convert portable graymap to Usenix FaceSaver(tm) format pgmtolispm convert a portable graymap into Lisp Machine format pgmtopbm convert portable graymap to portable bitmap psidtopgm convert PostScript "image" data to portable graymap rawtopgm convert raw grayscale bytes to portable graymap PPM giftoppm convert GIF to portable pixmap gouldtoppm Sun Microsystems Last change: 27 September 1991 4 PBMPLUS(1L) Misc. Reference Manual Pages PBMPLUS(1L) convert Gould scanner file to portable pixmap ilbmtoppm convert IFF ILBM to portable pixmap imgtoppm convert Img-whatnot to portable pixmap mtvtoppm convert MTV ray-tracer output to portable pixmap pcxtoppm convert PC Paintbrush format to portable pixmap pgmtoppm colorize a portable graymap into a portable pixmap pi1toppm convert Atari Degas .pi1 to portable pixmap picttoppm convert Macintosh PICT to portable pixmap pjtoppm convert HP PaintJet file to portable pixmap ppmdither ordered dither for color images ppmhist print a histogram of a portable pixmap ppmmerge merge wrapper routine ppmpat create a pretty pixmap ppmquant quantize colors down to a specified number ppmquantall script to run ppmquant on a set of pixmaps ppmrelief run a Laplacian Relief filter on a portable pixmap ppmtogif convert portable pixmap to GIF ppmtoicr convert portable pixmap to NCSA ICR graphics Sun Microsystems Last change: 27 September 1991 5 PBMPLUS(1L) Misc. Reference Manual Pages PBMPLUS(1L) ppmtoilbm convert portable pixmap to IFF ILBM ppmtopcx convert portable pixmap to PC Paintbrush format ppmtopgm convert portable pixmap to portable graymap ppmtopi1 convert portable pixmap to Atari Degas .pi1 ppmtopict convert portable pixmap to Macintosh PICT ppmtopj convert portable pixmap to HP PaintJet file ppmtopuzz convert portable pixmap to X11 "puzzle" file ppmtorgb3 separate a portable pixmap into three portable graymaps ppmtosixel convert portable pixmap to DEC sixel format ppmtotga convert portable pixmap to TrueVision Targa file ppmtouil convert portable pixmap to Motif UIL icon file ppmtoxpm convert portable pixmap to XPM format ppmtoyuv convert portable pixmap to Abekas YUV format qrttoppm convert QRT ray-tracer output to portable pixmap rawtoppm convert raw RGB bytes to portable pixmap rgb3toppm combine three portable graymaps into one portable pix- map spctoppm convert Atari compressed Spectrum to portable pixmap Sun Microsystems Last change: 27 September 1991 6 PBMPLUS(1L) Misc. Reference Manual Pages PBMPLUS(1L) sputoppm convert Atari uncompressed Spectrum to portable pixmap tgatoppm convert TrueVision Targa file to portable pixmap ximtoppm convert Xim to portable pixmap xpmtoppm convert XPM format to portable pixmap yuvtoppm convert Abekas YUV format to portable pixmap PNM anytopnm script to attempt to convert any format to P?M pnmarith perform arithmetic on two portable anymaps pnmcat concatenate portable anymaps pnmconvol general MxN convolu- tion on a portable anymap pnmcrop crop all like-colored borders off a portable anymap pnmcut select a rectangular region from a portable anymap pnmdepth change the maxval in a portable anymap pnmenlarge enlarge a portable anymap N times pnmfile describe a portable anymap pnmflip perform one or more flip operations on a portable anymap pnmgamma per- form gamma correction on a portable anymap pnmindex script to build a visual index of a bunch of anymaps pnminvert invert a portable anymap pnmmargin script to add a margin to a portable anymap pnmmerge merge wrapper routine pnmnoraw force a portable anymap into ASCII format pnmpaste paste a rectangle into a portable anymap pnmrotate rotate a portable anymap pnmscale scale a portable anymap pnmshear shear a portable anymap pnmsmooth script that uses pnmconvol to smooth a anymap pnmtile replicate a portable anymap into a specified size pnmtops convert portable anymap to PostScript pnmtorast convert portable anymap to Sun raster file pnmto- tiff convert portable anymap to TIFF file pnmtoxwd convert portable anymap to X11 window dump rasttopnm convert Sun raster file to portable anymap tifftopnm convert TIFF file to portable anymap xwdtopnm convert X10 or X11 window dump to portable anymap SEE ALSO There are a number of related image-manipulation tools: IM Raster Toolkit A portable and efficient format toolkit. The format supports pixels of arbitrary channels, components, and bit precisions, while allowing compression and machine byte-order independence. Support for image manipula- tion, digital halftoning, and format conversion. Pre- viously distributed on tape c/o the University of Sun Microsystems Last change: 27 September 1991 7 PBMPLUS(1L) Misc. Reference Manual Pages PBMPLUS(1L) Waterloo (an ftp(1) version is to appear later). Author: Alan Paeth (awpaeth@watcgl.uwaterloo.ca). Utah RLE Toolkit Conversion and manipulation package, similar to pbmplus. Available via ftp(1) as cs.utah.edu:pub/toolkit-2.0.tar.Z and ucsd.edu:graphics/utah-raster-toolkit.tar.Z. Fuzzy Pixmap Manipulation Conversion and manipulation package, similar to pbmplus. Version 1.0 available via ftp(1) as nl.cs.cmu.edu:/usr/mlm/ftp/fbm.tar.Z, uunet.uu.net:pub/fbm.tar.Z, and ucsd.edu:graphics/fbm.tar.Z. Author: Michael Mauldin . Img Software Set Reads and writes its own image format, displaying results on an X11 screen, and does some image manipula- tions. Version 1.3 is available via ftp(1) as export.lcs.mit.edu:contrib/img_1.3.tar.Z, and venera.isi.edu:pub/img_1.3.tar.Z, along with a large collection of color images. Author: Paul Raveling . Xim Reads and writes its own image format, displays on an X11 screen, and does some image manipulations. Avail- able in your nearest X11R4 source tree as contrib/clients/xim. A more recent version is avail- able via ftp from video.mit.edu. It uses X11R4 and the OSF/Motif toolkit to provide basic interactive image manipulation and reads/writes GIF, xwd, xbm, tiff, rle, xim, and other formats. Author: Philip R. Thompson. xloadimage Reads in images in various formats and displays them on an X11 screen. Available via ftp(1) as export.lcs.mit.edu:contrib/xloadimage*, and in your nearest comp.sources.x archive. Author: Jim Frost . TIFF Software Nice portable library for reading and writing TIFF files, plus a few tools for manipulating them and read- ing other formats. Available via ftp(1) as ucbvax.berkeley.edu:pub/tiff/*.tar.Z or uunet.uu.net:graphics/tiff.tar.Z. Author: Sam Leffler . ALV A Sun-specific image toolkit. Version 2.0.6 posted to comp.sources.sun on 11 December 1989. Also available Sun Microsystems Last change: 27 September 1991 8 PBMPLUS(1L) Misc. Reference Manual Pages PBMPLUS(1L) via email to alv-users-request@cs.bris.ac.uk. popi An image manipulation language. Version 2.1 posted to comp.sources.misc on 12 December 1989. ImageMagick, X11 package for display and interactive manipulation of images. Uses its own format (MIFF), and includes some converters. Available via ftp(1) as export.lcs.mit.edu:contrib/ImageMagick.tar.Z. Khoros Huge (~100 meg) graphical development environment based on X11R4. Components include a visual programming language, code generators for extending the visual language and adding new application packages to the system, an interactive user interface editor, an interactive image display package, an extensive library of image and signal processing routines, and 2D/3D plotting packages. Available via ftp(1) as pprg.unm.edu:pub/khoros/*. JPEG package JPEG is a a standardized compression method for full- color and gray-scale images of "real-world" scenes; this experimental package includes programs to compress gif and ppm format files to JPEG format (cjpeg(1L)), and to decompress them (djpeg(1L)). Available by ftp(1) as uunet.uu.net:graphics/jpeg/jpegsrc.v1.tar.Z. libpbm(3L), libpgm(3L), libpnm(3L), libppm(3L), pbm(5L), pgm(5L), pnm(5L), ppm(5L), rasterfile(1) AUTHOR Distribution of 27 September 1991. Copyright (C) 1989, 1991 by Jef Poskanzer. Feedback and questions are welcome. Please send them to: jef@well.sf.ca.us {apple, ucbvax}!well!jef When sending bug reports, always include the output from running any pbmplus program with the -version flag., includ- ing descriptions of the type of system you are on, the com- piler you use, and whether you are using Makefiles or Imakefiles. When suggesting new formats or features, please include whatever documentation you have, and a uuencoded sample. The response time will depend upon my schedule and the Sun Microsystems Last change: 27 September 1991 9 PBMPLUS(1L) Misc. Reference Manual Pages PBMPLUS(1L) complexity of the task; if you need it right away, or it is a complicated job, you might consider paying me. The Usenet newsgroup alt.graphics.pixutils is a forum for discussion of image conversion and editing packages. Post- ing queries there may be better than mailing them to me, since it allows other people to help provide answers. Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting docu- mentation. This software is provided "as is" without express or implied warranty. Thus, you may do what you want with this software. Build it into your package, steal code from it, whatever. Just be sure to let people know where it came from. -------------------------------------------------------------------------------- R. P. C. Rodgers, M.D. Telephone: Statist- ical Mechanics of Biomolecules (415)476-8910 (work) Department of Pharmaceutical Chemistry (415)664-0560 (home)