338 lines
9.5 KiB
HTML
338 lines
9.5 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of pdftops</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>pdftops</H1>
|
|
Section: User Commands (1)<BR>Updated: 15 August 2011<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
pdftops - Portable Document Format (PDF) to PostScript converter
|
|
(version 3.03)
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>pdftops</B>
|
|
|
|
[options]
|
|
<PDF-file>
|
|
|
|
[<PS-file>]
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>Pdftops</B>
|
|
|
|
converts Portable Document Format (PDF) files to PostScript so they
|
|
can be printed.
|
|
<P>
|
|
|
|
Pdftops reads the PDF file,
|
|
<I>PDF-file</I>,
|
|
|
|
and writes a PostScript file,
|
|
<I>PS-file</I>.
|
|
|
|
If
|
|
<I>PS-file</I>
|
|
|
|
is not specified, pdftops converts
|
|
<I>file.pdf</I>
|
|
|
|
to
|
|
<I>file.ps</I>
|
|
|
|
(or
|
|
<I>file.eps</I>
|
|
|
|
with the -eps option). If
|
|
<I>PS-file</I>
|
|
|
|
is '-', the PostScript is sent to stdout.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-f</B><I> number</I>
|
|
|
|
<DD>
|
|
Specifies the first page to print.
|
|
<DT id="2"><B>-l</B><I> number</I>
|
|
|
|
<DD>
|
|
Specifies the last page to print.
|
|
<DT id="3"><B>-level1</B>
|
|
|
|
<DD>
|
|
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.
|
|
<DT id="4"><B>-level1sep</B>
|
|
|
|
<DD>
|
|
Generate Level 1 separable PostScript. All colors are converted to
|
|
CMYK. Images are written with separate stream data for the four
|
|
components.
|
|
<DT id="5"><B>-level2</B>
|
|
|
|
<DD>
|
|
Generate Level 2 PostScript. Level 2 supports color images and image
|
|
compression. This is the default setting.
|
|
<DT id="6"><B>-level2sep</B>
|
|
|
|
<DD>
|
|
Generate Level 2 separable PostScript. All colors are converted to
|
|
CMYK. The PostScript separation convention operators are used to
|
|
handle custom (spot) colors.
|
|
<DT id="7"><B>-level3</B>
|
|
|
|
<DD>
|
|
Generate Level 3 PostScript. This enables all Level 2 features plus
|
|
CID font embedding.
|
|
<DT id="8"><B>-level3sep</B>
|
|
|
|
<DD>
|
|
Generate Level 3 separable PostScript. The separation handling is the
|
|
same as for -level2sep.
|
|
<DT id="9"><B>-eps</B>
|
|
|
|
<DD>
|
|
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.
|
|
<DT id="10"><B>-form</B>
|
|
|
|
<DD>
|
|
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. No more
|
|
than one of the mode options (-eps, -form) may be
|
|
given.
|
|
<DT id="11"><B>-opi</B>
|
|
|
|
<DD>
|
|
Generate OPI comments for all images and forms which have OPI
|
|
information. (This option is only available if pdftops was compiled
|
|
with OPI support.)
|
|
<DT id="12"><B>-binary</B>
|
|
|
|
<DD>
|
|
Write binary data in Level 1 PostScript. By default, pdftops writes
|
|
hex-encoded data in Level 1 PostScript. Binary data is non-standard
|
|
in Level 1 PostScript but reduces the file size and can be useful
|
|
when Level 1 PostScript is required only for its restricted use
|
|
of PostScript operators.
|
|
<DT id="13"><B>-r</B><I> number</I>
|
|
|
|
<DD>
|
|
Set the resolution in DPI when pdftops rasterizes images with
|
|
transparencies or, for Level 1 PostScript, when pdftops
|
|
rasterizes images with color masks.
|
|
By default, pdftops rasterizes images to 300 DPI.
|
|
<DT id="14"><B>-noembt1</B>
|
|
|
|
<DD>
|
|
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.
|
|
<DT id="15"><B>-noembtt</B>
|
|
|
|
<DD>
|
|
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.
|
|
<DT id="16"><B>-noembcidps</B>
|
|
|
|
<DD>
|
|
By default, any CID PostScript fonts which are embedded 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
|
|
PostScript fonts.
|
|
<DT id="17"><B>-noembcidtt</B>
|
|
|
|
<DD>
|
|
By default, any CID TrueType fonts which are embedded 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.
|
|
<DT id="18"><B>-passfonts</B>
|
|
|
|
<DD>
|
|
By default, references to non-embedded 8-bit fonts in the PDF file are
|
|
substituted with the closest "Helvetica", "Times-Roman", or "Courier" font.
|
|
This option passes references to non-embedded fonts
|
|
through to the PostScript file.
|
|
<DT id="19"><B>-aaRaster</B><I> yes | no</I>
|
|
|
|
<DD>
|
|
Enable or disable raster anti-aliasing. This defaults to "no".
|
|
pdftops may need to rasterize transparencies and pattern image masks in the PDF.
|
|
If the PostScript will be printed, leave -aaRaster disabled and set -r to the resolution of the printer.
|
|
If the PostScript will be viewed, enabling -aaRaster may make rasterized text easier to read.
|
|
<DT id="20"><B>-optimizecolorspace</B>
|
|
|
|
<DD>
|
|
By default, bitmap images in the PDF pass through to the output PostScript
|
|
in their original color space, which produces predictable results.
|
|
This option converts RGB and CMYK images into Gray images
|
|
if every pixel of the image has equal components.
|
|
This can fix problems when doing color separations of PDFs
|
|
that contain embedded black and white images encoded as RGB.
|
|
<DT id="21"><B>-preload</B>
|
|
|
|
<DD>
|
|
preload images and forms
|
|
<DT id="22"><B>-paper</B><I> size</I>
|
|
|
|
<DD>
|
|
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 of each page to match the
|
|
size specified in the PDF file. If none the -paper, -paperw, or -paperh
|
|
options are specified the default is to match the paper size.
|
|
<DT id="23"><B>-paperw</B><I> size</I>
|
|
|
|
<DD>
|
|
Set the paper width, in points.
|
|
<DT id="24"><B>-paperh</B><I> size</I>
|
|
|
|
<DD>
|
|
Set the paper height, in points.
|
|
<DT id="25"><B>-origpagesizes</B>
|
|
|
|
<DD>
|
|
This option is the same as "-paper match".
|
|
<DT id="26"><B>-nocrop</B>
|
|
|
|
<DD>
|
|
By default, output is cropped to the CropBox specified in the PDF
|
|
file. This option disables cropping.
|
|
<DT id="27"><B>-expand</B>
|
|
|
|
<DD>
|
|
Expand PDF pages smaller than the paper to fill the paper. By
|
|
default, these pages are not scaled.
|
|
<DT id="28"><B>-noshrink</B>
|
|
|
|
<DD>
|
|
Don't scale PDF pages which are larger than the paper. By default,
|
|
pages larger than the paper are shrunk to fit.
|
|
<DT id="29"><B>-nocenter</B>
|
|
|
|
<DD>
|
|
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.
|
|
<DT id="30"><B>-duplex</B>
|
|
|
|
<DD>
|
|
Set the Duplex pagedevice entry in the PostScript file. This tells
|
|
duplex-capable printers to enable duplexing.
|
|
<DT id="31"><B>-opw</B><I> password</I>
|
|
|
|
<DD>
|
|
Specify the owner password for the PDF file. Providing this will
|
|
bypass all security restrictions.
|
|
<DT id="32"><B>-upw</B><I> password</I>
|
|
|
|
<DD>
|
|
Specify the user password for the PDF file.
|
|
<DT id="33"><B>-overprint</B>
|
|
|
|
<DD>
|
|
Enable overprinting.
|
|
<DT id="34"><B>-q</B>
|
|
|
|
<DD>
|
|
Don't print any messages or errors.
|
|
<DT id="35"><B>-v</B>
|
|
|
|
<DD>
|
|
Print copyright and version information.
|
|
<DT id="36"><B>-h</B>
|
|
|
|
<DD>
|
|
Print usage information.
|
|
(<B>-help</B>
|
|
|
|
and
|
|
<B>--help</B>
|
|
|
|
are equivalent.)
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>EXIT CODES</H2>
|
|
|
|
The Xpdf tools use the following exit codes:
|
|
<DL COMPACT>
|
|
<DT id="37">0<DD>
|
|
No error.
|
|
<DT id="38">1<DD>
|
|
Error opening a PDF file.
|
|
<DT id="39">2<DD>
|
|
Error opening an output file.
|
|
<DT id="40">3<DD>
|
|
Error related to PDF permissions.
|
|
<DT id="41">99<DD>
|
|
Other error.
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
The pdftops software and documentation are copyright 1996-2011 Glyph &
|
|
Cog, LLC.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pdfdetach">pdfdetach</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pdffonts">pdffonts</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pdfimages">pdfimages</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pdfinfo">pdfinfo</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pdftocairo">pdftocairo</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pdftohtml">pdftohtml</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pdftoppm">pdftoppm</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pdftotext">pdftotext</A></B>(1)
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pdfseparate">pdfseparate</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pdfsig">pdfsig</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pdfunite">pdfunite</A></B>(1)
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="42"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="43"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="44"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="45"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="46"><A HREF="#lbAF">EXIT CODES</A><DD>
|
|
<DT id="47"><A HREF="#lbAG">AUTHOR</A><DD>
|
|
<DT id="48"><A HREF="#lbAH">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:22 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|