home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / wps / progs / goscript / readme.1st < prev    next >
Encoding:
Text File  |  1992-11-06  |  6.0 KB  |  146 lines
  1. Program Description:
  2.  
  3.   This is an OS/2 2.0 port of the GNU GhostScript 2.5.2 with a Presentation
  4. Manager driver (Version 1.1 by Jim Yang).  
  5.  
  6. This version:
  7.  
  8.     1.  Is gray scale only.
  9.  
  10.     2.  Can redraw properly after it has been minized or covered by
  11.         another window, and then exposed.
  12.  
  13.     3.  Can accept character input from the drawing window (mainly used
  14.         to send carriage return to the GhostScript interpreter to go to
  15.         the next page), so that you can always keep the drawing window
  16.         in front.
  17.  
  18.     4.  Is compiled with the following drivers:
  19.             os2pm epson eps9high bj10e deskjet djet500 laserjet ljetplus
  20.         ljet2p ljet3 cdeskjet cdjcolor cdjmono paintjet pjetxl gifmono
  21.         gif8 dfaxhigh dfaxlow. (Note that I have not tested any driver
  22.         other than os2pm, gifmono, and gif8.)
  23.  
  24. The program consist of two executables: gsos2a.exe and gsos2b.exe.
  25. Gsos2a.exe contains three threads: two of them perform stdin for GhostScript,
  26. and the third performs stdout/stderr.  Gsos2b.exe contains two threads: one
  27. redraws the window when it needs to, and the other is the GhostScript
  28. interpreter itself.  Named pipes are used to communicate between the two
  29. executables.
  30.  
  31. Proposed Directory: (for storage on hobbes)
  32.  
  33.     os2/2.0/gnu
  34.  
  35.  
  36. New feature of 1.1
  37. -------------------
  38. 1.  Fixes the bug that sometimes causes the command window to hang after
  39.     you exit GS, and introduces a new 'feature' - NOW YOU MUST PRESS
  40.    'RETURN' AFTER GS EXITS TO GET THE COMMAND PROMPT BACK.  As of this
  41.     writing, I am unable to get rid of this 'feature'.
  42. 2.  Makes updating of the drawing window smoother.
  43. 3.  Adds dfaxhigh and dfaxlow device driver.
  44. -------------------
  45.  
  46.  
  47. **********************  VERY IMPORTANT *************************************
  48. This port of GhostScript was compiled with emx 0.8e, and requires the
  49. following dll's:
  50.  
  51.     emx.dll      emxio.dll    emxlibc.dll
  52.  
  53. HOWEVER, THE EMXLIBC.DLL THAT COMES WITH EMX 0.8E CONTAINS A BUG IN FUNCTION
  54. FREXP, WHICH PREVENTS GHOSTSCRIPT FROM BEING ABLE TO DISPLAY FONTS.  THE
  55. EMXLIBC.DLL THAT COMES WITH THIS ARCHIVE IS A CORRECTED VERSION; THEREFORE
  56. YOU MUST USE THIS DLL WITH GHOSTSCRIPT.  THIS APPLIES TO ALL THE DRIVERS
  57. (PM, LASERJET, GIF8, ETC).
  58.  
  59. As usual, put the dll's in a directory that's in your LIBPATH.
  60. *****************************************************************************
  61.  
  62. To use the program:
  63.  
  64.     1.  Edit the file gsos2.cmd file.  Set the position of the drawing
  65.         window with the environment variable gsos2_pos.  Syntax:
  66.  
  67.                      gsos2_pos=X Y WIDTH HEIGHT,
  68.  
  69.         where (X,Y) is the lower left corner of the window, and WIDTH and
  70.         HEIGHT are the width and height of the window, NOT including the
  71.         width and height of the window border.  The values 352 2 442 572
  72.         are ok if you have a 800 x 600 display.  Also, set the environment
  73.         variable gs_lib to tell GhostScript were the initialization files
  74.         (gs_init.ps, gs_fonts.ps, etc) are.
  75.  
  76.         Set the environment variable gsos2_dpi.  Syntax:
  77.  
  78.             gsos2_dpi=Xdpi Ydpi,
  79.  
  80.         where Xdpi = WIDTH / (paper width in inches), and Ydpi = HEIGHT /
  81.         (paper height in inches).  For example, if you specify 442 as
  82.          WIDTH and 572 as HEIGHT for gsos2_pos, and you want use the 
  83.         drawing window to preview 8.5 inch X 11 inch drawings, then
  84.         Xdpi = 442 / 8.5 = 52 and Ydpi = 572 / 11 = 52.  GhostScript
  85.         produce better results for halftone patterns (dithering) 
  86.         when you make Xdpi = Ydpi.
  87.  
  88.     2.  Type 'gsos2' from a windowed os2 session.  Type
  89.  
  90.         gsos2 "-sDEVICE=gif8"
  91.  
  92.         to select the gif8 device.  Note the quotes around 
  93.         -sDEVICE=gif8.
  94.  
  95. To terminate the program: type 'quite' or double click on the ghost icon
  96. on the upper left hand corner of the drawing window.
  97.  
  98. You can type commands when either the command window or the drawing window
  99. has the input focus.  However, the drawing window accepts only simple
  100. characters, including carriage return and backspace, but not characters
  101. like tab.  The ability of the drawing window to take input is mainly
  102. intended for passing carriage return to the GS interpreter in response to 
  103. the "showpage, press <return> to continue" prompt, and for issusing simple
  104. commands like "(tiger.ps) run".  Since the inputs to the
  105. command window and inputs to the drawing window are maintained by differents
  106. threads with different charater buffers, you should finish typing a complete
  107. line (punctuated by carriage return) before switching to the other window.
  108. For example, you should not start typing a line into the command window, and
  109. subsequently switch and type the rest of the line into the drawing window.
  110.  
  111.  
  112. Optional:
  113.  
  114.     1.  Add a program object to one of your folders that points to the
  115.         file 'gsos2.cmd', and then attach the ghost.ico icon (included
  116.         with this archive) to the program object.  Then you can drag
  117.         and drop a PostScript file over the ghost icon and GS will
  118.         automatically display that file.
  119.  
  120.     2.  Edit the file "fontmap" so that GS uses the .pfb fonts in your
  121.         \psfonts directory.  For example, append the line
  122.  
  123.         /Helvetica                      (d:/psfonts/helv.pfb);
  124.  
  125.         to the end of "fontmap", and GS will use d:/psfonts/helv.pfb
  126.         whenever it needs the Helvetica font.  Note: GS cannot read
  127.         the Times-Roman font in the \psfonts directory.
  128.  
  129. Remember, use forward slashes to separated directories - ie, use 
  130. "(/apps/gs/tiger.ps) run" to preview the file 'tiger.ps'.
  131.  
  132. So far, gsos2pm11 works correctly with all of my PostScript files.  If    
  133. you find one that won't work, first test it with other drivers, like gif8.    
  134. Then, send me email with a transcript of the GhostScript messages and a copy
  135. of the PostScript file if it's not too large (> 10k); if the file is too
  136. large to transmitt by email, tell me where I can ftp it (with anonymous ftp)
  137. or send me a diskette (I'll keep the diskette, thanks).
  138.  
  139.  
  140. Jim Yang
  141. MS 128-95
  142. California Institute of Technology,
  143. Pasadena, CA  91125
  144.  
  145. email address: jyang@daedalus.caltech.edu
  146.