[alt.hackers] pbmtext - render text into a bitmap

jef@well.sf.ca.us (Jef Poskanzer) (01/07/91)

Appended is the man page for the latest addition to my pbmplus package.
I figure I'll use it to generate labels for images -- fairly mundane stuff.
But what's cool is the way you specify an alternate font.  It's totally
portable and it really really works!  I even used it to generate the
compiled-in font by adding an undocumented -dump flag that writes out
the user-specified font as C source code.

The program itself will be appearing with the rest of the new pbmplus in
a few days.
---
Jef

  Jef Poskanzer  jef@well.sf.ca.us  {ucbvax, apple, hplabs}!well!jef
                  CONCENTRATED!!! DILUTE!!! DILUTE!!!

NAME
     pbmtext - render text into a bitmap

SYNOPSIS
     pbmtext [-font <fontfile>] [text]

DESCRIPTION
     Takes the specified text, either a single line from the com-
     mand line or multiple lines from standard input, and renders
     it into a bitmap.

     By default, pbmtext uses a  built-in  font.   You  can  also
     specify  your own font with the -font flag.  The fontfile is
     a pbm file, created in a very specific way.  In your  window
     system  of choice, display the following text in the desired
     (fixed-width) font:

         M ",/^_[`jpqy| M

         /  !"#$%&'()*+ /
         < ,-./01234567 <
         > 89:;<=>?@ABC >
         @ DEFGHIJKLMNO @
         _ PQRSTUVWXYZ[ _
         { \]^_`abcdefg {
         } hijklmnopqrs }
         ~ tuvwxyz{|}~  ~

         M ",/^_[`jpqy| M

     Do a screen grab or window dump  of  that  text,  using  for
     instance  xgrabsc(1)  or  screendump(1).  Convert the result
     into a pbm file.  If  necessary,  use  pnmcut(1)  to  remove
     everything   except  the  text.   Finally,  run  it  through
     pnmcrop(1) to make sure the edges are right up  against  the
     text.   Pbmtext  can  figure out the sizes and spacings from
     that.

SEE ALSO
     pbm(5), pnmcut(1), pnmcrop(1)

AUTHOR
     Copyright (C) 1991 by Jef Poskanzer.