home *** CD-ROM | disk | FTP | other *** search
/ Mega Top 1 / os2_top1.zip / os2_top1 / APPS / TEKST / GSPM261 / README.OS2 < prev    next >
Encoding:
Text File  |  1993-10-25  |  5.3 KB  |  127 lines

  1. Program Description:
  2.  
  3.   This is an OS/2 2.x port of the GNU GhostScript 2.6.1 with a Presentation
  4. Manager driver.  
  5.  
  6.  
  7. To use the program:
  8.  
  9.         1.  Edit the file gs.cmd file.  Set the position of the drawing
  10.             window with the environment variable gsos2_pos.  Syntax:
  11.  
  12.                 gsos2_pos=X Y windowCX widowCY imageCX imageCY
  13.  
  14.             where (X,Y) is the lower left corner of the client window,
  15.             windowCX and windowCY are the width and height of the client
  16.             window, and imageCX, imageCY are the width and height of the
  17.             document. If the document size is larger then the client window
  18.         size, scroll bars will be created automatically.  
  19.         You can use the arrow keys and the Page Up, Page Down keys to
  20.         move the scroll bars.
  21.         The values
  22.              352 4 442 572 442 572 
  23.         for gsos2_pos specified in gs.cmd are ok if you have a 
  24.         800 x 600 display.  Also, set the environment
  25.             variable gs_lib to tell GhostScript were the initialization files
  26.             (gs_init.ps, gs_fonts.ps, etc) are.
  27.  
  28.             In addition, set the environment variable gsos2_dpi.  Syntax:
  29.  
  30.                         gsos2_dpi=Xdpi Ydpi,
  31.  
  32.             where Xdpi = WIDTH / (paper width in inches), and Ydpi = HEIGHT /
  33.             (paper height in inches).  For example, if you specify 442 as
  34.             WIDTH and 572 as HEIGHT for gsos2_pos, and you want use the 
  35.             drawing window to preview 8.5 inch X 11 inch documents, then
  36.             Xdpi = 442 / 8.5 = 52 and Ydpi = 572 / 11 = 52.  GhostScript
  37.             produce better results for halftone patterns (dithering) 
  38.             if you make Xdpi = Ydpi.
  39.  
  40.             Set the environment variable gsos2_mode.  Syntax:
  41.  
  42.                         gsos2_mode=N
  43.  
  44.         where 
  45.             N = 8 for 256 color mode
  46.             N = 4 for 16 gray scale mode
  47.             N = 2 for 4 gray scale mode
  48.             N = 1 for monochrome mode
  49.  
  50.     2.  Put gsos2a.exe and gsos2b.exe in you PATH and gspm.dll in
  51.         your LIBPATH.
  52.  
  53.         3.  Type 'gs' from a windowed os2 session.  For example, type
  54.  
  55.                 gs "-sDEVICE=gif8"
  56.  
  57.             to select the gif8 device.  Note the quotes around 
  58.             -sDEVICE=gif8.
  59.  
  60. To terminate the program: type 'quit' or double click on the ghost icon
  61. on the upper left hand corner of the drawing window.
  62.  
  63. You can type commands when either the command window or the drawing window
  64. has the input focus.  However, the drawing window accepts only simple
  65. characters, including carriage return and backspace, but not characters
  66. like tab.  The ability of the drawing window to take input is mainly
  67. intended for passing carriage return to the GS interpreter in response to 
  68. the "showpage, press <return> to continue" prompt, and for issusing simple
  69. commands like "(tiger.ps) run".  Since the inputs to the command window and
  70. inputs to the drawing window are maintained by differents threads with
  71. different character buffers, you should finish typing a complete
  72. line (punctuated by carriage return) before switching to the other window.
  73. For example, you should not start typing a line into the command window, and
  74. subsequently switch and type the rest of the line into the drawing window.
  75.  
  76.  
  77. Optional:
  78.  
  79.         1.  Add a program object to one of your folders that points to the
  80.             file 'gs.cmd', and then attach the gsos2b.ico icon (included
  81.             with this archive) to the program object.  Then you can drag
  82.             and drop a PostScript file over the ghost icon and GS will
  83.             automatically display that file.
  84.  
  85.         2.  Edit the file "fontmap" so that GS uses the .pfb fonts in your
  86.             \psfonts directory.  For example, append the line
  87.  
  88.                 /Helvetica    (d:/psfonts/helv.pfb);
  89.  
  90.             to the end of the file fontmap, and GS will use d:/psfonts/helv.pfb
  91.             whenever it needs the Helvetica font.  For your convience,
  92.         a file called fontmap.tail is included with this archive.  If
  93.         you append fontmap.tail to the end of fontmap, GS will use
  94.         all of the ATM fonts that came with OS/2 2.x.  Fontmap.tail
  95.         assumes that the ATM fonts are in the d:\psfonts directory.
  96.  
  97. Remember, use forward slashes to separated directories - ie, use 
  98. "(/apps/gs/tiger.ps) run" to preview the file 'tiger.ps'.
  99.  
  100.  
  101. Known Problems:
  102.  
  103. 1.  When using the 256 color mode, some windows' colors are all wrong.  This
  104.     is because these programs do not handle the WM_REALIZEPALETTE message
  105.     correctly.  Solution: don't use these programs, or use the 16 gray scale
  106.     mode of the gspm26.
  107.  
  108. 2.  If you use the VGA display driver, you can only use the 
  109.     4 gray scale mode; furthermore, screen redraw using the 
  110.     VGA display driver is rather slow due to a bug in the 
  111.     function GpiDrawBits.  If you use the 64k color driver
  112.     from S3-64k, you cannot use the 256 color mode because
  113.     the 64k color driver does not support the palette manager.
  114.     (I should fix this problem but I don't have the time.)
  115.     Finally, the 256 color driver from S3-16m does not redraw
  116.     the image correctly (apparently a bug in GpiDrawBits)
  117.     so use the 256 color driver from either S3-256 or S3-64k.
  118.  
  119.     This PM driver has been tested with the 256 color driver from
  120.     IBM's S3-256 and S3-64k driver.
  121.  
  122.  
  123.  
  124. Jim Yang
  125. jyang@daedalus.caltech.edu
  126.  
  127.