home *** CD-ROM | disk | FTP | other *** search
/ swCHIP 1991 January / swCHIP_95-1.bin / utility / gsview13 / gsgrab / gsgrab.doc < prev    next >
Text File  |  1995-12-09  |  6KB  |  151 lines
  1. 1Overview
  2. ?Overview
  3.  GSgrab is still under development.  Expect to find problems.
  4.  
  5.  GSgrab is a utility to capture the output of the MS-Windows PostScript
  6.  printer driver and automatically print it using Ghostscript.
  7.  
  8.  GSgrab will add `GSGRAB` to the the list of available printer
  9.  ports.  A PostScript printer driver connected to GSGRAB will
  10.  direct its output into the file GSGRAB in the Windows directory.
  11.  
  12.  GSgrab periodically checks for the existence of the GSGRAB file.
  13.  If the file is accessible, GSgrab gives it to Ghostscript for Windows
  14.  for printing.
  15.  When Ghostscript for Windows has finished, GSgrab deletes the file
  16.  GSGRAB then restarts periodically checking for the existence
  17.  of the file.
  18. 2Installation
  19. ?Installation
  20.  This version of GSgrab works best with Ghostscript for Windows 3.12 
  21.  or later, but will work with Ghostscript 2.6.1.
  22.  
  23.  Install GSgrab by copying gsgrab.exe and gsgrab.hlp to your
  24.  Ghostscript directory.
  25.  
  26.  From the Program Manager, create a program item for GSgrab.
  27.  Start GSgrab and the Installation help (which you are reading
  28.  now) and the GSgrab `Setup` dialog box will be displayed.
  29.  
  30.  From the `Setup` dialog box, edit the `Ghostscript Command`
  31.  to enter the correct executable path and include path for Ghostscript.
  32.  For example
  33.    c:\gs\gswin.exe -Ic:\gs;c:\gs\fonts
  34.  
  35.  It is essential that you get both the executable and the include path
  36.  correct otherwise GSgrab will either complain that it cannot run
  37.  gswin, or it will start and then immediately exit with an
  38.  error code.
  39.  
  40.  Next set the correct `Printer`, `Resolution` and `Port`.
  41.  Then select `Ok`.
  42.  
  43.  Now start up the `Control Panel`, then `Printers`, add
  44.  a PostScript printer (Apple Laserwriter II NT is suitable) and
  45.  then `Connect` it to `D:\WINDOWS\GSGRAB`.
  46.  
  47.  GSgrab should now work.
  48.  Try it by printing to the PostScript printer which should
  49.  write to the file GSGRAB.  After a few seconds GSgrab will
  50.  start Ghostscript which will then write output to a real
  51.  printer port.
  52.  If all works properly, you may wish to put the GSgrab program
  53.  item into the Startup group.
  54.  
  55.  To uninstall GSview, remove the files you installed above, then remove
  56.  c:\windows\gsgrab.ini from the appropriate windows directory.
  57.  Next edit win.ini, find the section [ports] and remove
  58.  the line `D:\WINDOWS\GSGRAB=`
  59.  
  60.  If you have problems, try reading the help topic `Common Problems`.
  61.  
  62. 2Setup
  63. ?Setup
  64. ?Ghostscript Command
  65. ?Printer
  66. ?Resolution
  67. ?Ports
  68. ?Interval
  69.  Options that can be changed using GSgrab Setup are:
  70.  
  71.  `Ghostscript Command`
  72.  
  73.  This is typically "c:\gs\gswin.exe -Ic:\gs;c:\gs\fonts;c:\psfonts"
  74.  This must include the full path to gswin and the include path for gswin.
  75.  
  76.  `Printer`
  77.  
  78.  A name of a Ghostscript printer device.
  79.  A drop down combo box contains the names of printers in Ghostscript 3.0.
  80.  
  81.  `Resolution`
  82.  
  83.  Resolution of the Ghostscript printer device in dots per inch.
  84.  A drop down combo box contains the resolutions compatible
  85.  with known Ghostscript 3.0 printer devices.
  86.  
  87.  `Port`
  88.  
  89.  The printer port to be used by Ghostscript.
  90.  
  91.  If using GSgrab with Ghostscript 2.6.1, you `must` set the printer
  92.  port to <Unknown>.  Ghostscript will ask you for a printer port.
  93.  
  94.  `Interval`
  95.  
  96.  The time interval at which GSgrab checks for the existence of
  97.  the GSGRAB file.
  98.  
  99. 2Copyright
  100. ?Copyright
  101.  The `About` button shows the GSgrab copyright message
  102.  and GSgrab version number.
  103.  
  104.   GSgrab.EXE - A Ghostscript printer interface
  105.  
  106.  Copyright (C) 1994, 1995, Russell Lang.  All rights reserved.
  107.   
  108.  This program is distributed with NO WARRANTY OF ANY KIND.  No author
  109.  or distributor accepts any responsibility for the consequences of using it,
  110.  or for whether it serves any particular purpose or works at all, unless he
  111.  or she says so in writing.  Refer to the GSview Free Public Licence 
  112.  (the "Licence") for full details.
  113.   
  114.  Every copy of GSview must include a copy of the Licence, normally in a 
  115.  plain ASCII text file named LICENCE.  The Licence grants you the right 
  116.  to copy, modify and redistribute GSview, but only under certain conditions 
  117.  described in the Licence.  Among other things, the Licence requires that 
  118.  the copyright notice and this notice be preserved on all copies.
  119.  
  120.      Author: Russell Lang
  121.    Internet: rjl@aladdin.com
  122.  
  123. 2Problems and Tasks
  124. ?Problems and Tasks
  125.  16bit Ghostscript for Windows is a large model program.  Only one
  126.  copy can be running at a time.  If a user tries to print while
  127.  Ghostscript is already running (e.g. for preview with GSview)
  128.  then an error message will result.
  129.  
  130.  The user must wait until Ghostscript has finished before printing
  131.  another file to GSGRAB.  Not sure if Ghostscript accessing the
  132.  file will stop the Print Manager from overwriting the file.
  133.  
  134.  Requires quit.ps to be on the Ghostscript include path.
  135.  
  136.  Printer port selection will confuse Ghostscript 2.6.1.
  137.  Must use <Unknown>.
  138.  
  139.  If the Ghostcript Command is too long, then Ghostscript will not be
  140.  started.  To shorten the command line, move Ghostscript to directory
  141.  with a shorter path, and/or put the -I option inside a file and
  142.  include that file on the Ghostscript command with the Ghostscript
  143.  @filename option that is described in the Ghostscript use.doc.
  144.  For example, the command line:
  145.   c:\winapps\ghostscr\gswin.exe -Ic:\winapps\ghostscr;c:\winapps\ghostscr\fonts;c:\psfonts
  146.  would be better if the file c:\winapps\gsgrab.opt contained
  147.   -Ic:\winapps\ghostscr;c:\winapps\ghostscr\fonts;c:\psfonts
  148.  and the Ghostscript command was
  149.   c:\winapps\ghostscr\gswin.exe @c:\winapps\gsgrab.opt
  150.  
  151.