pnmtops(1)

NAME
pnmtops - convert portable anymap to PostScript

SYNOPSIS
pnmtops [-scale s] [-dpi n] [-width n] [-height n] [-turn|-noturn] [-rle|-runlength] [-center|-nocenter] [pnmfile]

DESCRIPTION
Reads a portable anymap as input. Produces Encapsulated PostScript as output.

If the input file is in color (PPM), pnmtops generates a color PostScript file. Some PostScript interpreters can't handle color PostScript. If you have one of these you will need to run your image through ppmtopgm first.

OPTIONS

The -scale option controls the scale of the result. The default scale is 1, which on a 300 dpi printer such as the Apple LaserWriter makes the output look about the same size as the input would if it was displayed on a typical 72 dpi screen. To get one PNM pixel per 300 dpi printer pixel, use "-scale 0.25".

The -dpi option lets you specify the dots per inch of your output device. The default is 300 dpi. In theory PostScript is device-independent and you don't have to worry about this, but in practice its raster rendering can have unsightly bands if the device pixels and the image pixels aren't in sync.

The -width and -height options let you specify the size of the page. The default is 8.5 inches by 11 inches.

The -turn and -noturn options control whether the image gets turned 90 degrees. Normally, if an image is wider than it is tall, it gets turned automatically to better fit the page. If you specify the -turn option, pnmtops turns the image no matter what its shape; If you specify -noturn, pnmtops does not turn it no matter what its shape.

The -rle or -runlength option specifies run-length compression. This may save time if the host-to-printer link is slow; but normally the printer's processing time dominates, so -rle makes things slower.

By default, pnmtops centers the image on the output page. You can specify this explicitly with the -center option, or cause pnmtops to instead put the image against the upper left corner of the page with the -nocenter option. The latter is useful for programs which can include PostScript files, but can't cope with pictures which are not positioned in the upper left corner.

All options can be abbreviated to their shortest unique prefix.

SEE ALSO
pnm (5), psidtopgm (1), psotpnm (1), ppmtopgm (1)

AUTHOR
Copyright (C) 1989, 1991 by Jef Poskanzer.
Modified November 1993 by Wolfgang Stuerzlinger, wrzl@gup.uni-linz.ac.at