source: main/trunk/greenstone2/bin/linux/xpdf-tools/doc/pdftops.1@ 32205

Last change on this file since 32205 was 32205, checked in by ak19, 6 years ago

First set of commits to do with implementing the new 'paged_html' output option of PDFPlugin that uses using xpdftools' new pdftohtml. So far tested only on Linux (64 bit), but things work there so I'm optimistically committing the changes since they work. 2. Committing the pre-built Linux binaries of XPDFtools for both 32 and 64 bit built by the XPDF group. 2. To use the correct bitness variant of xpdftools, setup.bash now exports the BITNESS env var, consulted by gsConvert.pl. 3. All the perl code changes to do with using xpdf tools' pdftohtml to generate paged_html and feed it in the desired form into GS(3): gsConvert.pl, PDFPlugin.pm and its parent ConvertBinaryPFile.pm have been modified to make it all work. xpdftools' pdftohtml generates a folder containing an html file and a screenshot for each page in a PDF (as well as an index.html linking to each page's html). However, we want a single html file that contains each individual 'page' html's content in a div, and need to do some further HTML style, attribute and structure modifications to massage the xpdftool output to what we want for GS. In order to parse and manipulate the HTML 'DOM' to do this, we're using the Mojo::DOM package that Dr Bainbridge found and which he's compiled up. Mojo::DOM is therefore also committed in this revision. Some further changes and some display fixes are required, but need to check with the others about that.
File size: 7.5 KB
Line 
1.\" Copyright 1996-2017 Glyph & Cog, LLC
2.TH pdftops 1 "10 Aug 2017"
3.SH NAME
4pdftops \- Portable Document Format (PDF) to PostScript converter
5(version 4.00)
6.SH SYNOPSIS
7.B pdftops
8[options]
9.RI [ PDF-file
10.RI [ PS-file ]]
11.SH DESCRIPTION
12.B Pdftops
13converts Portable Document Format (PDF) files to PostScript so they
14can be printed.
15.PP
16Pdftops reads the PDF file,
17.IR PDF-file ,
18and writes a PostScript file,
19.IR PS-file .
20If
21.I PS-file
22is not specified, pdftops converts
23.I file.pdf
24to
25.I file.ps
26(or
27.I file.eps
28with the \-eps option). If
29.I PS-file
30is \'-', the PostScript is sent to stdout.
31.SH CONFIGURATION FILE
32Pdftops reads a configuration file at startup. It first tries to find
33the user's private config file, ~/.xpdfrc. If that doesn't exist, it
34looks for a system-wide config file, typically /usr/local/etc/xpdfrc
35(but this location can be changed when pdftops is built). See the
36.BR xpdfrc (5)
37man page for details.
38.SH OPTIONS
39Many of the following options can be set with configuration file
40commands. These are listed in square brackets with the description of
41the corresponding command line option.
42.TP
43.BI \-f " number"
44Specifies the first page to print.
45.TP
46.BI \-l " number"
47Specifies the last page to print.
48.TP
49.B \-level1
50Generate Level 1 PostScript. The resulting PostScript files will be
51significantly larger (if they contain images), but will print on Level
521 printers. This also converts all images to black and white. No
53more than one of the PostScript level options (\-level1, \-level1sep,
54\-level2, \-level2sep, \-level3, \-level3Sep) may be given.
55.RB "[config file: " psLevel ]
56.TP
57.B \-level1sep
58Generate Level 1 separable PostScript. All colors are converted to
59CMYK. Images are written with separate stream data for the four
60components.
61.RB "[config file: " psLevel ]
62.TP
63.B \-level2
64Generate Level 2 PostScript. Level 2 supports color images and image
65compression. This is the default setting.
66.RB "[config file: " psLevel ]
67.TP
68.B \-level2gray
69Generate grayscale Level 2 PostScript. All colors, including images,
70are converted to grayscale.
71.RB "[config file: " psLevel ]
72.TP
73.B \-level2sep
74Generate Level 2 separable PostScript. All colors are converted to
75CMYK. The PostScript separation convention operators are used to
76handle custom (spot) colors.
77.RB "[config file: " psLevel ]
78.TP
79.B \-level3
80Generate Level 3 PostScript. This enables all Level 2 features plus
81CID font embedding and masked image generation.
82.RB "[config file: " psLevel ]
83.TP
84.B \-level3gray
85Generate grayscale Level 3 PostScript. All colors, including images,
86are converted to grayscale.
87.RB "[config file: " psLevel ]
88.TP
89.B \-level3Sep
90Generate Level 3 separable PostScript. The separation handling is the
91same as for \-level2Sep.
92.RB "[config file: " psLevel ]
93.TP
94.B \-eps
95Generate an Encapsulated PostScript (EPS) file. An EPS file contains
96a single image, so if you use this option with a multi-page PDF file,
97you must use \-f and \-l to specify a single page. No more than one of
98the mode options (\-eps, \-form) may be given.
99.TP
100.B \-form
101Generate a PostScript form which can be imported by software that
102understands forms. A form contains a single page, so if you use this
103option with a multi-page PDF file, you must use \-f and \-l to specify a
104single page. The \-level1 option cannot be used with \-form.
105.TP
106.B \-opi
107Generate OPI comments for all images and forms which have OPI
108information. (This option is only available if pdftops was compiled
109with OPI support.)
110.RB "[config file: " psOPI ]
111.TP
112.B \-noembt1
113By default, any Type 1 fonts which are embedded in the PDF file are
114copied into the PostScript file. This option causes pdftops to
115substitute base fonts instead. Embedded fonts make PostScript files
116larger, but may be necessary for readable output.
117.RB "[config file: " psEmbedType1Fonts ]
118.TP
119.B \-noembtt
120By default, any TrueType fonts which are embedded in the PDF file are
121copied into the PostScript file. This option causes pdftops to
122substitute base fonts instead. Embedded fonts make PostScript files
123larger, but may be necessary for readable output. Also, some
124PostScript interpreters do not have TrueType rasterizers.
125.RB "[config file: " psEmbedTrueTypeFonts ]
126.TP
127.B \-noembcidps
128By default, any CID PostScript fonts which are embedded in the PDF
129file are copied into the PostScript file. This option disables that
130embedding. No attempt is made to substitute for non-embedded CID
131PostScript fonts.
132.RB "[config file: " psEmbedCIDPostScriptFonts ]
133.TP
134.B \-noembcidtt
135By default, any CID TrueType fonts which are embedded in the PDF file
136are copied into the PostScript file. This option disables that
137embedding. No attempt is made to substitute for non-embedded CID
138TrueType fonts.
139.RB "[config file: " psEmbedCIDTrueTypeFonts ]
140.TP
141.B \-preload
142Convert PDF forms to PS procedures, and preload image data. This uses
143more memory in the PostScript interpreter, but generates significantly
144smaller PS files in situations where, e.g., the same image is drawn on
145every page of a long document.
146.TP
147.BI \-paper " size"
148Set the paper size to one of "letter", "legal", "A4", or "A3". This
149can also be set to "match", which will set the paper size to match the
150size specified in the PDF file.
151.RB "[config file: " psPaperSize ]
152.TP
153.BI \-paperw " size"
154Set the paper width, in points.
155.RB "[config file: " psPaperSize ]
156.TP
157.BI \-paperh " size"
158Set the paper height, in points.
159.RB "[config file: " psPaperSize ]
160.TP
161.B \-nocrop
162By default, output is cropped to the CropBox specified in the PDF
163file. This option disables cropping.
164.RB "[config file: " psCrop ]
165.TP
166.B \-expand
167Expand PDF pages smaller than the paper to fill the paper. By
168default, these pages are not scaled.
169.RB "[config file: " psExpandSmaller ]
170.TP
171.B \-noshrink
172Don't scale PDF pages which are larger than the paper. By default,
173pages larger than the paper are shrunk to fit.
174.RB "[config file: " psShrinkLarger ]
175.TP
176.B \-nocenter
177By default, PDF pages smaller than the paper (after any scaling) are
178centered on the paper. This option causes them to be aligned to the
179lower-left corner of the paper instead.
180.RB "[config file: " psCenter ]
181.TP
182.B \-pagecrop
183Treat the CropBox as the PDF page size. By default, the MediaBox is
184used as the page size.
185.RB "[config file: " psUseCropBoxAsPage ]
186.TP
187.B \-userunit
188Honor the UserUnit settings on PDF pages when computing page/paper
189size. By default, pdftops ignores UserUnit.
190.TP
191.B \-duplex
192Set the Duplex pagedevice entry in the PostScript file. This tells
193duplex-capable printers to enable duplexing.
194.RB "[config file: " psDuplex ]
195.TP
196.BI \-opw " password"
197Specify the owner password for the PDF file. Providing this will
198bypass all security restrictions.
199.TP
200.BI \-upw " password"
201Specify the user password for the PDF file.
202.TP
203.B \-q
204Don't print any messages or errors.
205.RB "[config file: " errQuiet ]
206.TP
207.BI \-cfg " config-file"
208Read
209.I config-file
210in place of ~/.xpdfrc or the system-wide config file.
211.TP
212.B \-v
213Print copyright and version information.
214.TP
215.B \-h
216Print usage information.
217.RB ( \-help
218and
219.B \-\-help
220are equivalent.)
221.SH EXIT CODES
222The Xpdf tools use the following exit codes:
223.TP
2240
225No error.
226.TP
2271
228Error opening a PDF file.
229.TP
2302
231Error opening an output file.
232.TP
2333
234Error related to PDF permissions.
235.TP
23699
237Other error.
238.SH AUTHOR
239The pdftops software and documentation are copyright 1996-2017 Glyph &
240Cog, LLC.
241.SH "SEE ALSO"
242.BR xpdf (1),
243.BR pdftotext (1),
244.BR pdftohtml (1),
245.BR pdfinfo (1),
246.BR pdffonts (1),
247.BR pdfdetach (1),
248.BR pdftoppm (1),
249.BR pdftopng (1),
250.BR pdfimages (1),
251.BR xpdfrc (5)
252.br
253.B http://www.xpdfreader.com/
Note: See TracBrowser for help on using the repository browser.