arospdf/doc/pdftops.hlp

   1 ! Generated automatically by mantohlp
   2 1 pdftops
   3
   4        pdftops  -  Portable  Document  Format (PDF) to PostScript
   5        converter
   6
   7        pdftops [options] [PDF-file [PS-file]]
   8
   9        Pdftops converts Portable Document Format (PDF)  files  to
  10        PostScript so they can be printed.
  11
  12        Pdftops  reads  the  PDF  file,  PDF-file,  and  writes  a
  13        PostScript file, PS-file.  If PS-file  is  not  specified,
  14        pdftops converts file.pdf to file.ps (or file.eps with the
  15        -eps option).  If PS-file is '-', the PostScript  is  sent
  16        to stdout.
  17
  18                                                                ()
  19
  20 2 ONFIGURATION_FIL
  21
  22        Pdftops  reads  a configuration file at startup.  It first
  23        tries to find the user's private config  file,  ~/.xpdfrc.
  24        If  that  doesn't exist, it looks for a system-wide config
  25        file, typically /usr/local/etc/xpdfrc (but  this  location
  26        can  be changed when pdftops is built).  See the xpdfrc(5)
  27        man page for details.
  28
  29                                                                ()
  30
  31 2 OPTIONS
  32
  33        Many  of  the following options can be set with configura-
  34        tion file commands.  These are listed in  square  brackets
  35        with  the  description  of  the corresponding command line
  36        option.
  37
  38        -f number
  39               Specifies the first page to print.
  40
  41        -l number
  42               Specifies the last page to print.
  43
  44        -level1
  45               Generate  Level  1   PostScript.    The   resulting
  46               PostScript  files  will be significantly larger (if
  47               they contain images), but will  print  on  Level  1
  48               printers.   This  also converts all images to black
  49               and white.  No more  than  one  of  the  PostScript
  50               level   options   (-level1,   -level1sep,  -level2,
  51               -level2sep,  -level3,  -level3Sep)  may  be  given.
  52               [config file: psLevel]
  53
  54        -level1sep
  55               Generate  Level 1 separable PostScript.  All colors
  56               are converted to CMYK.   Images  are  written  with
  57               separate  stream  data  for  the  four  components.
  58               [config file: psLevel]
  59
  60        -level2
  61               Generate Level  2  PostScript.   Level  2  supports
  62               color  images  and  image compression.  This is the
  63               default setting.  [config file: psLevel]
  64
  65        -level2sep
  66               Generate Level 2 separable PostScript.  All  colors
  67               are  converted  to CMYK.  The PostScript separation
  68               convention operators  are  used  to  handle  custom
  69               (spot) colors.  [config file: psLevel]
  70
  71        -level3
  72               Generate  Level  3  PostScript.   This  enables all
  73               Level 2 features plus CID font embedding and masked
  74               image generation.  [config file: psLevel]
  75
  76        -level3Sep
  77               Generate Level 3 separable PostScript.  The separa-
  78               tion handling is the same as for -level2Sep.  [con-
  79               fig file: psLevel]
  80
  81        -eps   Generate an Encapsulated PostScript (EPS) file.  An
  82               EPS file contains a single image,  so  if  you  use
  83               this  option  with  a multi-page PDF file, you must
  84               use -f and -l to specify a single  page.   No  more
  85               than  one  of the mode options (-eps, -form) may be
  86               given.
  87
  88        -form  Generate a PostScript form which can be imported by
  89               software that understands forms.  A form contains a
  90               single page, so if  you  use  this  option  with  a
  91               multi-page  PDF  file,  you  must  use -f and -l to
  92               specify a single page.  The -level1  option  cannot
  93               be used with -form.
  94
  95        -opi   Generate  OPI  comments  for  all  images and forms
  96               which have OPI information.  (This option  is  only
  97               available  if  pdftops  was  compiled with OPI sup-
  98               port.)  [config file: psOPI]
  99
 100        -noembt1
 101               By default, any Type 1 fonts which are embedded  in
 102               the  PDF  file are copied into the PostScript file.
 103               This option causes pdftops to substitute base fonts
 104               instead.   Embedded  fonts  make  PostScript  files
 105               larger, but may be necessary for  readable  output.
 106               [config file: psEmbedType1Fonts]
 107
 108        -noembtt
 109               By  default,  any TrueType fonts which are embedded
 110               in the PDF file  are  copied  into  the  PostScript
 111               file.   This  option  causes  pdftops to substitute
 112               base fonts instead.  Embedded fonts make PostScript
 113               files  larger,  but  may  be necessary for readable
 114               output.  Also, some PostScript interpreters do  not
 115               have  TrueType  rasterizers.   [config  file: psEm-
 116               bedTrueTypeFonts]
 117
 118        -noembcidps
 119               By default, any  CID  PostScript  fonts  which  are
 120               embedded  in  the  PDF  file  are  copied  into the
 121               PostScript file.  This option disables that  embed-
 122               ding.   No  attempt  is made to substitute for non-
 123               embedded CID PostScript fonts.  [config file: psEm-
 124               bedCIDPostScriptFonts]
 125
 126        -noembcidtt
 127               By default, any CID TrueType fonts which are embed-
 128               ded in the PDF file are copied into the  PostScript
 129               file.   This  option  disables  that embedding.  No
 130               attempt is made to substitute for non-embedded  CID
 131               TrueType  fonts.  [config file: psEmbedCIDTrueType-
 132               Fonts]
 133
 134        -preload
 135               Convert PDF forms to  PS  procedures,  and  preload
 136               image   data.    This   uses  more  memory  in  the
 137               PostScript interpreter, but generates significantly
 138               smaller  PS  files  in  situations where, e.g., the
 139               same image is drawn on every page of a  long  docu-
 140               ment.
 141
 142        -paper size
 143               Set  the  paper  size  to one of "letter", "legal",
 144               "A4", or "A3".  This can also be  set  to  "match",
 145               which  will  set  the  paper size to match the size
 146               specified in the PDF file.  [config file:  psPaper-
 147               Size]
 148
 149        -paperw size
 150               Set  the  paper  width,  in  points.  [config file:
 151               psPaperSize]
 152
 153        -paperh size
 154               Set the paper height,  in  points.   [config  file:
 155               psPaperSize]
 156
 157        -nocrop
 158               By default, output is cropped to the CropBox speci-
 159               fied  in  the  PDF  file.   This  option   disables
 160               cropping.  [config file: psCrop]
 161
 162        -expand
 163               Expand PDF pages smaller than the paper to fill the
 164               paper.  By default, these  pages  are  not  scaled.
 165               [config file: psExpandSmaller]
 166
 167        -noshrink
 168               Don't  scale  PDF  pages  which are larger than the
 169               paper.  By default, pages larger than the paper are
 170               shrunk to fit.  [config file: psShrinkLarger]
 171
 172        -nocenter
 173               By default, PDF pages smaller than the paper (after
 174               any scaling)  are  centered  on  the  paper.   This
 175               option  causes them to be aligned to the lower-left
 176               corner of the paper instead.  [config file:  psCen-
 177               ter]
 178
 179        -pagecrop
 180               Treat  the  CropBox  as  the  PDF  page  size.   By
 181               default, the MediaBox is used as the page size.
 182
 183        -duplex
 184               Set the Duplex pagedevice entry in  the  PostScript
 185               file.  This tells duplex-capable printers to enable
 186               duplexing.  [config file: psDuplex]
 187
 188        -opw password
 189               Specify the owner password for the PDF file.   Pro-
 190               viding  this will bypass all security restrictions.
 191
 192        -upw password
 193               Specify the user password for the PDF file.
 194
 195        -q     Don't print any messages or errors.  [config  file:
 196               errQuiet]
 197
 198        -cfg config-file
 199               Read  config-file in place of ~/.xpdfrc or the sys-
 200               tem-wide config file.
 201
 202        -v     Print copyright and version information.
 203
 204        -h     Print usage information.   (-help  and  --help  are
 205               equivalent.)
 206
 207                                                                ()
 208
 209 2 XIT_CODE
 210
 211        The Xpdf tools use the following exit codes:
 212
 213        0      No error.
 214
 215        1      Error opening a PDF file.
 216
 217        2      Error opening an output file.
 218
 219        3      Error related to PDF permissions.
 220
 221        99     Other error.
 222
 223                                                                ()
 224
 225 2 AUTHOR
 226
 227        The  pdftops  software  and  documentation  are  copyright
 228        1996-2007 Glyph & Cog, LLC.
 229
 230                                                                ()
 231
 232 2 SEE_ALSO
 233
 234        xpdf(1),     pdftotext(1),     pdfinfo(1),    pdffonts(1),
 235        pdftoppm(1), pdfimages(1), xpdfrc(5)
 236        http://www.foolabs.com/xpdf/
 237
 238                                                                ()
 239