home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-Update.iso / NEXTSTEP / text / apps / PDFViewer.README < prev   
Encoding:
Text File  |  1997-05-25  |  3.6 KB  |  89 lines
  1.  
  2. PDFViewer
  3. an application to view Adobe Acrobat PDF files under NEXTSTEP.
  4.  
  5. PROVIDED AS IS - NO WARRANTY - BUG REPORTS WELCOME
  6.  
  7. PDFViewer is constantly under development.
  8. It does cope with the PDF-1.0 and PDF-1.1 file format versions.
  9. Should eat new PDF-1.2 too, but still issues a warning on the console.
  10. Current version of PDFViewer is 1.17 (24. May 1997).
  11.  
  12. Task:
  13. Display PDF files like the normal PostScript previewer does. Navigation is similar too.
  14.  
  15. Requirements:
  16.     - NEXTSTEP 3.1 or higher, 3.3 or higher recommended.
  17.     
  18. Usage:
  19.     should be obvious (see Info/Usage...)
  20.     
  21. what it does:
  22.     - displays the PDF file
  23.     - lets you navigate through the pages
  24.     - zooming between 10 % and 800 %
  25.     - printing of the entire file or selected pages
  26.         (currently slightly corrupted for rotated pages)
  27.     - obeys rotation info
  28.     - obeys crop info
  29.     - follows annotation links inside the document (PDF-1.0 format)
  30.       and partly to external PDF documents (generic launch actions)
  31.     - follows "WebLinks", URIs embedded as links in PDF files
  32.     - displays text annotations
  33.     - handles bookmarks (outlines)
  34.     - handles thumbnails
  35.     - any unknown fonts are reasonably substituted
  36.     
  37. not yet implemented:
  38. (you'll see "NOT YET IMPLEMENTED" messages in the console for some of these)
  39.  
  40.     - GoToR actions, {Win,Unix} launch actions.
  41.     - articles/beads (first steps are there)
  42.     - TrueType fonts (will be substituted in any case).
  43.     - deal with all these nifty new color spaces in PDF-1.1
  44.       (it's not even easy to ignore them correctly :-)
  45.     - NEXTSTEP-Help
  46.     - fancy InfoPanel gadget
  47.     - ...
  48.  
  49. current (mis-)features
  50.     - the output view is cached up to a zoom factor of 300% to improve scrolling response. Larger zoom factors are not cached to avoid extensive VM usage. If the output fits into the ScrollView content, caching is turned off either to improve output speed. This is similar to Preview.app and makes you watch the fun appearing on the screen :-)
  51.         
  52. other mess:
  53.     - the PostScript code in the Prolog stems from the experimental phase and is not yet cleaned up, good, optimized, or even correct. (most text render modes are ignored.)
  54.     - some special chars aren't supported by NextStepEncoding, so they are faked in PDFDocEncoding strings. Affects text annotations and bookmarks.
  55.     - some boring messages are always written to the console
  56.  
  57. Ideas to think about:
  58.     - filter mode for PDF->PS filter service (thanks to Joe Pasqua)
  59.     
  60. Known problems:    
  61. Why 3.X? The program makes use of PostScript Level 2 as does the PDF format itself. Therefore, PS Level 2 is a must. It is, as well, for printing devices.
  62.  
  63. Due to a bug in the decompression of CCITTFaxDecode images in the Display PostScript used in NEXTSTEP versions prior to 3.3, this version (or any following one) is recommended. As displaying such images in 3.[012] might hang the app, a crossed box is drawn instead and a warning panel appears.
  64.     
  65. Of course there are a lot of things remaining to be done, but if you have any  suggestions beyond the obvious, don't hesitate. Bug reports welcome.
  66.  
  67.     Detlev
  68.     droege@informatik.uni-koblenz.de
  69.  
  70. The PDF format is Copyright Adobe Systems Incorporated.
  71. --
  72. Detlev Droege,
  73. Universität Koblenz,         
  74. Institut für Informatik,
  75. Rheinau 1,                 Voice:    +49 261 9119-421
  76. D-56075 Koblenz             Fax:    +49 261 9119-497
  77. Germany
  78.  
  79. NeXT/MIME/Email:    droege@informatik.uni-koblenz.de
  80.  
  81. Changes in 1.17:
  82.     - make text annotations movable
  83.     - fix bug in display code of thumbnails (introduced with calib. CS)
  84. Changes in 1.14 (since 1.03):
  85.     - handle calibrated color spaces and default color spaces
  86.     - collect multiply used resources in the main prolog when printing
  87.     - support for PDF-1.2 (FlateDecode, new /name syntax and other stuff)
  88.     - some bug fixes (e.g. no more crash when printing N-up ...)
  89.