home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / f / fmonitor.zip / FMONITOR.DOC < prev    next >
Text File  |  1988-12-14  |  9KB  |  196 lines
  1. ==============================================================================
  2. FMONITOR  --  FontMonitor Documentation   Version 1.03   December 14, 1988
  3. ==============================================================================
  4.  
  5. PURPOSE.
  6. --------
  7.  
  8. FMONITOR is designed to work with DESQview, WordPerfect 5.0, and the
  9. Hercules Graphics Card Plus when using the RamFont feature.  As you switch
  10. back and forth between DESQview windows with WordPerfect running in one of
  11. them with the RamFont option selected, FMONITOR keeps track of the mode
  12. required for the HGC+ card and changes it accordingly.  This way most
  13. screens are in the proper mode.  There will be some cases when using less
  14. than full screen windows that it is not possible to put the HGC+ in a mode
  15. that satisfies all windows.
  16.  
  17. INSTALLATION.
  18. -------------
  19.  
  20. FMONITOR must be installed.  The file FMONITOR.ARC contains the following
  21. files:
  22.          FMONITOR.COM ...... the executeable code
  23.          FM-PIF.DVP ........ the DESQview PIF for FMONITOR
  24.          FMONITOR.DOC ...... this file
  25.          FMONITOR.ASM ...... source code
  26.          W5-PIF.DVP ........ sample PIF for WordPerfect 5.0
  27.  
  28. Un-arc the files and copy FM-PIF.DVP to your DESQview sub-directory.  Copy
  29. FMONITOR.COM to whichever sub-directory you want. Suggest you put it in
  30. your DV, WP, or HERC sub-directory.
  31.  
  32. FMONITOR PIF.
  33. -------------
  34.  
  35. With DESQview loaded open an 'Add Program' window, select 'Other', enter
  36. your DV sub-directory and select FMONITOR from the resulting list.  Then
  37. open a 'Change Program' window and enter FM for FMONITOR.  On the
  38. 'Program' line either delete the path preceding FMONITOR.COM or put in the
  39. correct sub-directory.  You will need to edit the 'Parameter' line to
  40. correctly reflect the name and location of your PIF for WordPerfect 5.0.
  41. Make sure to leave the second parameter, '5' on that line.  The second
  42. parameter must be separated by one and only one space from the WP PIF
  43. name.  The third parameter must be either '2' or '3' depending on which of
  44. the WordPerfect fonts you want to use.  The number corresponds to the menu
  45. option for fonts in WordPerfect which are accessed through <Shift-F1>DC.
  46. '2' corresponds to 12 x 256 character fonts and '3' to 6 x 512 characters.
  47. In turn these options load the font files HRF12.FRS and HRF6.FRS
  48. respectively.  The fourth parameter must be either 'Y' or 'N' depending on
  49. whether you want FMONITOR to open the WordPerfect window or not.  If you
  50. use 'Y' then when you open FM it will also open WordPerfect.  If you use
  51. 'N', then you must have WordPerfect loaded, in the foreground, and zoomed
  52. to full screen when you open FM.  In summary here is the syntax for using
  53. FMONITOR:
  54.  
  55.        Syntax:   FMONITOR pif_filespec hgc_mode font_file open_win
  56.                                       ^        ^         ^
  57.                              (must have 1 and only 1 space at these points)
  58.  
  59.        where pif_filespec is the d:\path\xx-PIF.DVP for the main application
  60.        being monitored and hgc_mode is the HGC+ mode you want the application
  61.        to use.  The hgc_mode numbers are the XMODEREG numbers from page 70
  62.        of the HGC+ manual.  WordPerfect uses hgc_mode 5.  The font_file is
  63.        either 2 or 3 corresponding to the option numbers on the WP menu.
  64.        Font_file 2 is the 12 x 256 character file, HRF12.FRS.  Font_file 3
  65.        is the 6 x 512 character file, HRF6.FRS.  Open_win is either Y or N
  66.        (you must use upper case) where Y means that FM will open the WP
  67.        window.  N means that FM will not open WP window and FM must be
  68.        opened when WP is zoomed to full screen and in the foreground.
  69.  
  70. The 'Directory' entry may be blanked if you included the path in
  71. the 'Program' line.  Otherwise put in the correct sub-directory for the
  72. location of FMONITOR.COM.  If you want to change the name of the FMONITOR
  73. window from FM to something else, you may do that.  Don't change any of
  74. the other settings.
  75.  
  76. WORDPERFECT PIF.
  77. ----------------
  78.  
  79. Recommend you set the 'Starting Height' to 25 and 'Starting Width' to 80
  80. in your WordPerfect PIF.  FMONITOR works best when WordPerfect is using
  81. the full screen.  If you are using the graphics capability within
  82. WordPerfect (e.g. View Document, or importing graphics), then don't forget
  83. to set the 'Display Graphics Information' to 'yes'.  Otherwise the
  84. graphics information will not be saved when you switch away from
  85. WordPerfect.  You must also include the complete path to WP.EXE, HRF12.FRS
  86. and HRF6.FRS in the 'Program' field of the WordPerfect PIF.  For example:
  87. d:\path\WP.EXE.  A W5-PIF.DVP file is included in the FMONITOR.ARC as an
  88. example.  CAUTION: Don't get this PIF mixed up with your own.
  89.  
  90. USAGE.
  91. ------
  92.  
  93. As explained above there are two basic operating modes for FMONITOR.  They
  94. are selected by using 'Y' or 'N' for the open_win parameter.
  95.  
  96. The 'Y' option.
  97. ---------------
  98.  
  99. With DESQview loaded and WordPerfect not loaded, open FM (or whatever you
  100. have changed the name).  FM will load in a very small window (3k) and
  101. automatically load WordPerfect.  Now when you switch away from WordPerfect
  102. to a window using normal text, the HGC+ mode will change if the current
  103. window covers the upper left corner of the screen.  When you switch back
  104. to WordPerfect, the mode will change to RamFont.  This also works if you
  105. switch to a window using a graphics mode and back.  With this option you
  106. should have selected one of the RamFont modes in the WordPerfect menu and
  107. exited from WordPerfect in this mode so it is saved before you try to use
  108. WordPerfect with FMONITOR.
  109.  
  110. The 'N' option.
  111. ---------------
  112.  
  113. With WordPerfect opened in DESQview, zoomed to full screen and in the
  114. foreground make sure it is in the correct RamFont mode.  Then open FM.  It
  115. will immediately start monitoring to keep the various applications in the
  116. correct HGC+ mode.
  117.  
  118. After you have exited from WordPerfect, don't forget to close the FM
  119. window.
  120.  
  121. HOW DOES IT WORK?
  122. -----------------
  123.  
  124. The Hercules Graphics Card Plus has some pseudo-modes for the various
  125. RamFont text modes.  Normally DESQview detects the mode for each window
  126. and saves this parameter before it switches away.  Unfortunately, the HGC+
  127. has registers that are involved with the RamFont modes that can not be
  128. read to determine its state.  Therefore DESQview by itself can not make
  129. automatic mode changes to and from RamFont modes.
  130.  
  131. Through the use of the DESQview Applications Program Interface (API) which
  132. is built into DESQview, FMONITOR keeps track of which window covers the
  133. upper left corner of the screen (0,0).  FMONITOR assumes WordPerfect is
  134. using RamFont mode 5 which is the '48k RamFont text, 9 dot wide, 48k
  135. RamFont text attribute' mode of the HGC+.  (The other RamFont modes will
  136. be found on page 70 of the HGC+ manual.  They are numbered 0..7.)  If the
  137. window at 0,0 is WordPerfect, FMONITOR sends the appropriate commands to
  138. the HGC+.  If the window at 0,0 is in normal text mode, FMONITOR changes
  139. HGC+ to normal text, which is RamFont mode 0.  If the window at 0,0 is in
  140. a graphics mode, FMONITOR doesn't do anything since DESQview automatically
  141. changes the mode.
  142.  
  143. If you are in a graphics window and switch back to WordPerfect, then the
  144. mode of the HGC+ is changed as before and the RamFonts are reloaded. The
  145. reason for this is that the RamFonts use the same video buffer space to
  146. store the fonts as the graphics mode uses for its pixels.  Since DESQview
  147. does not know about RamFonts, DV does not save this video buffer space (even
  148. if you have WordPerfect PIF set to 'Displays Graphic Information').
  149. Therefore when you switch from a graphics window to WordPerfect the
  150. RamFonts must be reloaded.  FMONITOR must be able to find the font files
  151. so they must be in the same sub-directory as WP.EXE.
  152.  
  153. Don't forget FMONITOR will put the HGC+ in whatever mode is appropriate
  154. for the window that covers the 0,0 location on the screen.
  155.  
  156. If you are using DESQview 2.2, then the 'Share CPU when foreground' must
  157. be set to 'Y' for all windows that you want monitored.  Otherwise FMONITOR
  158. can not run in background when an application that is not sharing CPU is
  159. in the foreground.
  160.  
  161. APPLICATIONS OTHER THAN WORDPERFECT.
  162. ------------------------------------
  163.  
  164. Although FMONITOR is set up specifically for working with WordPerfect,
  165. there is no reason you can not use FMONITOR with any program that uses
  166. RamFont text mode in DESQview.
  167.  
  168. xMONITOR SERIES.
  169. ----------------
  170.  
  171. The author intends to write other xMONITOR programs for non-DV
  172. applications that are running in DESQview.  These xMONITOR programs will
  173. provide DESQview capabilities to applications that were not written
  174. specifically to operate in DESQview.  For example another one is CMONITOR
  175. for use with RBBS and other BBS systems.  It will monitor the carrier.  If
  176. there is a loss of carrier, the RBBS window will be closed and reopened to
  177. restart RBBS without having to re-boot the entire system.
  178.  
  179.  
  180. COPYRIGHT.
  181. ----------
  182.  
  183. FMONITOR and the xMONITOR series are copyrighted by John Poindexter 1988.
  184.  
  185. John Poindexter
  186. SIG004 The SOURCE
  187. December 14, 1988
  188.  
  189. UPDATE HISTORY.
  190. ---------------
  191.  
  192. 1.01      First public release.
  193. 1.02      Improved performance in testing for graphics mode and loading of
  194.           fonts.
  195. 1.03      Fixed problem when FMONITOR is last window to be closed.
  196.