← Back to branch summary

~ubuntu-branches/ubuntu/dapper/poppler/dapper-security

« back to all changes in this revision

Viewing changes to utils/pdftoppm.1

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2006-03-06 18:42:44 UTC
  • mfrom: (1.1.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20060306184244-oomqyiqr7cgncp2c
Tags: 0.5.1-0ubuntu1
* New upstream version:
  - Support for embedded files.
  - Handle 0-width lines correctly.
  - Avoid external file use when opening fonts.
  - Only use vector fonts returned from fontconfig (#5758).
  - Fix scaled 1x1 pixmaps use for drawing lines (#3387).
  - drawSoftMaskedImage support in cairo backend.
  - Misc bug fixes: #5922, #5946, #5749, #5952, #4030, #5420.
* debian/control.in, debian/libpoppler0c2.dirs, 
  debian/libpoppler0c2-glib.dirs, debian/libpoppler0c2-glib.install,
  debian/libpoppler0c2.install, debian/libpoppler0c2-qt.dirs,
  debian/libpoppler0c2-qt.install, debian/rules:
  - updated for the soname change
* debian/patches/000_splash_build_fix.patch:
  - fix build when using splash
* debian/patches/001_fixes_for_fonts_selection.patch:
  - fix with the new version

Show diffs side-by-side

added added

removed removed

Lines of Context:
utils/pdftoppm.1
 
1
.\" Copyright 2004 Glyph & Cog, LLC
 
2
.TH pdftoppm 1 "22 January 2004"
 
3
.SH NAME
 
4
pdftoppm \- Portable Document Format (PDF) to Portable Pixmap (PPM)
 
5
converter (version 3.00)
 
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, /etc/xpdf/xpdfrc. See the
 
28
.BR xpdfrc (5)
 
29
man page for details.
 
30
.SH OPTIONS
 
31
Many of the following options can be set with configuration file
 
32
commands.  These are listed in square brackets with the description of
 
33
the corresponding command line option.
 
34
.TP
 
35
.BI \-f " number"
 
36
Specifies the first page to convert.
 
37
.TP
 
38
.BI \-l " number"
 
39
Specifies the last page to convert.
 
40
.TP
 
41
.BI \-r " number"
 
42
Specifies the resolution, in DPI.  The default is 150 DPI.
 
43
.TP
 
44
.B \-mono
 
45
Generate a monochrome PBM file (instead of a color PPM file).
 
46
.TP
 
47
.B \-gray
 
48
Generate a grayscale PGM file (instead of a color PPM file).
 
49
.TP
 
50
.BI \-t1lib " yes | no"
 
51
Enable or disable t1lib (a Type 1 font rasterizer).  This defaults to
 
52
"yes".
 
53
.RB "[config file: " enableT1lib ]
 
54
.TP
 
55
.BI \-freetype " yes | no"
 
56
Enable or disable FreeType (a TrueType / Type 1 font rasterizer).
 
57
This defaults to "yes".
 
58
.RB "[config file: " enableFreeType ]
 
59
.TP
 
60
.BI \-aa " yes | no"
 
61
Enable or disable font anti-aliasing.  This defaults to "yes".
 
62
.RB "[config file: " antialias ]
 
63
.TP
 
64
.BI \-opw " password"
 
65
Specify the owner password for the PDF file.  Providing this will
 
66
bypass all security restrictions.
 
67
.TP
 
68
.BI \-upw " password"
 
69
Specify the user password for the PDF file.
 
70
.TP
 
71
.B \-q
 
72
Don't print any messages or errors.
 
73
.RB "[config file: " errQuiet ]
 
74
.TP
 
75
.B \-v
 
76
Print copyright and version information.
 
77
.TP
 
78
.B \-h
 
79
Print usage information.
 
80
.RB ( \-help
 
81
and
 
82
.B \-\-help
 
83
are equivalent.)
 
84
.SH EXIT CODES
 
85
The Xpdf tools use the following exit codes:
 
86
.TP
 
87
0
 
88
No error.
 
89
.TP
 
90
1
 
91
Error opening a PDF file.
 
92
.TP
 
93
2
 
94
Error opening an output file.
 
95
.TP
 
96
3
 
97
Error related to PDF permissions.
 
98
.TP
 
99
99
 
100
Other error.
 
101
.SH AUTHOR
 
102
The pdftoppm software and documentation are copyright 1996-2004 Glyph
 
103
& Cog, LLC.
 
104
.SH "SEE ALSO"
 
105
.BR xpdf (1),
 
106
.BR pdftops (1),
 
107
.BR pdftotext (1),
 
108
.BR pdfinfo (1),
 
109
.BR pdffonts (1),
 
110
.BR pdfimages (1),
 
111
.BR xpdfrc (5)
 
112
.br
 
113
.B http://www.foolabs.com/xpdf/