summaryrefslogtreecommitdiff
path: root/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.cat
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.cat')
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.cat229
1 files changed, 229 insertions, 0 deletions
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.cat b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.cat
new file mode 100644
index 00000000000..b370774d0fe
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.cat
@@ -0,0 +1,229 @@
+pdftops(1) pdftops(1)
+
+
+
+NAME
+ pdftops - Portable Document Format (PDF) to PostScript
+ converter (version 3.02)
+
+SYNOPSIS
+ pdftops [options] [PDF-file [PS-file]]
+
+DESCRIPTION
+ Pdftops converts Portable Document Format (PDF) files to
+ PostScript so they can be printed.
+
+ Pdftops reads the PDF file, PDF-file, and writes a
+ PostScript file, PS-file. If PS-file is not specified,
+ pdftops converts file.pdf to file.ps (or file.eps with the
+ -eps option). If PS-file is '-', the PostScript is sent
+ to stdout.
+
+CONFIGURATION FILE
+ Pdftops reads a configuration file at startup. It first
+ tries to find the user's private config file, ~/.xpdfrc.
+ If that doesn't exist, it looks for a system-wide config
+ file, typically /usr/local/etc/xpdfrc (but this location
+ can be changed when pdftops is built). See the xpdfrc(5)
+ man page for details.
+
+OPTIONS
+ Many of the following options can be set with configura-
+ tion file commands. These are listed in square brackets
+ with the description of the corresponding command line
+ option.
+
+ -f number
+ Specifies the first page to print.
+
+ -l number
+ Specifies the last page to print.
+
+ -level1
+ Generate Level 1 PostScript. The resulting
+ PostScript files will be significantly larger (if
+ they contain images), but will print on Level 1
+ printers. This also converts all images to black
+ and white. No more than one of the PostScript
+ level options (-level1, -level1sep, -level2,
+ -level2sep, -level3, -level3Sep) may be given.
+ [config file: psLevel]
+
+ -level1sep
+ Generate Level 1 separable PostScript. All colors
+ are converted to CMYK. Images are written with
+ separate stream data for the four components.
+ [config file: psLevel]
+
+ -level2
+ Generate Level 2 PostScript. Level 2 supports
+ color images and image compression. This is the
+ default setting. [config file: psLevel]
+
+ -level2sep
+ Generate Level 2 separable PostScript. All colors
+ are converted to CMYK. The PostScript separation
+ convention operators are used to handle custom
+ (spot) colors. [config file: psLevel]
+
+ -level3
+ Generate Level 3 PostScript. This enables all
+ Level 2 features plus CID font embedding and masked
+ image generation. [config file: psLevel]
+
+ -level3Sep
+ Generate Level 3 separable PostScript. The separa-
+ tion handling is the same as for -level2Sep. [con-
+ fig file: psLevel]
+
+ -eps Generate an Encapsulated PostScript (EPS) file. An
+ EPS file contains a single image, so if you use
+ this option with a multi-page PDF file, you must
+ use -f and -l to specify a single page. No more
+ than one of the mode options (-eps, -form) may be
+ given.
+
+ -form Generate a PostScript form which can be imported by
+ software that understands forms. A form contains a
+ single page, so if you use this option with a
+ multi-page PDF file, you must use -f and -l to
+ specify a single page. The -level1 option cannot
+ be used with -form.
+
+ -opi Generate OPI comments for all images and forms
+ which have OPI information. (This option is only
+ available if pdftops was compiled with OPI sup-
+ port.) [config file: psOPI]
+
+ -noembt1
+ By default, any Type 1 fonts which are embedded in
+ the PDF file are copied into the PostScript file.
+ This option causes pdftops to substitute base fonts
+ instead. Embedded fonts make PostScript files
+ larger, but may be necessary for readable output.
+ [config file: psEmbedType1Fonts]
+
+ -noembtt
+ By default, any TrueType fonts which are embedded
+ in the PDF file are copied into the PostScript
+ file. This option causes pdftops to substitute
+ base fonts instead. Embedded fonts make PostScript
+ files larger, but may be necessary for readable
+ output. Also, some PostScript interpreters do not
+ have TrueType rasterizers. [config file: psEm-
+ bedTrueTypeFonts]
+
+ -noembcidps
+ By default, any CID PostScript fonts which are
+ embedded in the PDF file are copied into the
+ PostScript file. This option disables that embed-
+ ding. No attempt is made to substitute for non-
+ embedded CID PostScript fonts. [config file: psEm-
+ bedCIDPostScriptFonts]
+
+ -noembcidtt
+ By default, any CID TrueType fonts which are embed-
+ ded in the PDF file are copied into the PostScript
+ file. This option disables that embedding. No
+ attempt is made to substitute for non-embedded CID
+ TrueType fonts. [config file: psEmbedCIDTrueType-
+ Fonts]
+
+ -preload
+ Convert PDF forms to PS procedures, and preload
+ image data. This uses more memory in the
+ PostScript interpreter, but generates significantly
+ smaller PS files in situations where, e.g., the
+ same image is drawn on every page of a long docu-
+ ment.
+
+ -paper size
+ Set the paper size to one of "letter", "legal",
+ "A4", or "A3". This can also be set to "match",
+ which will set the paper size to match the size
+ specified in the PDF file. [config file: psPaper-
+ Size]
+
+ -paperw size
+ Set the paper width, in points. [config file:
+ psPaperSize]
+
+ -paperh size
+ Set the paper height, in points. [config file:
+ psPaperSize]
+
+ -nocrop
+ By default, output is cropped to the CropBox speci-
+ fied in the PDF file. This option disables crop-
+ ping. [config file: psCrop]
+
+ -expand
+ Expand PDF pages smaller than the paper to fill the
+ paper. By default, these pages are not scaled.
+ [config file: psExpandSmaller]
+
+ -noshrink
+ Don't scale PDF pages which are larger than the
+ paper. By default, pages larger than the paper are
+ shrunk to fit. [config file: psShrinkLarger]
+
+ -nocenter
+ By default, PDF pages smaller than the paper (after
+ any scaling) are centered on the paper. This
+ option causes them to be aligned to the lower-left
+ corner of the paper instead. [config file: psCen-
+ ter]
+
+ -pagecrop
+ Treat the CropBox as the PDF page size. By
+ default, the MediaBox is used as the page size.
+
+ -duplex
+ Set the Duplex pagedevice entry in the PostScript
+ file. This tells duplex-capable printers to enable
+ duplexing. [config file: psDuplex]
+
+ -opw password
+ Specify the owner password for the PDF file. Pro-
+ viding this will bypass all security restrictions.
+
+ -upw password
+ Specify the user password for the PDF file.
+
+ -q Don't print any messages or errors. [config file:
+ errQuiet]
+
+ -cfg config-file
+ Read config-file in place of ~/.xpdfrc or the sys-
+ tem-wide config file.
+
+ -v Print copyright and version information.
+
+ -h Print usage information. (-help and --help are
+ equivalent.)
+
+EXIT CODES
+ The Xpdf tools use the following exit codes:
+
+ 0 No error.
+
+ 1 Error opening a PDF file.
+
+ 2 Error opening an output file.
+
+ 3 Error related to PDF permissions.
+
+ 99 Other error.
+
+AUTHOR
+ The pdftops software and documentation are copyright
+ 1996-2007 Glyph & Cog, LLC.
+
+SEE ALSO
+ xpdf(1), pdftotext(1), pdfinfo(1), pdffonts(1),
+ pdftoppm(1), pdfimages(1), xpdfrc(5)
+ http://www.foolabs.com/xpdf/
+
+
+
+ 27 February 2007 pdftops(1)