ppmlabel - add text to a portable pixmap
SYNOPSIS
ppmlabel [-angle angle] [-background transparent | colour]
[-colour colour] [-file filename] [-size
textsize] [-text 'text string'] [-x column] [-y
row] ... [ppmfile]
DESCRIPTION
ppmlabel uses the text drawing facilities of ppmdraw to
add text to a portable pixmap. The location, size, base
line angle, colour of the text and background colour (if
any) are controlled by command line arguments. The text
can be specified on the command line or read from files.
Any number of separate text strings can be added by one
invocation of ppmlabel, limited only by the maximum length
of the command line.
If no ppmfile is specified, ppmdraw reads its input pixmap
from standard input.
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 pixmap. They are executed left to right, and any
number of arguments may appear.
All flags can be abbreviated to their shortest unique pre
fix.
-angle angle
Sets the angle of the baseline of subsequent
text. angle is specified as an integral number
of degrees, measured counterclockwise from the
row axis of the pixmap.
-background transparent | colour
If the argument is ``transparent'', text is
drawn over the existing pixels in the pixmap.
If a colour is given (see the -colour switch be
low for information on how to specify colours),
rectangles enclosing subsequent text are filled
with that colour.
-colour colour
Sets the colour for subsequent text. The colour
can be specified in five ways:
· A name, assuming that a pointer to an
X11-style colour names file was compiled
in.
rgb:r/g/b, where r g and b are each 1- to
4-digit hexadecimal numbers.
· An X11-style decimal specifier: rg
bi:r/g/b, where r g and b are floating
point numbers between 0 and 1.
· For backwards compatibility, an old-
X11-style hexadecimal number: #rgb,
#rrggbb, #rrrgggbbb, or #rrrrggggbbbb.
· For backwards compatibility, a triplet of
numbers separated by commas: r,g,b, where
r g and b are floating point numbers be
tween 0 and 1. (This style was added be
fore MIT came up with the similar rgbi
style.)
-file filename
Reads text from the file filename and draws it
on successive lines.
-size textsize
Sets the height of the tallest characters above
the baseline to textsize pixels.
-text 'text string'
Draws the given text string (which must be quot
ed if it contains spaces). The location for
subsequent text is advanced by 1.75 times the
current textsize, which allows drawing multiple
lines of text in a reasonable manner without
specifying the position of each line.
-x column Sets the column at which subsequent text will be
left justified. Depending on the shape of the
first character, the actual text may begin a few
pixels to the right of this point.
-y row Sets the row which will form the baseline of
subsequent text. Characters with descenders,
such as ``y'', will extend below this line.
BUGS
Text strings are restricted to 7 bit ASCII. The text font
used by ppmdraw 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 background colour. This is tricky to get
right when the text is rotated to a non-orthogonal angle.
ppmmake(1), ppm(5)
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 soft
ware and its documentation for any purpose and without fee
is hereby granted, without any conditions or restrictions.
This software is provided ``as is'' without express or im
plied warranty.
Man(1) output converted with
man2html