ftp.nice.ch/pub/next/text/apps/PDFViewer.1.22b.README

This is the README for PDFViewer.1.22b.NIHS.b.tar.gz [Download] [Browse] [Up]

PDFViewer
an application to view Adobe Acrobat PDF files under NEXTSTEP.

PROVIDED AS IS - NO WARRANTY - BUG REPORTS WELCOME

PDFViewer is constantly under development.
It does cope with the PDF-1.0 and PDF-1.1 file format versions.
Should eat new PDF-1.2 too, but still issues a warning on the console.
Current version of PDFViewer is 1.22 (3. Oct. 1997).

Task:
Display PDF files like the normal PostScript previewer does. Navigation is similar too.

Requirements:
	- NEXTSTEP 3.1 or higher, 3.3 or higher recommended.
	
Usage:
	should be obvious (see Info/Usage...)
	
what it does:
	- displays the PDF file
	- lets you navigate through the pages
	- zooming between 10 % and 800 %
	- printing of the entire file or selected pages
		(currently slightly corrupted for rotated pages)
	- obeys rotation info
	- obeys crop info
	- follows annotation links inside the document (PDF-1.0 format)
	  and partly to external PDF documents (generic launch actions)
	- follows "WebLinks", URIs embedded as links in PDF files
	- displays text annotations
	- handles bookmarks (outlines)
	- handles thumbnails
	- any unknown fonts are reasonably substituted
	
not yet implemented:
(you'll see "NOT YET IMPLEMENTED" messages in the console for some of these)

	- articles/beads (first steps are there)
	- TrueType fonts (will be substituted in any case).
	- deal with Pattern new color spaces
	- NEXTSTEP-Help
	- fancy InfoPanel gadget
	- ...

current (mis-)features
	- 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 :-)
		
other mess:
	- the PostScript code in the Prolog stems from the experimental phase and is not yet cleaned up, good, optimized, or even correct. (some text render modes are ignored.)
	- some special chars aren't supported by NextStepEncoding, so they are faked in PDFDocEncoding strings. Affects text annotations and bookmarks.
	- some boring messages are always written to the console

Ideas to think about:
	- filter mode for PDF->PS filter service (thanks to Joe Pasqua)
	
Known problems:	
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.

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.
	
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.

	Detlev
	droege@informatik.uni-koblenz.de

The PDF format is Copyright Adobe Systems Incorporated.
--
Detlev Droege,
UniversitÙt Koblenz,	     
Institut för Informatik,
Rheinau 1,                 Voice:   +49 261 9119-421
D-56075 Koblenz            Fax:     +49 261 9119-497
Germany

NeXT/MIME/Email:	droege@informatik.uni-koblenz.de
Copyright (C) 1993-1997 Detlev Droege

Changes in 1.22:
	- handle/emulate Separation color spaces (PDF-1.2)
	- fix bug in display code of thumbnails (introduced with calib. CS)
	- make text annotations movable, other bug fixes
	- fix bug in Thumbnail color handling
Changes in 1.14 (since 1.03):
	- handle calibrated color spaces and default color spaces
	- collect multiply used resources in the main prolog when printing
	- support for PDF-1.2 (FlateDecode, new /name syntax and other stuff)
	- some bug fixes (e.g. no more crash when printing N-up ...)

PDF Decryption facility:
  The PDF format allows for en/decryption of its contents. PDFViewer supports
  this via a "bundle" which is _not_ part of this regular distribution due
  to the U.S. export laws which consider such software to be "munition".
  
  The bundle is available for downloawd from this place in Germany
  	ftp://ftphost.uni-koblenz.de/outgoing/People/droege/
  as Standard.pdfcrypt.NIHS.b.tar.gz . Do NOT put that bundle on any U.S.
  FTP server or you most probably violate U.S. laws. You may import it into
  the U.S., but not export it.
  

These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.