.TH pnmframe "13 Apr 1994"
.SH NAME
pnmframe - add borders to portable anymap
.SH SYNOPSIS
pnmframe [-white|-black] [-l#] [-r#] [-t#] [-b#] [-d#] [-m#] [pnmfile]
.SH DESCRIPTION
Reads a portable anymap as input. Outputs a portable anymap with extra
borders.
The colour of the borders can be set to black or white (default black).

The left, right, top and bottom borders can be set with the -l, -r, -t and -b
option. In addition to this functionality (from pnmpad), there are two new 
options, which are very useful in an automatic printing environment.
There are printers (for example the Lasergraphics Film Recorder) which
have a built in scaling function. This is usually much better than 
using a software-scaling tool. The problem is, that the built in function
knows nothing about some physical restictions. The film recorder uses the
whole film area. If you put the slide in a frame, there may be a loss of
information, because the frame window is smaller than the film area.

With the -d option you can give a denominator. The number of columns and
rows are divided by this value and the greater value gives the new border, which
is added around the picture (newcolumns = columns + columns / denominator).
All above options (-l, -r, -t and -b) are ignored.
If the resulting border is 0, because the picture is to small, you can use
the -m option, which gives a 'minframe' value, which means a minimum border
size. 

For the Lasergraphics Film Recorder with 2k resolution we use -d32 -m2,
which always gives a good result.

If you use the -m option in conjunction with the -l, -r, -t and -b options,
all values which are smaller than the minframe value are set to the value
you give in the -m option. At the start of the program by default all missing
values are set to 0. This means for example, if you don't use the -l option,
the value is also set to the minframe value.
So the -m option is also useful for adding a border to a picture.

.SH "SEE ALSO"
pnmpad(1), pnmpaste(1)
.SH AUTHOR
Copyright (C) 1994 by Rolf Mayer, Rolf.Mayer@rz.uni-karlsruhe.de
.nf
based on pnmpad
Copyright (C) 1990 by Angus Duggan,
Copyright (C) 1989 by Jef Poskanzer.
.fi

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
documentation.  This software is provided "as is" without express or
implied warranty.