-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathHelp.html
300 lines (236 loc) · 13.8 KB
/
Help.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head>
<style type="text/css">
body {font-family: verdana,arial,sans-serif;}
</style>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>jPDF Tweak Documentation</title>
</head><body>
<h1>jPDF Tweak Documentation</h1>
<p>This documentation is still incomplete. But it should mention the
strangest things in jPDF Tweak. If you want to help improving it,
<a href="mailto:[email protected]">contact the author</a>.</p>
<h2>System Requirements</h2>
<p>You will need Java 5 or higher to run jPDF tweak.</p>
<h2>Starting</h2>
<p>Start jPDF Tweak by running jpdftweak.bat, double-clicking jpdftweak.jar
or running</p>
<p><tt>java -jar jpdftweak.jar</tt></p>
<p>at the command line.</p>
<h2>The Main Window</h2>
<p>The main window is divided into multiple tabs. You can select
options from as many tabs as you need. Press <b>Run</b> when you are
finished setting options.</p>
<h3>The Input Tab</h3>
<p><img src="Other\Help\Images\shot01.png" width="763" height="544" alt="Input Options"></p>
<p>Select an input file to manipulate. If you want to combine multiple
files, check the checkbox and add more files. They will end up in
the box below, where you can select pages and/or reorder them. Click
Add in the lower left corner to add another entry for a file already
used. If you want to process multiple files the same way, select
batch processing and add multiple files. In that case, you should use
variables in the output filename or each file will overwrite the
previous one.</p>
<p>If the file is encrypted, you will need the owner password to
decrypt it. Yes, I know, it is <i>possible</i> to decrypt by using
the user password only, but it is not <i>allowed</i> to do so.</p>
<p>All page numbers start with 1 (like normal people count), not with 0
(like programmers count). To reverse the page order, use a From Page
that is larger than the To Page.</p>
<p>In case you have odd and even pages in separate documents (or even
more parts), you can use the Interleave feature to merge them again.</p>
<p>When combining multiple files, you might want to start each file on
an odd (or even) page; you can use the "Empty before" option for this.
In case you do not want to care if the document begins on an odd or even
page, you can give two numbers separated by comma, for odd and even page.
Therefore, <tt>0,1</tt> will make the document start on an odd page,
<tt>1,0</tt> on an even page, <tt>1,2</tt> will make it start on an
even page with the odd page before blank, etc.</p>
<p>Note that if you use the "combine multiple files" option, some options
that are usually kept in the document are dropped, even if you only
selected one file! This also applies to the command line mode - if you
use the <tt>-i</tt> option, it will use multiple file mode and drop
page numbers, document info, forms, etc.</p>
<h3>The Page Size Tab</h3>
<p><img src="Other\Help\Images\shot02.png" width="763" height="544" alt="Page Size Options"></p>
<p><b>Crop to</b>: This will crop the visible part of the PDF to one
of the embedded page boxes (if present); Useful if you got a PDF intended
for pre-press with visible crop marks and want to distribute it without
showing the crop marks.</p>
<p><b>Rotate Pages</b>: If you have a PDF that has both Portrait and Landscape pages, and
your printer has problems in printing both, you can rotate the pages
so that they are all Portrait or Landscape afterwards. Of course,
you can use this option as well to rotate all pages.</p>
<p><b>Remove implicit page rotation</b>: PDF knows two ways of
rotating pages; rotating the content or rotating the media
(implicitly) . Some tools have problems with rotated media, so you
can change all Media rotations to content rotations with this
option (The option above creates media rotation as well). jPDF Tweak
should work with rotated media as well. If you have problem with
rotated pages, try checking this option and, if it helps, report a
bug.</p>
<p><b>Scale pages</b>: Useful if your PDF contains pages of different
size. Some tools (like the <i>Shuffle</i> tab of this tool) require
pages of equal size. Use this option to scale all pages to the same
size. Of course, you can use this option as well if all pages are of
equal size. In that case, you might as well use the scale option of
your PDF viewer program.</p>
<p><b>PostScript points</b>: A
<a href="http://en.wikipedia.org/wiki/Point_(typography)">PostScript
point</a> is the 72th of an inch.</p>
<p><b>Center instead of enlarging</b>: Use this option if the new page
size is larger than the old one and the pages should be centered
instead of enlarged.</p>
<p><b>Do not preserve aspect ratio</b>: Causes funnily stretched pages
if the aspect ratio has changed.</p>
<h3>The Watermark Tab</h3>
<p><img src="Other\Help\Images\shot03.png" width="763" height="544" alt="Watermark Options"></p>
<p>Here you can add two kinds of watermarks and page numbers. The text
watermark appears on top of the content, the PDF watermark on
bottom. So if your PDF pages are completely filled (maybe even with
white color), you won't see a
PDF watermark.</p>
<p>Text watermark and page numbers use the built-in Helvetica font
(similar to Arial on Windows systems).</p>
<p>Page numbers can be printed on any corner or edge of the page,
or in the middle (mostly useful for testing purposes). The position
can be mirrored on even pages, to get the page number on the outer
or inner edge for duplex documents.</p>
<p>If plain numbers are not enough for you, you can use a mask to
format your numbers. This mask uses the same syntax as the standard
Java <a href="http://java.sun.com/j2se/1.5/docs/api/java/util/Formatter.html#syntax">formatting
function</a>, and supports the current page number and the total
number of pages as parameters. The current page number is available
in a plain way (1-n) that you can format yourself, and additionally
in a shifted way (if your document's page numbers are shifted), and
in a pre-formatted way (which is interesting for letters or roman
numbers).</p>
<p>In case you want to change the page numbers for the printed values,
you can do this on this tab as well, in the same format as on the
Page Numbers Tab. Note that if you do not select different page numbers
on the Page Numbers Tab, and no other transformation invalidates your
page numbers, these page numbers will also be present in the output
document as if they were configured on the Page Numbers Tab as well.
So, for this common case, it is enough to configure the page numbers once.</p>
<h3>The Shuffle/N-up Tab</h3>
<p><img src="Other\Help\Images\shot04.png" width="763" height="544" alt="Shuffle/N-up Options"></p>
<p>This might be the most powerful, and the most complex tab. Choose
a preset and stick with it <tt>:-)</tt></p>
<p>If you want to print "booklets" that are thicker, you might prefer
to shuffle blocks of 20 pages or so, then fold each of them
individually and stitch them together to a "book".</p>
<p>If you want to build a config yourself: First specify how many
pages each pass (each use of the template) covers. If you select 4
here, and your PDF has 21 pages, it will be run 6 times (5 times
with 4 pages each, and once with the last page). If you give a
negative number, you can take half of the pages from the end of the
document instead of from the beginning. This is useful for booklet
layouts.</p>
<p> Use positive page numbers like "+2" to refer to the second page of the
template, and negative page numbers like "-3" to refer to the third
page of the "opposite" template (i.e. the one if you process the
file from end instead of from beginning). An absolute number without
sign (like "2") refers to the same absolute page (i.e the second
page of the file).</p>
<p>For the offsets and factors: Just tweak them until it looks correct
in the preview. If you rotate a page and it is gone, this is most
likely caused by the fact the the rotation used the lower left
corner as center point and not the center of the page.</p>
<p>Uncheck the <b>NewPageBefore</b> to put more than one source page
onto one destination page.</p>
<p>Yes, creating a config with both positive and negative numbers can
be confusing. For a test, you might add huge page numbers to your
document (see previous tab) so you can see quickly if your config is
correct.</p>
<h3>The Page Numbers Tab</h3>
<p><img src="Other\Help\Images\shot04a.png" width="763" height="544" alt="Shuffle/N-up Options"></p>
<p>Here you can tweak the page numbers that appear in your PDF
reader. Depending on your PDF reader, they can be used for displaying
the current page in the toolbar and status bar, jumping to a page by
its number and/or printing page ranges. Most printed documents have
some kind of title pages and or table of contents that are outside of
the page numbers or are numbered with Roman numbers. This makes it
hard if you read about something "on page 200" to jump to this page
200, because it will be the 205<sup>th</sup> page and not the
200<sup>th</sup> if there are five pages before page 1.</p>
<p>Note that these page numbers do not appear on the page itself. For
this kind of numbers, there is an option on the "Watermark" tab.</p>
<p>To just change the number of the first physical page, click "Add"
once, leave the "Start Page" at one and change the other controls. If
you want to have "gaps" in your page numbers, add more lines and use
"Start page" to point to the physical page numbers (i. e. those that
start from 1) where the format should change.</p>
<p>Assume you have a 6 page PDF, and you set it up as follows:</p>
<table border="1" style="margin: 5px; border: 1px solid gray; border-collapse: collapse">
<tr><th>Start Page</th><th>Style</th><th>Prefix</th><th>Logical Page</th></tr>
<tr><td>1</td><td>Empty</td><td>Title</td><td>1</td></tr>
<tr><td>2</td><td>I, II, III</td><td> </td><td>4</td></tr>
<tr><td>5</td><td>1, 2, 3</td><td>S</td><td>32</td></tr>
</table>
<p>Then the six pages will have numbers <tt>Title</tt>, <tt>IV</tt>,
<tt>V</tt>, <tt>VI</tt>, <tt>S32</tt>, <tt>S33</tt>.</p>
<p>Be careful that your document does not end up having two pages with
the same number (as represented as text) - some versions of Adobe
Reader don't really like that. You can work around it by setting a
prefix for these pages or use different number styles.</p>
<h3>The Bookmarks Tab</h3>
<p><img src="Other\Help\Images\shot05.png" width="763" height="544" alt="Bookmark Options"></p>
<p>Here you can tweak chapter bookmarks. If you selected more than one
input file, chapter bookmarks will be combined automatically. But if
you select individual pages or ranges instead of the full document,
you will have to tweak the bookmarks manually.</p>
<p>If you want to create bookmarks from scratch, it is useful to open
existing PDFs and look what the bookmarks look like in there. If you
want to add bookmarks that do not only point to a page but to a
position on a page, you might need a tool like GSView (from
GhostScript) which shows coordinates when moving the cursor on a PDF
file.</p>
<h3>The Attachments Tab</h3>
<p><img src="Other\Help\Images\shot06.png" width="763" height="544" alt="Attachment Options"></p>
<p>Here you can add attachments and remove files you erroneously
attached before. This view does not show which files have been
attached to the original document. If you need them, use your PDF
viewer to save them and reattach them if necessary.</p>
<h3>The Interaction Tab</h3>
<p><img src="Other\Help\Images\shot07.png" width="763" height="544" alt="Interaction Options"></p>
<p>This tab is interesting. When a PDF file is shown in full screen
mode, pages can flip automatically and/or with a nice effect. Select
effects and/or durations (durations are in seconds) on the left. You
can set viewer preferences (how the document should be opened) on
the right.</p>
<h3>The Document Info Tab</h3>
<p><img src="Other\Help\Images\shot08.png" width="763" height="544" alt="Document Info Options"></p>
<p>Here you can add information to the document info dictionary (shown
when you open "Document summary"</p>
<h3>The Encrypt/Sign Tab</h3>
<p><img src="Other\Help\Images\shot09.png" width="763" height="544" alt="Encrypt/Sign Options"></p>
<p>Encrypting is quite standard nowadays, so I won't write much
here. If you know the owner password, you may do everything with the
document; if you know only the user password, you may only do things
checked below. The user password may be empty, the owner password
may not (but you can use the same password for both if desired).</p>
<p>Signing is a bit more tricky, since you need a key and a
certificate for this to be useful. Import that key into a Java
KeyStore (using Sun's <tt>keytool</tt> tool), and you can use it
from here.</p>
<h3>The Output Tab</h3>
<p><img src="Other\Help\Images\shot10.png" width="763" height="544" alt="Output Options"></p>
<p>Don't forget this tab! Select an output filename here. If you
select a name of an existing file, you will receive a warning.
However, if you run jPDF tweak more than once, it will <b>not</b>
create a warning since warnings are annoying if you are just trying
to find the right settings by trial and error.</p>
<p>You may optionally burst the document into single page PDFs. Note
that not all features (like bookmarks, transitions or viewer
preferences) make sense when you burst a document.</p>
<p>When you save a document uncompressed, you can add page marks
(compatible to pdftk's page marks) to find pages easier in the PDF
source code. Search for "pdftk_PageNum" in the uncompressed
PDF to find a page. When you compress a PDF again, you can remove
these marks.</p>
<p>In case the matching JMuPdf native library is present, you can
also burst the document to images or save it as a multipage TIFF
document.</p>
<hr>
© 2007-2011 Michael Schierl
</body></html>