home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / os2 / gspm25.zip / gspm25.doc < prev    next >
Text File  |  1993-05-20  |  6KB  |  127 lines
  1. Program Description:
  2.  
  3.   This is an OS/2 2.x port of the GNU GhostScript 2.5.2 with a Presentation
  4. Manager driver (Version 2.5a by Jim Yang). 
  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 frame 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 N = 1 for 256 color mode, N = 2 for 16 gray scale mode, and
  45.             N = 0 for 4 gray scale mode.
  46.  
  47.         2.  Type 'gs' from a windowed os2 session.  For example, type
  48.  
  49.                 gs "-sDEVICE=gif8"
  50.  
  51.             to select the gif8 device.  Note the quotes around 
  52.             -sDEVICE=gif8.
  53.  
  54. To terminate the program: type 'quit' or double click on the ghost icon
  55. on the upper left hand corner of the drawing window.
  56.  
  57. You can type commands when either the command window or the drawing window
  58. has the input focus.  However, the drawing window accepts only simple
  59. characters, including carriage return and backspace, but not characters
  60. like tab.  The ability of the drawing window to take input is mainly
  61. intended for passing carriage return to the GS interpreter in response to 
  62. the "showpage, press <return> to continue" prompt, and for issusing simple
  63. commands like "(tiger.ps) run".  Since the inputs to the command window and
  64. inputs to the drawing window are maintained by differents threads with
  65. different character buffers, you should finish typing a complete
  66. line (punctuated by carriage return) before switching to the other window.
  67. For example, you should not start typing a line into the command window, and
  68. subsequently switch and type the rest of the line into the drawing window.
  69.  
  70.  
  71. Optional:
  72.  
  73.         1.  Add a program object to one of your folders that points to the
  74.             file 'gs.cmd', and then attach the ghost.ico icon (included
  75.             with this archive) to the program object.  Then you can drag
  76.             and drop a PostScript file over the ghost icon and GS will
  77.             automatically display that file.
  78.  
  79.         2.  Edit the file "fontmap" so that GS uses the .pfb fonts in your
  80.             \psfonts directory.  For example, append the line
  81.  
  82.                 /Helvetica    (d:/psfonts/helv.pfb);
  83.  
  84.             to the end of the file fontmap, and GS will use d:/psfonts/helv.pfb
  85.             whenever it needs the Helvetica font.  For your convience,
  86.         a file called fontmap.tail is included with this archive.  If
  87.         you append fontmap.tail to the end of fontmap, GS will use
  88.         all of the ATM fonts that came with OS/2 2.0.  Fontmap.tail
  89.         assumes that the ATM fonts are in the d:\psfonts directory.
  90.  
  91. Remember, use forward slashes to separated directories - ie, use 
  92. "(/apps/gs/tiger.ps) run" to preview the file 'tiger.ps'.
  93.  
  94.  
  95. Known Problems:
  96.  
  97. 1.  When using the 256 color mode, some windows' colors are all wrong.  This
  98.     is because these programs do not handle the WM_REALIZEPALETTE message
  99.     correctly.  Solution: don't use these programs, or use the 16 gray scale
  100.     mode of the gspm25.
  101.  
  102. 2.  When using the 256 color mode, if a dialog box covers the drawing
  103.     window and then is removed, the area under the dialog box contains the
  104.     wrong colors.  This is a bug related to the palette management of OS/2.
  105.     In short, PM redraws the area under the dialog box (or pull down menu),
  106.     but draws it incorrectly when the physical palette has been changed.
  107.     In contrast, the application is responsible for redrawing areas that
  108.     where covered by other windows and then exposed.  Solution: minimize
  109.     and then restore the drawing window.
  110.  
  111. 4.  When using the 256 color mode, if you run another program that calls the
  112.     WinRealizePalette function, or if you run a full screen dos program and
  113.     then return to the OS/2 desktop, the drawing window no longer redraws
  114.     with the correct colors.  This is because a) only the window that has
  115.     the input focus will have its palette realized absolutely, and b) there
  116.     is a bug in the function GpiBitBlt when using non-default physical
  117.     palette.  Solution: use the 16 gray scale mode of the gspm25.
  118.  
  119. If you want to report a problem, include a detailed description of your
  120. system.
  121.  
  122.  
  123. --------------------------------------------------------------------------
  124. Jim Yang
  125. jyang@daedalus.caltech.edu
  126.  
  127.