home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-1.iso / CDROM / READMEs / Peanuts-2 / Unix / text / pdf2ps.README < prev    next >
Encoding:
Text File  |  1996-11-09  |  4.0 KB  |  91 lines
  1.  
  2. This is the README file for pdf2ps.pl, a perl script to convert Adobe
  3. Acrobat "PDF" files to PostScript (Level2 only !), PDF-1.0 and PDF-1.1.
  4. Current version is 2.18a. (Now binary proof !)
  5.  
  6. Usage:
  7.     pdf2ps.pl [-abxhtv3] document[.pdf]
  8.  
  9. Besides some diagnostic messages (and possibly warnings
  10. about all the stuff it doesn't know to handle) this will
  11. produce a file "document.ps" in the same directory as
  12. the input file, and possibly a file "document.thumb.ps"
  13. if thumbnails are present in the file (unless supressed with -t).
  14.  
  15. That's roughly all to say about it. It might produce a
  16. really large prolog, where all images are contained. This
  17. could raise problems on printers with small memory. Some
  18. day I'll put such stuff into the PageProlog instead of
  19. the document prolog, this might help a little.
  20.  
  21. Missing features:
  22.     - support for TrueType (Type42) fonts
  23.     - substitution of fonts not included in the file by MM fonts
  24.     - handling of crop rectangles
  25.     - handling of rotated pages
  26.     - handling of new PDF-1.1 calibrated color spaces
  27.     - output of text in annotations into e.g. "document.annot.ps"
  28.     - ... (don't mind to give me some ideas)
  29.  
  30. Should run with perl 4.036 as well as with perl5.00x. (I hope - I use 5.000)
  31.  
  32. Options:
  33.   -a    produce ASCII85 encoded data (default, SLOW, smallest pure 7-Bit files)
  34.   -x    produce HEX encoded data     (fast, rather large pure 7-Bit files)
  35.   -b    produce possibly binary data (fastest, might mess up data transfer)
  36.  
  37.   -h    print this message and exit
  38.   -t    don't generate seperate PS file with thumbnails
  39.   -v    be a bit more verbose
  40.   -3    fake all Type3 fonts as Times-Roman
  41.   
  42. Known problems:
  43.   The ProcSet in the prolog uses binary object sequences. This is a
  44.   Level 2/DPS feature which causes problems on some PS clones. E.g.,
  45.   GhostScript up to version 3.33 doesn't like it. (But GS 3.33 knows to
  46.   display PDF files itself). In severe cases I can provide a workaround.
  47.  
  48. Feature?:
  49.   Beginning with version 2.12, pdf2ps will produce 7bit printable ASCII
  50.   output by default (PDF might contain 8bit data which was retained in 
  51.   earlier versions). This will cause increased runtime, increased output
  52.   file size and increased transfer time to your printer. It is however
  53.   neccessary because some control characters might otherwise perform
  54.   job control commands on the printer like "end of job" or others.
  55.   pdf2ps tries to figure out itself where such encoding is needed.
  56.   By default encoding is done with ASCII85 encoding ("btoa"). This is
  57.   very slow in perl but the most compact (7-bit) format. You may choose
  58.   good ole HEX encoding with "-x", which is much faster but generates
  59.   considerably larger files. If all your transmission chanels are
  60.   8-bit clean you might consider the -b (binary) option which leaves
  61.   all binary data untouched - this is the fastest and smallest but
  62.   might cause the data transfer to the printer fail totally.
  63.           Format:        Binary          Ascii85           Hex
  64.         Size:           100 %          <= 125 %         <= 200 %
  65.         Time:           100 %          150-800 %         ~ 130 %
  66.  
  67. Disclaimer:
  68.   This is just a crude hack. It was never intended to become a "real"
  69.   program - I just wanted to play around a little with the PDF format.
  70.   If it works for you - fine. If it doesn't, you can drop me a note,
  71.   and I'll see what I can do. Occasionally I will also expand its
  72.   functionality (perhaps upon request), but as I have some other work
  73.   to do, I'll do so on a decreased priority.
  74.   It works for the most files I tested it with, but it might make
  75.   assumptions on the file structure where the PDF specs allow a wider range.
  76.  
  77.   In short: use at your own risk.
  78.  
  79. Have fun
  80.     Detlev
  81.     droege@informatik.uni-koblenz.de
  82.  
  83. Copyright (C) 1993-1995 Detlev Droege
  84. You may freely use and distribute the script, but you must not charge
  85. any money or other value for it, remove the copyright notice or claim
  86. that you (or someone else other than me) wrote it.
  87.  
  88. --
  89. Detlev Droege, Uni Koblenz, FB Informatik, Rheinau 1, D-56075 Koblenz, Germany
  90. Tel:+49 261 9119-421,Fax:-497,NeXT/MIME/Email:droege@informatik.uni-koblenz.de
  91.