mingw/share/man/man1/pdftops.1

   1 .\" Copyright 1996-2004 Glyph & Cog, LLC
   2 .TH pdftops 1 "31 July 2009"
   3 .SH NAME
   4 pdftops \- Portable Document Format (PDF) to PostScript converter
   5 (version 3.00)
   6 .SH SYNOPSIS
   7 .B pdftops
   8 [options]
   9 .RI <PDF-file>
  10 .RI [<PS-file>]
  11 .SH DESCRIPTION
  12 .B Pdftops
  13 converts Portable Document Format (PDF) files to PostScript so they
  14 can be printed.
  15 .PP
  16 Pdftops reads the PDF file,
  17 .IR PDF-file ,
  18 and writes a PostScript file,
  19 .IR PS-file .
  20 If
  21 .I PS-file
  22 is not specified, pdftops converts
  23 .I file.pdf
  24 to
  25 .I file.ps
  26 (or
  27 .I file.eps
  28 with the \-eps option).  If
  29 .I PS-file
  30 is \'-', the PostScript is sent to stdout.
  31 .SH OPTIONS
  32 .TP
  33 .BI \-f " number"
  34 Specifies the first page to print.
  35 .TP
  36 .BI \-l " number"
  37 Specifies the last page to print.
  38 .TP
  39 .B \-level1
  40 Generate Level 1 PostScript.  The resulting PostScript files will be
  41 significantly larger (if they contain images), but will print on Level
  42 1 printers.  This also converts all images to black and white.  No
  43 more than one of the PostScript level options (\-level1, \-level1sep,
  44 \-level2, \-level2sep, \-level3, \-level3Sep) may be given.
  45 .TP
  46 .B \-level1sep
  47 Generate Level 1 separable PostScript.  All colors are converted to
  48 CMYK.  Images are written with separate stream data for the four
  49 components.
  50 .TP
  51 .B \-level2
  52 Generate Level 2 PostScript.  Level 2 supports color images and image
  53 compression.  This is the default setting.
  54 .TP
  55 .B \-level2sep
  56 Generate Level 2 separable PostScript.  All colors are converted to
  57 CMYK.  The PostScript separation convention operators are used to
  58 handle custom (spot) colors.
  59 .TP
  60 .B \-level3
  61 Generate Level 3 PostScript.  This enables all Level 2 features plus
  62 CID font embedding.
  63 .TP
  64 .B \-level3Sep
  65 Generate Level 3 separable PostScript.  The separation handling is the
  66 same as for \-level2Sep.
  67 .TP
  68 .B \-origpagesizes
  69 Generate a PostScript file with variable page sizes and orientations,
  70 taking for each page the size of the original page in the PDF file.
  71 The PostScript file contains "<</PageSize [WIDTH HEIGHT]>> setpagedevice"
  72 lines in each page header, so that the paper input tray gets correctly
  73 changed on the printer. This option should be used when pdftops is used
  74 as a print filter. Any specification of the page size via \-paper,
  75 \-paperw, or \-paperh will get overridden as long as each page of the
  76 PDF file has a defined paper size.  No more than one of the mode options
  77 (\-origpagesizes, \-eps, \-form) may be given.
  78 .TP
  79 .B \-eps
  80 Generate an Encapsulated PostScript (EPS) file.  An EPS file contains
  81 a single image, so if you use this option with a multi-page PDF file,
  82 you must use \-f and \-l to specify a single page.  No more than one of
  83 the mode options (\-origpagesizes, \-eps, \-form) may be given.
  84 .TP
  85 .B \-form
  86 Generate a PostScript form which can be imported by software that
  87 understands forms.  A form contains a single page, so if you use this
  88 option with a multi-page PDF file, you must use \-f and \-l to specify a
  89 single page.  The \-level1 option cannot be used with \-form.  No more
  90 than one of the mode options (\-origpagesizes, \-eps, \-form) may be
  91 given.
  92 .TP
  93 .B \-opi
  94 Generate OPI comments for all images and forms which have OPI
  95 information.  (This option is only available if pdftops was compiled
  96 with OPI support.)
  97 .TP
  98 .B \-noembt1
  99 By default, any Type 1 fonts which are embedded in the PDF file are
 100 copied into the PostScript file.  This option causes pdftops to
 101 substitute base fonts instead.  Embedded fonts make PostScript files
 102 larger, but may be necessary for readable output.
 103 .TP
 104 .B \-noembtt
 105 By default, any TrueType fonts which are embedded in the PDF file are
 106 copied into the PostScript file.  This option causes pdftops to
 107 substitute base fonts instead.  Embedded fonts make PostScript files
 108 larger, but may be necessary for readable output.  Also, some
 109 PostScript interpreters do not have TrueType rasterizers.
 110 .TP
 111 .B \-noembcidps
 112 By default, any CID PostScript fonts which are embedded in the PDF
 113 file are copied into the PostScript file.  This option disables that
 114 embedding.  No attempt is made to substitute for non-embedded CID
 115 PostScript fonts.
 116 .TP
 117 .B \-noembcidtt
 118 By default, any CID TrueType fonts which are embedded in the PDF file
 119 are copied into the PostScript file.  This option disables that
 120 embedding.  No attempt is made to substitute for non-embedded CID
 121 TrueType fonts.
 122 .TP
 123 .B \-passfonts
 124 By default, references to non-embedded 8-bit fonts in the PDF file are
 125 substituted with the closest "Helvetica", "Times-Roman", or "Courier" font.
 126 This option passes references to non-embedded fonts
 127 through to the PostScript file.
 128 .TP
 129 .B \-preload
 130 preload images and forms
 131 .TP
 132 .BI \-paper " size"
 133 Set the paper size to one of "letter", "legal", "A4", or "A3".  This
 134 can also be set to "match", which will set the paper size to match the
 135 size specified in the PDF file. \-origpagesizes overrides this setting
 136 if the PDF file has defined page sizes.
 137 .TP
 138 .BI \-paperw " size"
 139 Set the paper width, in points. \-origpagesizes overrides this setting
 140 if the PDF file has defined page sizes.
 141 .TP
 142 .BI \-paperh " size"
 143 Set the paper height, in points. \-origpagesizes overrides this setting
 144 if the PDF file has defined page sizes.
 145 .TP
 146 .B \-nocrop
 147 By default, output is cropped to the CropBox specified in the PDF
 148 file.  This option disables cropping.
 149 .TP
 150 .B \-expand
 151 Expand PDF pages smaller than the paper to fill the paper.  By
 152 default, these pages are not scaled.
 153 .TP
 154 .B \-noshrink
 155 Don't scale PDF pages which are larger than the paper.  By default,
 156 pages larger than the paper are shrunk to fit.
 157 .TP
 158 .B \-nocenter
 159 By default, PDF pages smaller than the paper (after any scaling) are
 160 centered on the paper.  This option causes them to be aligned to the
 161 lower-left corner of the paper instead.
 162 .TP
 163 .B \-duplex
 164 Set the Duplex pagedevice entry in the PostScript file.  This tells
 165 duplex-capable printers to enable duplexing.
 166 .TP
 167 .BI \-opw " password"
 168 Specify the owner password for the PDF file.  Providing this will
 169 bypass all security restrictions.
 170 .TP
 171 .BI \-upw " password"
 172 Specify the user password for the PDF file.
 173 .TP
 174 .B \-q
 175 Don't print any messages or errors.
 176 .TP
 177 .B \-v
 178 Print copyright and version information.
 179 .TP
 180 .B \-h
 181 Print usage information.
 182 .RB ( \-help
 183 and
 184 .B \-\-help
 185 are equivalent.)
 186 .SH EXIT CODES
 187 The Xpdf tools use the following exit codes:
 188 .TP
 189 0
 190 No error.
 191 .TP
 192 1
 193 Error opening a PDF file.
 194 .TP
 195 2
 196 Error opening an output file.
 197 .TP
 198 3
 199 Error related to PDF permissions.
 200 .TP
 201 99
 202 Other error.
 203 .SH AUTHOR
 204 The pdftops software and documentation are copyright 1996-2004 Glyph &
 205 Cog, LLC.
 206 .SH "SEE ALSO"
 207 .BR pdftotext (1),
 208 .BR pdfinfo (1),
 209 .BR pdffonts (1),
 210 .BR pdftoppm (1),
 211 .BR pdfimages (1),