« back to all changes in this revision
Viewing changes to docs/pdfposter.html
- browse files at revision 6
- compare with another revision
- download diff
- download tarball
- view history from revision 6
- Committer: Package Import Robot
- Author(s): Elena Grandi, Jakub Wilk, Elena Grandi
- Date: 2013-05-22 10:03:38 UTC
- mfrom: (1.1.2)
- Revision ID: package-import@ubuntu.com-20130522100338-26uo6rmqsurfcfzv
Tags: 0.6.0-1
[ Jakub Wilk ]
* Use canonical URIs for Vcs-* fields.
[ Elena Grandi ]
* New upstream release
* Regenerate PDF files from python sources
* Include html documentation
* Updated homepage and author contacts
* debian/control: bump Standards-Version to 3.9.3 (no changes needed).
* Use canonical URIs for Vcs-* fields.
[ Elena Grandi ]
* New upstream release
* Regenerate PDF files from python sources
* Include html documentation
* Updated homepage and author contacts
* debian/control: bump Standards-Version to 3.9.3 (no changes needed).
- files added:
- INSTALL
- docs
- docs/images
- files removed:
- .pc/graceful_failure_on_non_pdf.diff
- .pc/graceful_failure_on_non_pdf.diff/pdftools
- .pc/graceful_failure_on_non_pdf.diff/pdftools/pdfposter
- files modified:
- .pc/applied-patches
added
removed
docs/pdfposter.html
1
<?xml version="1.0" encoding="utf-8" ?>
2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4
<head>
5
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
6
<meta name="generator" content="Docutils 0.7: http://docutils.sourceforge.net/" />
7
<title>pdfposter</title>
8
<meta name="author" content="Hartmut Goebel <h.goebel@crazy-compilers.com>" />
9
<meta name="copyright" content="2008-2013 by Hartmut Goebel" />
10
<style type="text/css">
11
12
/*
13
:Author: David Goodger (goodger@python.org)
14
:Id: $Id: html4css1.css 6253 2010-03-02 00:24:53Z milde $
15
:Copyright: This stylesheet has been placed in the public domain.
16
17
Default cascading style sheet for the HTML output of Docutils.
18
19
See http://docutils.sf.net/docs/howto/html-stylesheets.html for how to
20
customize this style sheet.
21
*/
22
23
/* used to remove borders from tables and images */
24
.borderless, table.borderless td, table.borderless th {
25
border: 0 }
26
27
table.borderless td, table.borderless th {
28
/* Override padding for "table.docutils td" with "! important".
29
The right padding separates the table cells. */
30
padding: 0 0.5em 0 0 ! important }
31
32
.first {
33
/* Override more specific margin styles with "! important". */
34
margin-top: 0 ! important }
35
36
.last, .with-subtitle {
37
margin-bottom: 0 ! important }
38
39
.hidden {
40
display: none }
41
42
a.toc-backref {
43
text-decoration: none ;
44
color: black }
45
46
blockquote.epigraph {
47
margin: 2em 5em ; }
48
49
dl.docutils dd {
50
margin-bottom: 0.5em }
51
52
/* Uncomment (and remove this text!) to get bold-faced definition list terms
53
dl.docutils dt {
54
font-weight: bold }
55
*/
56
57
div.abstract {
58
margin: 2em 5em }
59
60
div.abstract p.topic-title {
61
font-weight: bold ;
62
text-align: center }
63
64
div.admonition, div.attention, div.caution, div.danger, div.error,
65
div.hint, div.important, div.note, div.tip, div.warning {
66
margin: 2em ;
67
border: medium outset ;
68
padding: 1em }
69
70
div.admonition p.admonition-title, div.hint p.admonition-title,
71
div.important p.admonition-title, div.note p.admonition-title,
72
div.tip p.admonition-title {
73
font-weight: bold ;
74
font-family: sans-serif }
75
76
div.attention p.admonition-title, div.caution p.admonition-title,
77
div.danger p.admonition-title, div.error p.admonition-title,
78
div.warning p.admonition-title {
79
color: red ;
80
font-weight: bold ;
81
font-family: sans-serif }
82
83
/* Uncomment (and remove this text!) to get reduced vertical space in
84
compound paragraphs.
85
div.compound .compound-first, div.compound .compound-middle {
86
margin-bottom: 0.5em }
87
88
div.compound .compound-last, div.compound .compound-middle {
89
margin-top: 0.5em }
90
*/
91
92
div.dedication {
93
margin: 2em 5em ;
94
text-align: center ;
95
font-style: italic }
96
97
div.dedication p.topic-title {
98
font-weight: bold ;
99
font-style: normal }
100
101
div.figure {
102
margin-left: 2em ;
103
margin-right: 2em }
104
105
div.footer, div.header {
106
clear: both;
107
font-size: smaller }
108
109
div.line-block {
110
display: block ;
111
margin-top: 1em ;
112
margin-bottom: 1em }
113
114
div.line-block div.line-block {
115
margin-top: 0 ;
116
margin-bottom: 0 ;
117
margin-left: 1.5em }
118
119
div.sidebar {
120
margin: 0 0 0.5em 1em ;
121
border: medium outset ;
122
padding: 1em ;
123
background-color: #ffffee ;
124
width: 40% ;
125
float: right ;
126
clear: right }
127
128
div.sidebar p.rubric {
129
font-family: sans-serif ;
130
font-size: medium }
131
132
div.system-messages {
133
margin: 5em }
134
135
div.system-messages h1 {
136
color: red }
137
138
div.system-message {
139
border: medium outset ;
140
padding: 1em }
141
142
div.system-message p.system-message-title {
143
color: red ;
144
font-weight: bold }
145
146
div.topic {
147
margin: 2em }
148
149
h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
150
h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
151
margin-top: 0.4em }
152
153
h1.title {
154
text-align: center }
155
156
h2.subtitle {
157
text-align: center }
158
159
hr.docutils {
160
width: 75% }
161
162
img.align-left, .figure.align-left, object.align-left {
163
clear: left ;
164
float: left ;
165
margin-right: 1em }
166
167
img.align-right, .figure.align-right, object.align-right {
168
clear: right ;
169
float: right ;
170
margin-left: 1em }
171
172
img.align-center, .figure.align-center, object.align-center {
173
display: block;
174
margin-left: auto;
175
margin-right: auto;
176
}
177
178
.align-left {
179
text-align: left }
180
181
.align-center {
182
clear: both ;
183
text-align: center }
184
185
.align-right {
186
text-align: right }
187
188
/* reset inner alignment in figures */
189
div.align-right {
190
text-align: left }
191
192
/* div.align-center * { */
193
/* text-align: left } */
194
195
ol.simple, ul.simple {
196
margin-bottom: 1em }
197
198
ol.arabic {
199
list-style: decimal }
200
201
ol.loweralpha {
202
list-style: lower-alpha }
203
204
ol.upperalpha {
205
list-style: upper-alpha }
206
207
ol.lowerroman {
208
list-style: lower-roman }
209
210
ol.upperroman {
211
list-style: upper-roman }
212
213
p.attribution {
214
text-align: right ;
215
margin-left: 50% }
216
217
p.caption {
218
font-style: italic }
219
220
p.credits {
221
font-style: italic ;
222
font-size: smaller }
223
224
p.label {
225
white-space: nowrap }
226
227
p.rubric {
228
font-weight: bold ;
229
font-size: larger ;
230
color: maroon ;
231
text-align: center }
232
233
p.sidebar-title {
234
font-family: sans-serif ;
235
font-weight: bold ;
236
font-size: larger }
237
238
p.sidebar-subtitle {
239
font-family: sans-serif ;
240
font-weight: bold }
241
242
p.topic-title {
243
font-weight: bold }
244
245
pre.address {
246
margin-bottom: 0 ;
247
margin-top: 0 ;
248
font: inherit }
249
250
pre.literal-block, pre.doctest-block {
251
margin-left: 2em ;
252
margin-right: 2em }
253
254
span.classifier {
255
font-family: sans-serif ;
256
font-style: oblique }
257
258
span.classifier-delimiter {
259
font-family: sans-serif ;
260
font-weight: bold }
261
262
span.interpreted {
263
font-family: sans-serif }
264
265
span.option {
266
white-space: nowrap }
267
268
span.pre {
269
white-space: pre }
270
271
span.problematic {
272
color: red }
273
274
span.section-subtitle {
275
/* font-size relative to parent (h1..h6 element) */
276
font-size: 80% }
277
278
table.citation {
279
border-left: solid 1px gray;
280
margin-left: 1px }
281
282
table.docinfo {
283
margin: 2em 4em }
284
285
table.docutils {
286
margin-top: 0.5em ;
287
margin-bottom: 0.5em }
288
289
table.footnote {
290
border-left: solid 1px black;
291
margin-left: 1px }
292
293
table.docutils td, table.docutils th,
294
table.docinfo td, table.docinfo th {
295
padding-left: 0.5em ;
296
padding-right: 0.5em ;
297
vertical-align: top }
298
299
table.docutils th.field-name, table.docinfo th.docinfo-name {
300
font-weight: bold ;
301
text-align: left ;
302
white-space: nowrap ;
303
padding-left: 0 }
304
305
h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
306
h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
307
font-size: 100% }
308
309
ul.auto-toc {
310
list-style-type: none }
311
312
</style>
313
</head>
314
<body>
315
<div class="document" id="pdfposter">
316
<h1 class="title">pdfposter</h1>
317
<h2 class="subtitle" id="scale-and-tile-pdf-images-pages-to-print-on-multiple-pages">Scale and tile PDF images/pages to print on multiple pages.</h2>
318
<table class="docinfo" frame="void" rules="none">
319
<col class="docinfo-name" />
320
<col class="docinfo-content" />
321
<tbody valign="top">
322
<tr><th class="docinfo-name">Author:</th>
323
<td>Hartmut Goebel <<a class="reference external" href="mailto:h.goebel@crazy-compilers.com">h.goebel@crazy-compilers.com</a>></td></tr>
324
<tr><th class="docinfo-name">Version:</th>
325
<td>Version 0.6.0</td></tr>
326
<tr><th class="docinfo-name">Copyright:</th>
327
<td>2008-2013 by Hartmut Goebel</td></tr>
328
<tr class="field"><th class="docinfo-name">Licence:</th><td class="field-body">GNU Public Licence v3 (GPLv3)</td>
329
</tr>
330
<tr class="field"><th class="docinfo-name">Manual section:</th><td class="field-body">1</td>
331
</tr>
332
</tbody>
333
</table>
334
<!-- -*- mode: rst ; ispell-local-dictionary: "american" -*- -->
335
<div class="section" id="synopsis">
336
<h1>SYNOPSIS</h1>
337
<p><tt class="docutils literal">pdfposter</tt> <options> infile outfile</p>
338
</div>
339
<div class="section" id="description">
340
<h1>DESCRIPTION</h1>
341
<p><tt class="docutils literal">Pdfposter</tt> can be used to create a large poster by building it from
342
multple pages and/or printing it on large media. It expects as input a
343
PDF file, normally printing on a single page. The output is again a
344
PDF file, maybe containing multiple pages together building the
345
poster.
346
The input page will be scaled to obtain the desired size.</p>
347
<!-- comment
348
The output pages bear cutmarks and have slightly overlapping
349
images for easier assembling. -->
350
<p>The program uses a simple but efficient method which is possible with
351
PDF: All new pages share the same data stream of the scaled page. Thus
352
resulting file grows moderatly.</p>
353
<p>To control its operation, you need to specify either the size of the
354
desired poster or a scale factor for the image:</p>
355
<ul class="simple">
356
<li>Given the poster size, it calculates the required number of sheets
357
to print on, and from that a scale factor to fill these sheets
358
optimally with the input image.</li>
359
<li>Given a scale factor, it derives the required number of pages from
360
the input image size, and positions the scaled image centered on
361
this area.</li>
362
</ul>
363
</div>
364
<div class="section" id="options">
365
<h1>OPTIONS</h1>
366
<div class="section" id="general-options">
367
<h2>General Options</h2>
368
<table class="docutils option-list" frame="void" rules="none">
369
<col class="option" />
370
<col class="description" />
371
<tbody valign="top">
372
<tr><td class="option-group">
373
<kbd><span class="option">--version</span></kbd></td>
374
<td>Show program's version number and exit</td></tr>
375
<tr><td class="option-group">
376
<kbd><span class="option">-h</span>, <span class="option">--help</span></kbd></td>
377
<td>Show help message and exit</td></tr>
378
<tr><td class="option-group" colspan="2">
379
<kbd><span class="option">--help-media-names</span></kbd></td>
380
</tr>
381
<tr><td> </td><td>List available media and distance names and exit</td></tr>
382
<tr><td class="option-group">
383
<kbd><span class="option">-v</span>, <span class="option">--verbose</span></kbd></td>
384
<td>Be verbose. Tell about scaling, rotation and number of
385
pages. Can be used more than once to increase the
386
verbosity.</td></tr>
387
<tr><td class="option-group">
388
<kbd><span class="option">-n</span>, <span class="option">--dry-run</span></kbd></td>
389
<td>Show what would have been done, but do not generate files.</td></tr>
390
<tr><td class="option-group">
391
<kbd><span class="option">-A</span>, <span class="option">--art-box</span></kbd></td>
392
<td>Use the content area defined by the ArtBox (default:
393
use the area defined by the TrimBox)</td></tr>
394
</tbody>
395
</table>
396
</div>
397
<div class="section" id="defining-output">
398
<h2>Defining Output</h2>
399
<table class="docutils option-list" frame="void" rules="none">
400
<col class="option" />
401
<col class="description" />
402
<tbody valign="top">
403
<tr><td class="option-group" colspan="2">
404
<kbd><span class="option">-m <var>BOX</var></span>, <span class="option">--media-size=<var>BOX</var></span></kbd></td>
405
</tr>
406
<tr><td> </td><td>Specify the desired media size to print on.
407
See below for <em>BOX</em>. The default is A4 in the standard
408
package.</td></tr>
409
<tr><td class="option-group" colspan="2">
410
<kbd><span class="option">-p <var>BOX</var></span>, <span class="option">--poster-size=<var>BOX</var></span></kbd></td>
411
</tr>
412
<tr><td> </td><td><p class="first">Specify the poster size. See below for <em>BOX</em>.
413
pdfposter will autonomously choose scaling and rotation to
414
best fit the input onto the poster (see EXAMPLES below).</p>
415
<p class="last">If you give neither the <em>-s</em> nor the <em>-p</em> option, the default
416
poster size is identical to the media size.</p>
417
</td></tr>
418
<tr><td class="option-group">
419
<kbd><span class="option">-s <var>NUMBER</var></span></kbd></td>
420
<td><p class="first">Specify a linear scaling factor to produce the poster.
421
Together with the input image size and optional margins,
422
this induces an output poster size. So don't specify both <em>-s</em>
423
and <em>-p</em>.</p>
424
<p class="last">Default is deriving the scale factor to fit a given poster
425
size.</p>
426
</td></tr>
427
</tbody>
428
</table>
429
</div>
430
<div class="section" id="box-definition">
431
<h2>Box Definition</h2>
432
<p>The <em>BOX</em> mentioned above is a specification of horizontal and
433
vertical size. The syntax is as follows (with multipier being
434
specified optionally):</p>
435
<blockquote>
436
<p><em>box</em> = [ <em>multiplier</em> ] <em>unit</em></p>
437
<p><em>multiplier</em> = <em>number</em> "x" <em>number</em></p>
438
<p><em>unit</em> = <em>medianame</em> or <em>distancename</em></p>
439
</blockquote>
440
<!-- Only in combination with the *-i* option, the program
441
also understands the offset specification in the *BOX*.
442
<offset> = +<number>,<number>
443
[<offset>]
444
and offset -->
445
<p>Many international media names are recognised by the program, in upper
446
and lower case, and can be shortened to their first few characters, as
447
long as unique. For instance 'A0', 'Let'. Distance names are like
448
'cm', 'inch', 'ft'.</p>
449
<p>Medias are typically not quadratic but rectangular, which means width
450
and hight differ. Thus using medianames is a bit tricky:</p>
451
<table class="docutils field-list" frame="void" rules="none">
452
<col class="field-name" />
453
<col class="field-body" />
454
<tbody valign="top">
455
<tr class="field"><th class="field-name">10x20cm:</th><td class="field-body">obviuos: 10 cm x 20 cm (portrait)</td>
456
</tr>
457
<tr class="field"><th class="field-name">20x10cm:</th><td class="field-body">same as 10x20cm, since all boxes are rotated to portrait
458
format</td>
459
</tr>
460
</tbody>
461
</table>
462
<p>Now when using medianames it gets tricky:</p>
463
<table class="docutils field-list" frame="void" rules="none">
464
<col class="field-name" />
465
<col class="field-body" />
466
<tbody valign="top">
467
<tr class="field"><th class="field-name">1x1a4:</th><td class="field-body"><p class="first">same as approx. 21x29cm (21 cm x 29 cm, portrait)</p>
468
</td>
469
</tr>
470
<tr class="field"><th class="field-name">1x2a4:</th><td class="field-body"><p class="first">same as approx. 21x58cm (21 cm x 58 cm, portrait)</p>
471
<p>This are two a4 pages put together at the <em>small</em> side: One
472
portrait page wide and two portrait pages high.</p>
473
</td>
474
</tr>
475
<tr class="field"><th class="field-name">2x1a4:</th><td class="field-body"><p class="first">same as approx. 42x29cm, which is rotated to portrait and is
476
the same a 29x42cm (29 cm x 42 cm)</p>
477
<p class="last">This are two a4 pages put together at the <em>long</em> side: Two
478
portrait pages wide and one portrait page high.</p>
479
</td>
480
</tr>
481
</tbody>
482
</table>
483
</div>
484
</div>
485
<div class="section" id="examples">
486
<h1>EXAMPLES</h1>
487
<table class="docutils field-list" frame="void" rules="none">
488
<col class="field-name" />
489
<col class="field-body" />
490
<tbody valign="top">
491
<tr class="field"><th class="field-name" colspan="2">pdfposter -mA3 -pA0 a4.pdf out.pdf:</th></tr>
492
<tr><td> </td><td class="field-body">Prints an A4 input file on 8 A3 pages, forming an A0 poster.</td>
493
</tr>
494
<tr class="field"><th class="field-name" colspan="2">pdfposter -p3x3Let a4.pdf out.pdf:</th></tr>
495
<tr><td> </td><td class="field-body">Prints an inputfile on a poster of 3x3 Letter pages.</td>
496
</tr>
497
</tbody>
498
</table>
499
<!-- not yet implemented: margins
500
:pdfposter -mA0 -w2x2i input.pdf out.pdf:
501
Enlarges an inputfile to print on a large-media A0 capable
502
device, maintaining 2 inch margins: -->
503
<table class="docutils field-list" frame="void" rules="none">
504
<col class="field-name" />
505
<col class="field-body" />
506
<tbody valign="top">
507
<tr class="field"><th class="field-name" colspan="2">pdfposter -mA0 input.pdf out.pdf:</th></tr>
508
<tr><td> </td><td class="field-body">Enlarges an inputfile to print on a large-media A0 capable
509
device.</td>
510
</tr>
511
<tr class="field"><th class="field-name" colspan="2">pdfposter -s4 input.pdf out.pdf:</th></tr>
512
<tr><td> </td><td class="field-body">Enlarge an inputfile exactly 4 times, print on the default A4
513
media, and let <tt class="docutils literal">pdfposter</tt> determine the number of pages
514
required.</td>
515
</tr>
516
</tbody>
517
</table>
518
<!-- not yet implemented
519
:pdfposter -mLegal -p1x1m -w10% -C5 input.pdf out.pdf:
520
Scale a postscript image to a poster of about 1 square meter,
521
printing on 'Legal' media, maintaining a 10% of 'Legal' size
522
as white margin around the poster. Print cutmark lines and grid
523
labels, but don't print cut mark arrow heads. -->
524
<table class="docutils field-list" frame="void" rules="none">
525
<col class="field-name" />
526
<col class="field-body" />
527
<tbody valign="top">
528
<tr class="field"><th class="field-name" colspan="2">pdfposter -m10x10cm -pa0 a4.pdf out.pdf:</th></tr>
529
<tr><td> </td><td class="field-body">Just to show how efficient <tt class="docutils literal">pdfposter</tt> is: This will create a file
530
containing 192 pages, but only 15 times as big as the single page.
531
With a4.pdf being a quite empty page, this ratio should be even
532
better for filled pages.</td>
533
</tr>
534
</tbody>
535
</table>
536
<p>More examples including sample pictures can be found at
537
<a class="reference external" href="http://pythonhosted.org/pdftools.pdfposter/examples">http://pythonhosted.org/pdftools.pdfposter/examples</a></p>
538
<div class="section" id="examples-for-automatic-scaling">
539
<h2>Examples for automatic scaling</h2>
540
<ul>
541
<li><p class="first">For printing 2 <em>portrait</em> A4 pages high (approx. 58cm) and let
542
pdfposter determine how many portrait pages wide, specify a lage
543
number of <em>vertical</em> pages. eg:</p>
544
<blockquote>
545
<table class="docutils field-list" frame="void" rules="none">
546
<col class="field-name" />
547
<col class="field-body" />
548
<tbody valign="top">
549
<tr class="field"><th class="field-name" colspan="2">pdfposter -p999x2a4 testpage-wide.pdf out.pdf:</th></tr>
550
<tr><td> </td><td class="field-body"></td>
551
</tr>
552
</tbody>
553
</table>
554
</blockquote>
555
</li>
556
<li><p class="first">For printing 2 <em>landscape</em> A4 pages high (approx. 20cm) and let
557
pdfposter determine how many landscape pages wide, specify a lage
558
number of <em>horizontal</em> pages. eg:</p>
559
<blockquote>
560
<table class="docutils field-list" frame="void" rules="none">
561
<col class="field-name" />
562
<col class="field-body" />
563
<tbody valign="top">
564
<tr class="field"><th class="field-name" colspan="2">pdfposter -p2x999a4 testpage-wide.pdf out.pdf:</th></tr>
565
<tr><td> </td><td class="field-body"></td>
566
</tr>
567
</tbody>
568
</table>
569
</blockquote>
570
</li>
571
</ul>
572
</div>
573
</div>
574
<div class="section" id="see-also">
575
<h1>SEE ALSO</h1>
576
<p><tt class="docutils literal">poster</tt>(1),
577
<tt class="docutils literal">pdfnup</tt>(1) <a class="reference external" href="http://pypi.python.org/pypi/pdfnup/">http://pypi.python.org/pypi/pdfnup/</a>,
578
<tt class="docutils literal">pdfsplit</tt>(1) <a class="reference external" href="http://pypi.python.org/pypi/pdfsplit/">http://pypi.python.org/pypi/pdfsplit/</a>,
579
<tt class="docutils literal">pdfgrid</tt>(1) <a class="reference external" href="http://pypi.python.org/pypi/pdfgrid/">http://pypi.python.org/pypi/pdfgrid/</a></p>
580
<p>Project Homepage <a class="reference external" href="http://pythonhosted.org/pdftools.pdfposter/">http://pythonhosted.org/pdftools.pdfposter/</a></p>
581
</div>
582
</div>
583
</body>
584
</html>
Loggerhead is a web-based interface for Breezy
Version: 2.0.1