1man(1) pdfxup man page man(1)
2
3
4
6 pdfxup - n-up tool with reduced margins
7
9 pdfxup [OPTIONS] [FILE]
10
12 pdfxup creates a PDF document where each page is obtained by combining
13 several pages of a PDF file given as output. The important feature of
14 pdfxup, compared to similar programs, is that it tries to compute the
15 (global) bounding box of the input PDF file, in order to remove the
16 margins and to keep the text only. Instead of having the font size
17 divided by 2 (for the case of 2-up output), in some case you may end up
18 with almost the same font size as in the original document (as is the
19 case for a default 'article' document produced by LaTeX).
20
21 pdfxup uses ghostscript for computing the maximal bounding box of (some
22 of) the pages of the document, and then uses pdflatex (with graphicx
23 package) in order to produce the new document.
24
26 pdfxup accepts numerous options. The most important ones are:
27
28 -x n, --columns n
29 sets the number of columns in the output file (default 2);
30
31 -y n, --rows n
32 sets the number of lines in the output file (default 1);
33
34 -l, --landscape
35 sets orientation of paper (of final document) landscape;
36
37 -b (le|se), --booklet (le|se)
38 configure for printing as a booklet. Value 'le' (which is the
39 default value when -b is used with no argument) means that two-
40 sided printing is in 'long-edge' mode (you turn from one page to
41 the next along the long edge of the paper). 'se' is the 'short-
42 edge' option.
43
44 -c, --clip
45 clip pages to the computed bounding box. By default, content is
46 not clipped, which may result in overlap of neighbouring pages.
47 With this option, anything outside the bounding box will not be
48 displayed.
49
50 -o file, --output file
51 name of output file;
52
53 -i ask before overwriting output file;
54
55 -fw d, --framewidth d
56 width of the frame around each page (default 0.4pt). Set to 0pt
57 to have no frame at all;
58
59 -im d, --innermargins d
60 inner margin between frame and page (default 5pt);
61
62 -m d, --margins d
63 margin of pages of the new document (default 5pt);
64
65 -is d, --intspaces d
66 space between different pages (default 1pt);
67
68 -p list, --pages list
69 only consider sublist of pages of input document. List is a
70 comma-separated list of pages or ranges pages of the form a-b; a
71 can be omitted to start from first page, and b can be omitted to
72 end at the last page. Therefore, "-p -" (which is the default)
73 includes all pages. Also allows modulo, so that "-p 0%2" would
74 include only even-numbered pages.
75
76 -bb list, --bb list
77 only consider sublist of pages of input document for computing
78 bounding box;
79
80 -nobb list, --no-bb list
81 omit list of pages of input document from computation of bound‐
82 ing box;
83
84 -g, --get-bb
85 only compute (and output) bounding box;
86
87 -s x y W H, --set-bb x y W H
88 set the bounding box to the given values;
89
90 -w file, --watermark file
91 use file as background watermark. file can be any format
92 accepted by pdflatex (e.g. png or pdf). If file is a multipage
93 PDF file, page n of the watermark file is used with page n of
94 the input file, and the last page of the watermark file is
95 repeated if the input file has more pages;
96
97 -wp p, --watermark-period p
98 repeat the last p pages of the watermark file instead of only
99 the last one;
100
101 -d, --debug
102 debug mode: keep intermediary files;
103
104 -V [0-3], --verbose [0-3]
105 select verbosity (default: 1);
106
107 -q, --quiet
108 run quietly (equiv. '-V=0');
109
110 -v, --version
111 print version number and exit;
112
113 -h, --help
114 print help message and exit.
115
117 # pdfxup file.pdf
118 produces 2-up pdf file from file.pdf
119
120 # pdfxup -bb 1-4 file.pdf
121 same behaviour, but computes the bounding box only using the
122 first 4 pages (this saves time when processing long documents)
123
124 # pdfxup -b -o booklet.pdf file.pdf
125 same behaviour, but creates a booklet (as booklet.pdf)
126
127 # pdfxup -kbb -x1 -y2 -l0 beamer-frames.pdf
128 arranges 2 beamer frames per page (not reducing margins)
129
130 # pdfxup -kbb -x2 -y2 -l beamer-frames.pdf:1-12,15-19
131 arranges 4 beamer frames per page (not reducing margins),
132 including only frames 1 to 12 and 15 to 19.
133
135 gs(1), pdflatex(1)
136
138 Nicolas Markey (pdfxup@markey.fr)
139
140
141
1421.51 06 january 2020 man(1)