Name

DVINup - N-up imposition of DVI files

Synopsis

dvinup [-v-v] [-q] [-d lwidth] [-c] [-w width] [-h height] [-m margin] [-b border] [-p paper] [-n nup] [-nup] [[in.dvi] out.dvi]

Description

DVINup performs n-up imposition on the input file, placing several input pages on each output page. DVINup makes n-up imposition easier; dvitodvi can also be used for this purpose, but dvinup automatically adjusts for the fixed DVI margins.

Either of the -n nup and -nup options can be used to tell dvinup the number of input pages to put on each output page. DVINup tries to find a layout which minimises the amount of wasted space; if it cannot find an acceptable layout, it will abort with an error.

The -w, -h, and -p options are used to set the page size of the input (and output) file; the parameters to -w and -h can be specified in any of the normal TeX dimensions, or the name of a paper size can be given to -p. The currently supported paper sizes are: A3, A4, A5, B5, Letter, Legal, Ledger, Tabloid, Statement, Executive, Folio, Quarto, and 10 by 14 (10x14). If a papersize special command is found in the file, the dimensions specified by it will be used instead.

DVINup normally uses a ``row-major'' layout, where adjacent are placed in rows across the paper. The -c option changes the order to ``column-major'', where successive pages are placed in columns down the paper.

The -m option can be used to specify a margin to leave around the whole page. This is useful for sheets of ``thumbnail'' pages, where the normal page margins are reduced by putting multiple pages onto a single sheet. The -b option is used to specify an additional margin around each page on a sheet. If the -d option specifies a positive dimension, a line of that width will be drawn around each reduced page. The arguments to the -m, -b and -d options can be specified in any of TeX's dimensions.

If the page layout chosen requires the page to be rotated, a landscape special command will be placed in the output DVI file, or removed if there is one in the input file. Any pagesize special commands will be modified to reflect the new orientation of the output.

If no output file is specified on the command line, the output is written to the standard output. If no input file is specified on the command line, the input is read from the standard input.

Examples

The simplest usage of dvinup is to impose a DVI file 2-up:

dvinup -2 input.dvi output.dvi

A more involved example puts 16 input pages on a single (letter-sized) output page, with a 1 point line around each page, and a half-inch border around the entire set of pages to compensate for the reduction in page borders:

dvinup -n 16 -d 1pt -b 0.5in -p letter input.dvi output.dvi

Last modified on 12th February 2004 by angus@harlequin.co.uk