1
2 PSDIM - calculate optimal page layout for n-up printing
3
4 * * *
5
6DESCRIPTION
7
8 Psdim is a small utility to be used in conjunction with pstops. It
9 looks at the contents of a postscript document to determine the size
10 of the printed pages. From this, it calculates the optimal placement
11 of the pages for n-up printing. It outputs a format string suitable
12 for processing by pstops.
13
14 In order to determine the size of the pages in a postscript document
15 accurately, psdim uses the ghostscript interpreter to render the
16 document. For this reason, psdim is relatively slow, but yields very
17 accurate results that could not be obtained by just naively looking
18 at the postscript headers.
19
20DEPENDENCIES
21
22 For psdim to work, ghostscript must be installed on your system.
23
24COMPILATION AND INSTALLATION
25
26 For complete compilation instructions, see the file INSTALL. In
27 practice the following three commands to the trick:
28
29 ./configure
30 make
31 make install
32
33 The ./configure script recognizes the following non-standard options:
34 --enable-metric use metric units (centimeters) as default
35 --enable-a4 use a4 as the default papersize
36
37USAGE
38
39 See the man page for full usage information.
40
41 Usage: psdim [options] [file]
42
43 Options:
44 -h, --help - print this help message and exit
45 -v, --version - print version info and exit
46 -l, --license - print license info and exit
47 -q, --quiet - suppress progress info on stderr
48 -x, --width <dim> - output page width
49 -y, --height <dim> - output page height
50 -p, --page <format> - select output page size (e.g. letter, a4)
51 -m, --margin <dim> - margin around page
52 -n, --hmargin <dim> - horizontal margin (horizontal space)
53 -o, --vmargin <dim> - vertical margin (vertical space)
54 -s, --sep <dim> - separation between pages
55 -t, --hsep <dim> - horizontal separation
56 -u, --vsep <dim> - vertical separation
57 -L, --landscape - landscape orientation
58 -R, --seascape - seascape orientation
59 -U, --upside-down - upside down orientation
60 -P, --portrait - portrait orientation
61 -f, --format <n>x<m> - arrange pages in n rows and m columns
62 -a, --hpolicy <n> - horizontal alignment policy
63 -b, --vpolicy <n> - vertical alignment policy
64 -c, --columnmode - sort pages in columns
65 -d, --righttoleft - page numbers increase right to left
66 -e, --bottomtotop - page numbers increase bottom to top
67 -C, --color - handle non-white backgrounds
68 -S, --shrink - only shrink, never enlarge page
69 -1, --1up - fit to size mode
70 -2, --2up - 1x2 landscape mode
71 -4, --4up - 2x2 portrait mode
72 -8, --8up - 2x4 landscape mode
73 -9, --9up - 3x3 portrait mode
74 -6, --16up - 4x4 portrait mode
75
76 Dimensions can have optional units, e.g. 6.5in, 15cm. Default is
77 inches unless --enable-metric was configured during compilation.
78
79 Valid page formats are: a4, a3, a5, b5, letter, legal, tabloid,
80 statement, executive, folio, quarto, 10x14. Default is letter unless
81 --enable-a4 was configured during compilation.
82
83COPYRIGHT
84
85 Copyright (C) 2001-2005 Peter Selinger
86
87 This program is free software; you can redistribute it and/or modify
88 it under the terms of the GNU General Public License as published by
89 the Free Software Foundation; either version 2 of the License, or (at
90 your option) any later version.
91
92 This program is distributed in the hope that it will be useful, but
93 WITHOUT ANY WARRANTY; without even the implied warranty of
94 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
95 General Public License for more details.
96
97 You should have received a copy of the GNU General Public License
98 along with this program; if not, write to the Free Software
99 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307,
100 USA. See also http://www.gnu.org/.
101
102 See the file COPYING for details.
103
104
105
106