summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1/thumbpdf.1
blob: 3fb26327aba921422f56c8c568f7b562835a70f4 (plain)
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
.TH "thumbpdf" "1" "August 2011" "TeX" "TeX" 
.PP 
.SH "NAME" 
thumbpdf \- generate thumbnail images for a PDF file
created with \fBpdftex\fP
.PP 
.SH "SYNOPSIS" 
.PP 
\fBthumbpdf\fP [ \fIOPTION\fP\&.\&.\&. ]  \fIFILE\fP.[pdf|ps]
.PP 
.SH "DESCRIPTION" 
.PP 
\fBthumbpdf\fP is used to create thumbnail images of individual pages
within a PDF (Portable Document Format) document\&.
.PP 
.SH "USAGE" 
.PP 
First use \fBpdftex\fP(1) or another method to create a PDF file\&.
Then run \fBthumbpdf\fP to generate the thumbnails, a PDF file
containing the thumbnails, and a pdfTeX file to include the thumbnails
in the PDF file\&.  Finally, run \fBpdftex\fP(1) on your file again to
create the final PDF file\&.
.PP 
\fBthumbpdf\fP calls \fBgs\fP(1) to generate PNG images of the pages
within \fIPDF_FILE\fP, and \fBpdftex\fP(1) to create a PDF file
containing the thumbnail images\&.
.PP 
.SH "OPTIONS" 
.PP 
.IP "\fB--help\fP" 
print usage
.IP "\fB--(no)quiet\fP" 
suppress messages (default: false)
.IP "\fB--(no)verbose\fP" 
verbose messages (default: false)
.IP "\fB--(no)debug\fP" 
print debugging information while parsing (default: false)
.IP "\fB--(no)makepng\fP" 
make PNG thumbnail images (default: true)
.IP "\fB--(no)makepdf\fP" 
generate new PDF file containing the thumbnails (default: true)
.IP "\fB--(no)makedata\fP" 
create a TeX file for \fIthumbpdf.sty\fP (default: true)
.IP "\fB--(no)clean\fP
clear temp files (default: true)
.IP "\fB--(no)useps\fP
have \fBmakepng\fI use .ps instead of .pdf (default: false)
.IP "\fB--(no)level2\fP
generate .tpm with PostScript Level 2 features (default: false)
.IP "\fB--(no)greek\fP
text in Greek style, experimental (default: false)
.IP "\fB--antialias\fP \fInum1[num2]\fP" 
anti-aliasing, 0=disable, 4=max (default: 4)
.IP "\fB--device|png\fP | [\fBpng\fP]\fIdev\fP" 
GhostScript PNG device;
\fIdev\fP = `mono\', `gray\', `16\', `256\', `16m\' (default: `png16m\')
.IP "\fB--resolution\fP \fIres\fP" 
resolution for makepng (default: 9)
.IP "\fB--compress\fP \fIn\fP" 
thumbnail compresslevel for \fBthumbpdf\&.pdf\fP (0-10; default: 10)
.IP "\fB--password\fP \fInpw\fP" 
for an encrypted pdf file
.PP 
.SH "FILES" 
.PP 
.IP "\fIjobname\fP\fI\&.tpt\fP" 
(\fI.tpm\fP for pdfmark) data files for \fIthumbpdf.sty\fP.
.IP "\fIthumb\fPnn\fI\&.png\fP" 
PNG thumbnail images
.IP "\fIthumbpdf\&.pdf\fP" 
PDF file containing thumbnail images
.IP "\fIthumbpdf\&.tex\fP" 
a pdfTeX program to include the thumbnails
file
.IP "\fIthumbpdf\&.log\fP" 
pdfTeX log file
.IP "\fIthumbpdf\&.sty\fP" 
a LaTeX package to be included in files
for which a user wants to generate thumbnails
.PP 
.SH "SEE ALSO" 
.PP 
\fBgs\fP(1), \fBpdftex\fP(1)\&.
.PP 
Web page: <http://ctan\&.org/pkg/thumbpdf>
.PP 
.SH "BUGS" 
.PP 
None known, but report any bugs found to the author\&.
.PP 
.SH "COPYRIGHT" 
.PP 
Copyright © 1999-2011\&.  \fBthumbpdf\fP is distributed under
version 1, or (at your option) a later version of the LaTeX Project
Public License\&.
.PP 
.SH "AUTHOR" 
.PP 
\fBthumbpdf\fP was written by Heiko Oberdiek
<oberdiek@ruf\&.uni-freiburg\&.de>\&.
.PP 
This manual page was originally written by C\&.M\&. Connelly
<c@eskimo\&.com>, for
the Debian GNU/Linux system, and slightly updated by Karl Berry
<karl@freefriends\&.org>
for the latest \fBthumbpdf\fP in 2011\&.
It may be used by other distributions
without contacting the authors\&.  Any mistakes or omissions in the
manual page are our fault; inquiries about or corrections to this
manual page should be directed to us (and not to the program author)\&.