Documentation for   -=|=- PostImpression -=|=-   version 0.2b

PostScript (tm) downloader for the Orca (tm) 1.1 shell environment.

PostImpression is copyright (c) 1990 by Jeremy Quinn.
Certain portions of this software are copyrighted by The Byte Works Inc.

----------------------
Disclaimer of Warranty
----------------------------------------------------------------------------

Jeremy Quinn makes no warranty or representation, either express or implied,
with respect to this software, its quality, performance, merchantability,
or fitness for a particular purpose. As a result, this software is sold
"AS IS," and you the purchaser, are assuming the entire risk as to its
quality and performance. In no event shall Jeremy Quinn be held liable for
direct, indirect, special, incidental, or consequential damages resulting
from any defect in this software or its documentation.

----------------------------------------------------------------------------

----------------
ShareWare Notice
----------------------------------------------------------------------------


Permission is given to freely distribute, as long as the original
Shrinkit file maintains intact.  This contains the follwing files:

PostScript      EXE     Program File
PostScript      TXT     Help File
Dox             TXT     Documentation File

PostImpression is not free, also it is not in the public domain;
It may not be sold or packaged with ANY software that is for sale.
You may try it free for 10 days after which you must either become a
registered user or discontinue use of the software.

To become a registered user, send exchangable currency to the value of

10 Pounds Sterling

 to:

Jeremy Quinn
4. Heathfield House
Rushcroft Road
London SW2 1LE
United Kingdom

Tel. +44 71 737 6831

Make sure you send me your full address, and the program's version number,
with your payment, so I can forward to you details of how to "Un-Lock"
your copy of PIE. Alternatively send me your full TABBS, Compuserve or
Internet address. I do not have access to any other systems. Also I would
be interested to know where you got your copy of PostImpression from.

Comments/suggestions/bug reports will be gratefully accepted, and should
be sent to me at the above address,
or by EMail to CIS 100016,560 or TABBS.

Credits:
I would like to thank the following for their help, support, ideas and
Beta Testing (in alphabetical order you guys!).

Ewen Wannop
Mark Wilson
Mike Westerfield
Robert A. Rosenberg
Stuart Anderson


------------
Requirements
------------

Apple][gs with about 1 meg of memory, preferably with a hard disk.
LaserWriter (not SC) networked via or connected directly to the AppleTalk Port.
Version 1.1b (or later) of ORCA shell. Unfortunately APW 1.1 does not exist.
GSOS System 5.02 (or later). With LaserWriter Driver Installed.

-----------
Description
-----------

PostImpression (PIE) is a PostScript downloader, implemented as a Language
under the Orca Shell. It works in both the "Text" and "DeskTop" (requires
PRIZM) modes of the shell. PIE is designed particularly for programmers who
want to test their hand written PostScript code. It allows you to use your
favorite (?) programming environment to write, edit and test PostScript
like any other language. Just "Compile" your language stamped source file
in the normal way, and it is sent to your LaserWriter. PIE will also
allow you to download Fonts, EPS files, LW Driver disk dumps, Custom Error
Handlers etc. to your PostScript device.

Please NOTE

PIE does not currently support LaserWriter Error reporting. This
severely limits the usefulness of this program. Rest assured that I am
working on the next version of this program and will release it as soon
as possible. The next release will have full 2 way communications
with the PostScript device. Free upgrades will be available to those
who have paid their ShareWare fees.

------------
Installation
------------

1. If necessary, use the Installer to install the LaserWriter and AppleTalk
   drivers in your */System/Drivers subdirectory.

2. Select AppleTalk in the Slots section of the Control Panel,

       If you have a Rom 01 machine, you will have to select AppleTalk
   in slot 7, and YourCard in whichever slot/port (1 or 2) that you have
   your LaserWriter connected to.

       If you have a Rom 03 machine, don't bother about slot 7, just
   select AppleTalk in the slot/port you have your LaserWriter on.

3. Re-Boot your computer if you took steps 1 & 2.

4. Copy the "exe" file "PostScript" to the ORCA/LANGUAGES subdirectory of
   your ORCA disk. Make sure you use a file copy program that handles
   resource forks properly.

5. Copy the "txt" file "PostScript" to the ORCA/UTILITIES/HELP subdirectory
   of your Orca disk.

6. Edit the file SYSCMND in Orca/System, placing the following line in the
   file, (if you place it in the file so the left hand column is sorted
   alphbetically, you will get proper name expansion).

POSTSCRIPT      L       1817            PostImpression

   Save SYSCMND and either type "Command" to install the new command table,
   or re-start Orca.

7. Edit the file SYSTABS in Orca/System, placing the following 3 lines in
   the file. Refering to the manual, adjust the tab stops and default cursor
   to your liking.

1817
00010
000000001000000010000000100000001000000010000000100000001000000010000000100000001000000010000000000000001000000010000000100000001000000010000000100000001000000010000000100000001000000010000000100000001000000010000000100000001000000010000000100000001000002

8. You might want to change the name of the Language, "PostScript" is too
   long to fit properly on the screen after a Catalog command in the
   Text Shell. Lets say you wanted to change it to "Post".

        Edit the SYSCMDS file, changing "POSTSCRIPT" to "POST", Save SYSCMND
   and either type "Command" to install the new command table,
   or re-start Orca.

        Now rename the file "PostScript" in ORCA/LANGUAGES and the same
   filename in ORCA/UTILITIES/HELP.


----------
How to Use
----------

Text Shell (or from Shell Window in PRIZM)
------------------------------------------

1. If necessary change the Language of your PostScript source file to
   POSTSCRIPT by typing
        CHANGE YourSourcePathName POSTSCRIPT
   at the shell command prompt.

2. Switch on and select your LaserWriter. You may need to access the
   LaserWriter CDev in the Control Panel to select your printer and network
   zone. This should obviously be done from a desktop program or from the
   NDA utility if you have it. Alternatively you could use the Chooser.
   If you had your LaserWriter selected properly before, and
   have'nt subsequentially changed it, you should not need to do it again.

3. Type
        COMPILE YourSourcePathName
   at the shell command prompt. (Any Compile, Assemble, Run command should
   work.

   PIE will start up any tools required, switch to DeskTop mode, send your
   PostScript code to the LaserWriter, shut down the desktop and any started
   tools, then quit to the Text Shell.

   Thats It!


DeskTop Shell (PRIZM)
---------------------

1. "Open" your source file, or select it's window if it's already loaded.

2. If necessary change the Language stamp of the source file by selecting
   POSTSCRIPT from the Languages Menu.

3. If not already done, select the LaserWriter and Network Zone you want to
   use from the Control Panel.

4. Select one of the Compile options from the Run Menu.

   PIE will start up any tools required, send your PostScript code to the
   LaserWriter, shut down any started tools, then quit to the Desk Shell.

   Thats It!


Both Shell Modes
----------------

PIE currently only reports ToolBox and Driver Errors. If there are errors
in your PostScript code, these will not be reported. However if you have
a PostScript Error Handler that prints your errors, that will work. Try
the Error Handler in Don Lancaster's PS.Util.7, it works fine.

You can stop PIE sending data any time by pressing OA. (Command dot).
Once your LaserWriter is processing your program, this will not stop it.

As PIE uses the Print Manager and LaserWriter driver, certain initialization
is done by the LW Driver to the User Space of the LaserWriter
(for QuickDraw). This distorts images produced by any PostScript code that
expects a "clean" environment. PIE takes steps to prevent this from
happening. If you want your PostScript code to work in the environment
setup for QuickDraw, you need to put some PostScript commands at the
beginning and end of your code:-

At Beginning

 grestore  %% restore QuickDraw graphic environment %%

At the End

 gsave     %% balance the Graphic Stack %%


These commands must be removed if you send your PostScript from another
downloader. Once again they are only required if you want to use the
graphic environment (transformation scale etc) setup for QuickDraw.

Another problem with the LW Driver is that it sends its own "showpage"
command, this causes a blank page to be output (after your output) if
you have a "showpage" in your program. Just leave out the last showpage
from your program. Replace it if you use your PostScript program from
another downloader. Alternatively you could place a "quit" command at the
end of your source code.



That's it!


Have Fun!


And please pay the Shareware!!