home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / zip / gdos / pscapt10.lzh / PSCAPT10 / PSCAPT.DOC < prev   
Text File  |  1989-06-23  |  10KB  |  241 lines
  1.  
  2.  
  3.                      PS Capture Version 1.00                     6/20/1989
  4.                      (C) 1989 Surreal Systems
  5.                        Charles S. Smeton
  6.  
  7.  
  8.   This program is shareware, anyone finding it useful is asked to send
  9. a $5.00 shareware contribution to the author at:
  10.  
  11.       8624 Spruce Run Court
  12.       Ellicott City, MD
  13.       21043
  14.  
  15.   The comments and suggestions can also be forwarded to the author at: 
  16.  
  17.       Compuserve:     73047,2565
  18.       GEnie:          C.S.SMETON    
  19.  
  20.  
  21.   PS Capture is a desk accessory that will allow the output from the
  22. GDOS PostScript driver (supplied with TimeWorks Desktop Publisher ST)
  23. to be redirected from the RS-232 port to a disk file. The file of 
  24. PostScript commands can then be printed with Imagen's UltraScript or a 
  25. PostScript compatible Laser Printer.
  26.  
  27.   The accessory has been designed to work with the GDOS PostScript
  28. Laser Printer driver supplied with the Timeworks Desktop Publisher
  29. ST program. It has been tested to work while using Timeworks Desktop
  30. Publisher ST, the Outprint program supplied with several Migraph
  31. products and the standard GDOS Output program.  It should function 
  32. from within any application that uses the GDOS printer drivers.  If the
  33. application has a menu bar, then the accessory can be used from inside
  34. the application, otherwise it will be necessary to start the capture
  35. process before the application is run. The accessory has been tested with
  36. "Atari GDOS release version 1.1" and Codehead's G+Plus version 1.3 GDOS
  37. replacement.
  38.  
  39.   PSCAPT provides an easier interface to save PostScript output from
  40. Timeworks Desktop Publisher ST than the method supplied with UltraScript.
  41. Several destination files can be created in one session with different
  42. names, rather than to have to keep renaming the PUBLISH.PS files created
  43. using the PRINTER.SYS GDOS driver provided with UltraScript.
  44.  
  45.   PostScript files saved with PSCAPT can be spooled to a PostScript
  46. compatible Laser Printer using Migraph's OSpooler desk accessory, with out
  47. the need for a special OSpooler compatible GDOS PostScript Driver (that
  48. can also redirect PostScript to a disk file).
  49.  
  50.    Ironically the IBM PC version of Timeworks Desktop Publisher, called
  51. Publish It! and the IBM PC GEM Output program (version 3.00 and above)
  52. support printing PostScript to disk. Should these features become available
  53. in the Atari ST versions of these programs, PSCAPT will become obsolete.
  54. Printing PostScript to disk will be possible with the version of Migraph's
  55. Outprint supplied with OSpooler, with a special PostScript GDOS driver that
  56. Migraph has indicated that it will release.
  57.  
  58.    Usage:
  59.  
  60.  
  61.   Place the file PSCAPT.ACC in the root directory of your boot disk and
  62. make sure the GDOS Postscript Laser Printer Driver is properly installed
  63. on the boot disk (using the method described in the Timeworks Desktop
  64. Publisher ST manual, not the method in the UltraScript manual addendum).
  65. Reboot the ST, PSCAPT should now be installed. PSCAPT will also work from
  66. within Codehead's MultiDesk.
  67.  
  68.   To start the capture process, run the application program that you will
  69. use to perform the GDOS output from.  Select the "PS Capture" desk accessory
  70. menu entry. If GDOS or G+Plus is not installed, an error alert will be
  71. displayed.
  72.  
  73.   If GDOS/G+Plus is installed, then an alert box will be displayed
  74. indicating the selection and will allow two choices: 
  75.  
  76.          "Open" (a new capture file)   or
  77.          "Cancel". 
  78.  
  79.   Selecting "Cancel" will abort the selection.
  80.  
  81.   Selecting "Open" will display the standard file selector dialog box,
  82. allowing a new file name to be specified (with a default extension of
  83. ".PS").  If a file was specified in the file selector, then it will be
  84. created.  If an error occurs trying to create the file, an error alert
  85. will be displayed.  If no error occurs, then you will be returned to the
  86. main application program.  Floppy users note: do not change disks if you
  87. specify the ".PS" file on to a floppy disk.
  88.  
  89.   From the application program, perform the steps required to start the
  90. output process.  The output will now be written to the file, instead of the
  91. RS-232 port.  The GDOS PostScript driver will first send a Control-D (04H)
  92. character to signal the laser printer.  PS Capture will pass all characters
  93. through to the RS-232, until the first Control-D is detected.  When the
  94. GDOS PostScript driver is finished, it will send another Control-D to
  95. signal the end of the transfer.  When this character is detected, PS Capture
  96. will automatically close the ".PS" file and the a bell ring will occur.  The
  97. two Control-D characters are not written to the file.
  98.  
  99.   If an error occurs trying to write to the ".PS" file, then an error
  100. alert will displayed the next time the "PS Capture" desk accessory entry
  101. is selected. Standard GEMDOS Cancel/Retry error alerts will also be 
  102. displayed when a file write error occurs.
  103.  
  104.   The user may close the file capture process by selecting the "PS Capture"
  105. desk accessory entry after a file has been opened, but before the second
  106. Control-D has been detected. An alert box will be displayed and will allow
  107. two choices: 
  108.  
  109.          "Close" (a the capture file)   or
  110.          "Cancel". 
  111.  
  112.   Selecting "Cancel" will abort the selection.
  113.  
  114.   Selecting "Close" will write out the remaining buffered contents of the
  115. capture file and then close the file.
  116.  
  117.   The next selection of the "PS Capture" desk accessory entry will return
  118. to the "Open" alert box.
  119.  
  120.   After the ".PS" file has been closed, it may be viewed by double-clicking
  121. it from the GEM Desktop or loaded into any word processor/text editor as it
  122. will be in standard ASCII format.
  123.  
  124.  
  125.  
  126.   How it works:
  127.  
  128.  
  129.   PS Capture redirects the GEMDOS trap #1 vector to its own internal routines.
  130. If the capture process is not in progress, then all trap #1 calls are sent
  131. back to the normal trap #1 handler.  If a file capture is in progress, then
  132. PS Capture checks to see if the call is a GEMDOS function 04H, auxiliary
  133. output.  Note: The BIOS function 03H, Bconout is not affected in any way
  134. by PS Capture as the GDOS PostScript driver uses the GEMDOS auxillary
  135. output.  If an auxillary output function is specified, then if the character
  136. being output is not a Control-D it is sent to the RS-232 as normal.  When
  137. the first Control-D is detected, the file capture process starts.  All
  138. characters detected are placed into a 4096 byte buffer, when the buffer is
  139. full it is written to the file and then reset.  When the second Control-D 
  140. is detected, the remaining buffer contents are written to the file, the
  141. file is closed and all further RS-232 output is sent normally.
  142.  
  143.   An undocumented feature of the GDOS PostScript driver supplied with 
  144. Timeworks Desktop Publisher ST is that if the ALTERNATE and RIGHT-SHIFT
  145. keys are pressed as soon as the output is started, then the driver acts
  146. differently.
  147.  
  148.   Normally the GDOS PostScript driver waits for a response back from the
  149. actual Laser Printer via the RS-232. If the ALTERNATE and RIGHT-SHIFT keys
  150. are pressed, then the driver sends the PostScript information with out
  151. needing a response from the printer. PS Capture fools the GDOS driver
  152. into thinking that these keys are pressed by monitoring the GEMDOS function
  153. 3DH, open file. The GDOS program uses the GEMDOS open file function to
  154. load the PostScript driver program specified in the ASSIGN.SYS file when
  155. the VDI open workstation call is made. PS Capture detects this call and
  156. uses the BIOS function 0BH, kbshift to set the ALTERNATE and RIGHT-SHIFT
  157. keys as if they are pressed. The PostScript driver then will detect that
  158. these keys are pressed and will start the output with out needing a response
  159. from the printer. When the first Control-D is detected, the ALTERNATE and
  160. RIGHT-SHIFT keys are restored to the off state.
  161.  
  162.  
  163.  
  164.   Notes:
  165.  
  166.  
  167.   When printing multi-page documents from Timeworks Desktop Publisher it
  168. is advisable to break up the printing into several passes printing a few
  169. pages per capture file. The same is true when printing a large output
  170. list from the Output/Outprint programs. This technique will result in
  171. smaller PostScript files, large files could exceed the laser printer's
  172. ability to buffer the file if it does not have enough RAM memory
  173. available.
  174.  
  175.   Each captured PostScript file consists of a Prolog that defines PostScript
  176. procedures and a body that consists of the PostScript definition of each
  177. page of the document.
  178.  
  179.   Each page in the body begins with the PostScript statement:
  180.  
  181.   gs initclip
  182.  
  183.   Each page in the body ends with the PostScript statement:
  184.  
  185.   gr /av 0 def FF
  186.  
  187.  
  188.   The PS Capture program will place conforming PostScript header and trailer
  189. comments in the capture file as follows:
  190.  
  191.     Header:
  192.  
  193. %!PS-Adobe-1.0
  194. %%Title: GEM Document
  195. %%Creator: Atari ST GDOS
  196. %%CreationDate: hh:mm:ss mm-dd-yyyy    
  197. %%EndComments
  198.  
  199.  
  200.    Trailer:
  201.  
  202. %%Trailer
  203. %%EOF
  204.  
  205.  
  206.   Disclaimer:
  207.  
  208.  
  209.   This accessory is shareware and is the property of the author.  The author
  210. has made it available free to users on a trial basis.  If the user feels
  211. that the accessory is of some use he/she can register their copy by sending
  212. a $5.00 contribution to the author.
  213.  
  214.   No warranty is implied by the author and the author is not responsible
  215. for the use or damages possibly caused by misuse of this accessory.  This
  216. accessory can be distributed freely on electronic bulletin board systems
  217. as long as it is not modified, this documentation file is included with
  218. the accessory (in archived format) and no direct fee is levied for the
  219. downloading of this accessory and documentation.  This accessory and its
  220. documentation may NOT be placed in distribution with any commercial
  221. program and may NOT be placed on any "Public Domain" disks offered 
  222. commercially or by Computer User's Groups with out permission of the author.
  223.  
  224.  
  225.  
  226. PostScript is a trademark of Adobe Systems, Inc.
  227.  
  228. GDOS, GEMDOS, VDI, GEM Desktop and Output are trademarks of
  229. Atari Corporation and Digital Research, Inc.
  230.  
  231. Desktop Publisher ST and Publish It! are copyrights of Timeworks, Inc.
  232.  
  233. OSpooler and Outprint are copyrights of Migraph,Inc. 
  234.  
  235. UltraScript is a trademark of Imagen.
  236.  
  237. G+Plus and MultiDesk are copyrights of Codehead Software.
  238.  
  239. This accessory program was written in Megamax Laser C.
  240.  
  241.