~ubuntu-branches/ubuntu/natty/luatex/natty

« back to all changes in this revision

Viewing changes to source/libs/xpdf/xpdf-3.02/doc/pdftoppm.1

  • Committer: Package Import Robot
  • Author(s): Norbert Preining
  • Date: 2010-12-13 23:22:59 UTC
  • mfrom: (0.2.1) (1.5.4) (4.3.12 experimental)
  • Revision ID: package-import@ubuntu.com-20101213232259-nqq2mq5z5x6qldw3
Tags: 0.65.0-1
* new upstream release
* ship two source packages as they are distributed by upstream, only
  renamed to match source package requirements. Fix debian/rules
  to install the manual pdf from the right place

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" Copyright 2005-2007 Glyph & Cog, LLC
2
 
.TH pdftoppm 1 "27 February 2007"
3
 
.SH NAME
4
 
pdftoppm \- Portable Document Format (PDF) to Portable Pixmap (PPM)
5
 
converter (version 3.02)
6
 
.SH SYNOPSIS
7
 
.B pdftoppm
8
 
[options]
9
 
.I PDF-file PPM-root
10
 
.SH DESCRIPTION
11
 
.B Pdftoppm
12
 
converts Portable Document Format (PDF) files to color image files in
13
 
Portable Pixmap (PPM) format, grayscale image files in Portable
14
 
Graymap (PGM) format, or monochrome image files in Portable Bitmap
15
 
(PBM) format.
16
 
.PP
17
 
Pdftoppm reads the PDF file,
18
 
.IR PDF-file ,
19
 
and writes one PPM file for each page,
20
 
.IR PPM-root - nnnnnn .ppm,
21
 
where
22
 
.I nnnnnn
23
 
is the page number.
24
 
.SH CONFIGURATION FILE
25
 
Pdftoppm reads a configuration file at startup.  It first tries to
26
 
find the user's private config file, ~/.xpdfrc.  If that doesn't
27
 
exist, it looks for a system-wide config file, typically
28
 
/usr/local/etc/xpdfrc (but this location can be changed when pdftoppm
29
 
is built).  See the
30
 
.BR xpdfrc (5)
31
 
man page for details.
32
 
.SH OPTIONS
33
 
Many of the following options can be set with configuration file
34
 
commands.  These are listed in square brackets with the description of
35
 
the corresponding command line option.
36
 
.TP
37
 
.BI \-f " number"
38
 
Specifies the first page to convert.
39
 
.TP
40
 
.BI \-l " number"
41
 
Specifies the last page to convert.
42
 
.TP
43
 
.BI \-r " number"
44
 
Specifies the resolution, in DPI.  The default is 150 DPI.
45
 
.TP
46
 
.B \-mono
47
 
Generate a monochrome PBM file (instead of a color PPM file).
48
 
.TP
49
 
.B \-gray
50
 
Generate a grayscale PGM file (instead of a color PPM file).
51
 
.TP
52
 
.BI \-t1lib " yes | no"
53
 
Enable or disable t1lib (a Type 1 font rasterizer).  This defaults to
54
 
"yes".
55
 
.RB "[config file: " enableT1lib ]
56
 
.TP
57
 
.BI \-freetype " yes | no"
58
 
Enable or disable FreeType (a TrueType / Type 1 font rasterizer).
59
 
This defaults to "yes".
60
 
.RB "[config file: " enableFreeType ]
61
 
.TP
62
 
.BI \-aa " yes | no"
63
 
Enable or disable font anti-aliasing.  This defaults to "yes".
64
 
.RB "[config file: " antialias ]
65
 
.TP
66
 
.BI \-aaVector " yes | no"
67
 
Enable or disable vector anti-aliasing.  This defaults to "yes".
68
 
.RB "[config file: " vectorAntialias ]
69
 
.TP
70
 
.BI \-opw " password"
71
 
Specify the owner password for the PDF file.  Providing this will
72
 
bypass all security restrictions.
73
 
.TP
74
 
.BI \-upw " password"
75
 
Specify the user password for the PDF file.
76
 
.TP
77
 
.B \-q
78
 
Don't print any messages or errors.
79
 
.RB "[config file: " errQuiet ]
80
 
.TP
81
 
.B \-v
82
 
Print copyright and version information.
83
 
.TP
84
 
.B \-h
85
 
Print usage information.
86
 
.RB ( \-help
87
 
and
88
 
.B \-\-help
89
 
are equivalent.)
90
 
.SH EXIT CODES
91
 
The Xpdf tools use the following exit codes:
92
 
.TP
93
 
0
94
 
No error.
95
 
.TP
96
 
1
97
 
Error opening a PDF file.
98
 
.TP
99
 
2
100
 
Error opening an output file.
101
 
.TP
102
 
3
103
 
Error related to PDF permissions.
104
 
.TP
105
 
99
106
 
Other error.
107
 
.SH AUTHOR
108
 
The pdftoppm software and documentation are copyright 1996-2007 Glyph
109
 
& Cog, LLC.
110
 
.SH "SEE ALSO"
111
 
.BR xpdf (1),
112
 
.BR pdftops (1),
113
 
.BR pdftotext (1),
114
 
.BR pdfinfo (1),
115
 
.BR pdffonts (1),
116
 
.BR pdfimages (1),
117
 
.BR xpdfrc (5)
118
 
.br
119
 
.B http://www.foolabs.com/xpdf/