PBMTEXT

NAME

      pbmtext - render text into a bitmap

SYNOPSIS

      pbmtext [-font fontfile] [-builtin fontname] [text]

DESCRIPTION

      Takes the specified text, either a single line from the command line
      or multiple lines from standard input, and renders it into a bitmap.
      It is more suited for scripts than for manual use. Otherwise, you should
      use xpaint.

OPTIONS

      By default, pbmtext uses a built-in font called bdf (about a 10 point
      Times-Roman font).  You can use a fixed width font by specifying
      -builtin fixed.
      You can also specify your own font with the -font flag.  The fontfile
      is either a BDF file from the X window system or a PBM file.
      If the fontfile is a PBM file, it is 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 xwd,
      xgrabsc, or screendump.  Convert the result into a pbm file.  If
      necessary, use pnmcut to remove everything except the text.  Finally,
      run it through pnmcrop to make sure the edges are right up against the
      text.  pbmtext can figure out the sizes and spacings from that.

DEMONSTRATION

      What will be shown here is how to obtain an image file that contains a certain string.
      You may use one of the following command:
        pbmmerge pbmtext -builtin bdf "pbmtext allows you to put text in your images." 
          > text1.pbm
        pbmmerge pbmtext -builtin typed "pbmtext allows you to put text in your images."
          > text2.pbm
        pbmmerge pbmtext -font font.pbm "pbmtext allows you to put text in your images." 
          > text3.pbm
      The results magnified two times:

-builtin bdf

-builtin fixed

-font own.pbm (see above for instruction on how to create your own font)

SEE ALSO

      pbm(5), pnmcut(1), pnmpaste(1), pnmcrop(1), ppmpctext(1)

AUTHOR

      Copyright (C) 1993 by Jef Poskanzer and George Phillips