SYNOPSIS
ppmlabel

[-angle angle]

[-background { transparent | color } ]

[-color color]

[-file filename]

[-size

textsize]

[-text text_string]

[-x column]

[-y row]

...

[ppmfile]



EXAMPLE




DESCRIPTION
This program is part of Netpbm.

ppmlabel uses the text drawing facilities of libnetpbm's 'ppmd' compo-
nent to add text to a PBM image. You control the location, size,
baseline angle, color of the text, and background color (if any) with
command line arguments. You can specify the text on the command line
or supply it in files.

You can add any number of separate labels in a single invocation of
ppmlabel, limited only by any restrictions your environment has on the
number and size of program arguments (e.g. a shell's command size
limit).

If you don't specify ppmfile, ppmlabel reads its input PPM image from
Standard Input.

The output image goes to Standard Output.

A more sophisticated way to add a label to an image is to use pbmtext
or pbmtextps to create an image of the text, then pamcomp to overlay
it onto the base image.

Another more general program is ppmdraw. It is slightly harder to use
for simple labelling.


OPTIONS
The arguments on the ppmlabel command line are not options in the
strict sense; they are commands which control the placement and
appearance of the text being added to the input image. They are exe-
cuted left to right, and any number of arguments may appear.

You can abbreviate any option to its shortest unique prefix.



-angle angle


-background { transparent | color }


-color color




-file filename


-size textsize


-text text_string




-x column


-y row This option sets the pixel row which will form the baseline of




LIMITATIONS
Text strings are restricted to 7 bit ASCII. The text font used by
ppmlabel doesn't include definitions for 8 bit ISO 8859/1 characters.

When drawing multiple lines of text with a non-transparent background,
it should probably fill the space between the lines with the back-
ground color. This is tricky to get right when the text is rotated to
a non-orthogonal angle.


SEE ALSO
ppmmake, ppmdraw, pbmtext, pbmtextps, pamcomp, ppm



AUTHOR
Copyright (C) 1995 by John Walker (kelvin@fourmilab.ch) WWW home page:
http://www.fourmilab.ch/

Permission to use, copy, modify, and distribute this software and its
documentation for any purpose and without fee is hereby granted, with-
out any conditions or restrictions. This software is provided ''as
is'' without express or implied warranty.



netpbm documentation 15 April 2006 Ppmlabel User Manual(0)