310 lines
8.1 KiB
HTML
310 lines
8.1 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of pdftoppm</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>pdftoppm</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>
|
|
|
|
pdftoppm - Portable Document Format (PDF) to Portable Pixmap (PPM)
|
|
converter (version 3.03)
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>pdftoppm</B>
|
|
|
|
[options]
|
|
<I>PDF-file PPM-root</I>
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>Pdftoppm</B>
|
|
|
|
converts Portable Document Format (PDF) files to color image files in
|
|
Portable Pixmap (PPM) format, grayscale image files in Portable
|
|
Graymap (PGM) format, or monochrome image files in Portable Bitmap
|
|
(PBM) format.
|
|
<P>
|
|
|
|
Pdftoppm reads the PDF file,
|
|
<I>PDF-file</I>,
|
|
|
|
and writes one PPM file for each page,
|
|
<I>PPM-root</I>-<I>number</I>.ppm,
|
|
|
|
where
|
|
<I>number</I>
|
|
|
|
is the page number.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-f</B><I> number</I>
|
|
|
|
<DD>
|
|
Specifies the first page to convert.
|
|
<DT id="2"><B>-l</B><I> number</I>
|
|
|
|
<DD>
|
|
Specifies the last page to convert.
|
|
<DT id="3"><B>-o</B>
|
|
|
|
<DD>
|
|
Generates only the odd numbered pages.
|
|
<DT id="4"><B>-e</B>
|
|
|
|
<DD>
|
|
Generates only the even numbered pages.
|
|
<DT id="5"><B>-singlefile</B>
|
|
|
|
<DD>
|
|
Writes only the first page and does not add digits.
|
|
<DT id="6"><B>-r</B><I> number</I>
|
|
|
|
<DD>
|
|
Specifies the X and Y resolution, in DPI. The default is 150 DPI.
|
|
<DT id="7"><B>-rx</B><I> number</I>
|
|
|
|
<DD>
|
|
Specifies the X resolution, in DPI. The default is 150 DPI.
|
|
<DT id="8"><B>-ry</B><I> number</I>
|
|
|
|
<DD>
|
|
Specifies the Y resolution, in DPI. The default is 150 DPI.
|
|
<DT id="9"><B>-scale-to</B><I> number</I>
|
|
|
|
<DD>
|
|
Scales the long side of each page (width for landscape pages, height
|
|
for portrait pages) to fit in scale-to pixels. The size of the short
|
|
side will be determined by the aspect ratio of the page.
|
|
<DT id="10"><B>-scale-to-x</B><I> number</I>
|
|
|
|
<DD>
|
|
Scales each page horizontally to fit in scale-to-x pixels. If
|
|
scale-to-y is set to -1, the vertical size will determined by the
|
|
aspect ratio of the page.
|
|
<DT id="11"><B>-scale-to-y</B><I> number</I>
|
|
|
|
<DD>
|
|
Scales each page vertically to fit in scale-to-y pixels. If scale-to-x
|
|
is set to -1, the horizontal size will determined by the aspect ratio
|
|
of the page.
|
|
<DT id="12"><B>-scale-dimension-before-rotation</B>
|
|
|
|
<DD>
|
|
Swaps horizontal and vertical size for a rotated (landscape) pdf before scaling instead of after.
|
|
<DT id="13"><B>-x</B><I> number</I>
|
|
|
|
<DD>
|
|
Specifies the x-coordinate of the crop area top left corner
|
|
<DT id="14"><B>-y</B><I> number</I>
|
|
|
|
<DD>
|
|
Specifies the y-coordinate of the crop area top left corner
|
|
<DT id="15"><B>-W</B><I> number</I>
|
|
|
|
<DD>
|
|
Specifies the width of crop area in pixels (default is 0)
|
|
<DT id="16"><B>-H</B><I> number</I>
|
|
|
|
<DD>
|
|
Specifies the height of crop area in pixels (default is 0)
|
|
<DT id="17"><B>-sz</B><I> number</I>
|
|
|
|
<DD>
|
|
Specifies the size of crop square in pixels (sets W and H)
|
|
<DT id="18"><B>-cropbox</B>
|
|
|
|
<DD>
|
|
Uses the crop box rather than media box when generating the files
|
|
<DT id="19"><B>-hide-annotations</B>
|
|
|
|
<DD>
|
|
Do not show annotations
|
|
<DT id="20"><B>-mono</B>
|
|
|
|
<DD>
|
|
Generate a monochrome PBM file (instead of a color PPM file).
|
|
<DT id="21"><B>-gray</B>
|
|
|
|
<DD>
|
|
Generate a grayscale PGM file (instead of a color PPM file).
|
|
<DT id="22"><B>-png</B>
|
|
|
|
<DD>
|
|
Generates a PNG file instead a PPM file.
|
|
<DT id="23"><B>-jpeg</B>
|
|
|
|
<DD>
|
|
Generates a JPEG file instead a PPM file.
|
|
<DT id="24"><B>-jpegopt</B><I> jpeg-options</I>
|
|
|
|
<DD>
|
|
When used with -jpeg, takes a list of options to control the jpeg compression. See
|
|
<B>JPEG OPTIONS</B>
|
|
|
|
for the available options.
|
|
<DT id="25"><B>-tiff</B>
|
|
|
|
<DD>
|
|
Generates a TIFF file instead a PPM file.
|
|
<DT id="26"><B>-tiffcompression</B><I> none | packbits | jpeg | lzw | deflate</I>
|
|
|
|
<DD>
|
|
Specifies the TIFF compression type. This defaults to "none".
|
|
<DT id="27"><B>-freetype</B><I> yes | no</I>
|
|
|
|
<DD>
|
|
Enable or disable FreeType (a TrueType / Type 1 font rasterizer).
|
|
This defaults to "yes".
|
|
<DT id="28"><B>-thinlinemode</B><I> none | solid | shape</I>
|
|
|
|
<DD>
|
|
Specifies the thin line mode. This defaults to "none".
|
|
<DT id="29">"solid": <DD>
|
|
adjust lines with a width less than one pixel to pixel boundary
|
|
and paint it with a width of one pixel.
|
|
<DT id="30">"shape": <DD>
|
|
adjust lines with a width less than one pixel to pixel boundary
|
|
and paint it with a width of one pixel but with a shape in proportion
|
|
to its width.
|
|
<DT id="31"><B>-aa</B><I> yes | no</I>
|
|
|
|
<DD>
|
|
Enable or disable font anti-aliasing. This defaults to "yes".
|
|
<DT id="32"><B>-aaVector</B><I> yes | no</I>
|
|
|
|
<DD>
|
|
Enable or disable vector anti-aliasing. This defaults to "yes".
|
|
<DT id="33"><B>-opw</B><I> password</I>
|
|
|
|
<DD>
|
|
Specify the owner password for the PDF file. Providing this will
|
|
bypass all security restrictions.
|
|
<DT id="34"><B>-upw</B><I> password</I>
|
|
|
|
<DD>
|
|
Specify the user password for the PDF file.
|
|
<DT id="35"><B>-q</B>
|
|
|
|
<DD>
|
|
Don't print any messages or errors.
|
|
<DT id="36"><B>-sep</B><I> char</I>
|
|
|
|
<DD>
|
|
Specify single character separator between name and page number, default - .
|
|
<DT id="37"><B>-forcenum</B>
|
|
|
|
<DD>
|
|
Force page number even if there is only one page.
|
|
<DT id="38"><B>-v</B>
|
|
|
|
<DD>
|
|
Print copyright and version information.
|
|
<DT id="39"><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="40">0<DD>
|
|
No error.
|
|
<DT id="41">1<DD>
|
|
Error opening a PDF file.
|
|
<DT id="42">2<DD>
|
|
Error opening an output file.
|
|
<DT id="43">3<DD>
|
|
Error related to PDF permissions.
|
|
<DT id="44">99<DD>
|
|
Other error.
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>JPEG OPTIONS</H2>
|
|
|
|
When JPEG output is specified, the -jpegopt option can be used to control the JPEG compression parameters.
|
|
It takes a string of the form "<opt>=<val>[,<opt>=<val>]". Currently the available options are:
|
|
<DL COMPACT>
|
|
<DT id="45"><B>quality</B>
|
|
|
|
<DD>
|
|
Selects the JPEG quality value. The value must be an integer between 0 and 100.
|
|
<DT id="46"><B>progressive</B>
|
|
|
|
<DD>
|
|
Select progressive JPEG output. The possible values are "y", "n",
|
|
indicating progressive (yes) or non-progressive (no), respectively.
|
|
<DT id="47"><B>optimize</B>
|
|
|
|
<DD>
|
|
Sets whether to compute optimal Huffman coding tables for the JPEG output, which
|
|
will create smaller files but make an extra pass over the data. The value must
|
|
be "y" or "n", with "y" performing optimization, otherwise the default Huffman
|
|
tables are used.
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
The pdftoppm software and documentation are copyright 1996-2011 Glyph
|
|
& Cog, LLC.
|
|
<A NAME="lbAI"> </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+pdftops">pdftops</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="48"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="49"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="50"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="51"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="52"><A HREF="#lbAF">EXIT CODES</A><DD>
|
|
<DT id="53"><A HREF="#lbAG">JPEG OPTIONS</A><DD>
|
|
<DT id="54"><A HREF="#lbAH">AUTHOR</A><DD>
|
|
<DT id="55"><A HREF="#lbAI">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>
|