apdf/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.   [config
  74               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        -paper size
 135               Set the paper size to  one  of  "letter",  "legal",
 136               "A4",  or  "A3".   This can also be set to "match",
 137               which will set the paper size  to  match  the  size
 138               specified  in the PDF file.  [config file: psPaper-
 139               Size]
 140
 141        -paperw size
 142               Set the paper  width,  in  points.   [config  file:
 143               psPaperSize]
 144
 145        -paperh size
 146               Set  the  paper  height,  in points.  [config file:
 147               psPaperSize]
 148
 149        -nocrop
 150               By default, output is cropped to the CropBox speci-
 151               fied  in  the PDF file.  This option disables crop-
 152               ping.  [config file: psCrop]
 153
 154        -expand
 155               Expand PDF pages smaller than the paper to fill the
 156               paper.   By  default,  these  pages are not scaled.
 157               [config file: psExpandSmaller]
 158
 159        -noshrink
 160               Don't scale PDF pages which  are  larger  than  the
 161               paper.  By default, pages larger than the paper are
 162               shrunk to fit.  [config file: psShrinkLarger]
 163
 164        -nocenter
 165               By default, PDF pages smaller than the paper (after
 166               any  scaling)  are  centered  on  the  paper.  This
 167               option causes them to be aligned to the  lower-left
 168               corner  of the paper instead.  [config file: psCen-
 169               ter]
 170
 171        -pagecrop
 172               Treat  the  CropBox  as  the  PDF  page  size.   By
 173               default, the MediaBox is used as the page size.
 174
 175        -duplex
 176               Set  the  Duplex pagedevice entry in the PostScript
 177               file.  This tells duplex-capable printers to enable
 178               duplexing.  [config file: psDuplex]
 179
 180        -opw password
 181               Specify  the owner password for the PDF file.  Pro-
 182               viding this will bypass all security  restrictions.
 183
 184        -upw password
 185               Specify the user password for the PDF file.
 186
 187        -q     Don't  print any messages or errors.  [config file:
 188               errQuiet]
 189
 190        -cfg config-file
 191               Read config-file in place of ~/.xpdfrc or the  sys-
 192               tem-wide config file.
 193
 194        -v     Print copyright and version information.
 195
 196        -h     Print  usage  information.   (-help  and --help are
 197               equivalent.)
 198
 199                                                                ()
 200
 201 2 XIT_CODE
 202
 203        The Xpdf tools use the following exit codes:
 204
 205        0      No error.
 206
 207        1      Error opening a PDF file.
 208
 209        2      Error opening an output file.
 210
 211        3      Error related to PDF permissions.
 212
 213        99     Other error.
 214
 215                                                                ()
 216
 217 2 AUTHOR
 218
 219        The  pdftops  software  and  documentation  are  copyright
 220        1996-2005 Glyph & Cog, LLC.
 221
 222                                                                ()
 223
 224 2 SEE_ALSO
 225
 226        xpdf(1),     pdftotext(1),     pdfinfo(1),    pdffonts(1),
 227        pdftoppm(1), pdfimages(1), xpdfrc(5)
 228        http://www.foolabs.com/xpdf/
 229
 230                                                                ()
 231