home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast2.iso / sprint / spfonts.zip / SPFONT.SPR (.txt) < prev    next >
Sprint Document  |  1989-06-27  |  11KB  |  207 lines
  1. R 75,T 5
  2. HEADINGB What is SPFONT?
  3. SPFONT uses the graphics mode of a CGA or Hercules Graphics Card (models
  4. GB101,GB102) to display characters of different fonts (bold, italic, etc.)
  5. when using Borland's Sprint.  As well, the Hercules version displays 43
  6. lines of 90 columns, almost double the number of characters displayed in 25
  7. by 80 mode.
  8. HEADINGC New in SPFONT v0.3f
  9. SPFONT v0.3f has added a number of new features:
  10. BEGIN HYPHENS, Spread 0
  11. A version using characters that are 12 dots high giving 29 lines by 90
  12. columns on Hercules displays.
  13. SPFONT can be "uninstalled" from the DOS command line.
  14. Cursor handling enhancements, settable from the DOS command line or from
  15. within a Sprint macro.
  16. END HYPHENS
  17. HEADINGB Installing SPFONT
  18. SPFONT is available in three different versions:
  19. BEGIN ASTERISKS
  20. SPFONT25.COM displays 25 lines by 80 columns (using 8 dot high characters)
  21. on a CGA.
  22. SPFONT29.COM displays 29 lines by 90 columns (12 dot characters) on a
  23. Hercules adapter.
  24. SPFONT43.COM displays 43 lines by 90 columns (8 dot characters) on a
  25. Hercules adapter.
  26. END ASTERISKS
  27. The symbol 
  28. SPFONTnn
  29.  = 25, 29 or 43) will be used to specify the
  30. particular version of SPFONT that the user is interested in installing.
  31. HEADINGC The Distribution Files
  32. Compuserve's BORAPP LIB 16 contains four SPFONT files.  All are in packed
  33. format to minimize download time.  Borland's UNPACK program, available on
  34. Sprint Disk #3, can be used to unpack the files.
  35. The four files are:
  36. BEGIN DESCRIPTION
  37. SPFNT1.ARC@/contains SPFONT29.COM, SPFONT43.COM (both for Hercules)
  38. SPFONT29.SPS and SPFONT43.SPS.  These are the only files needed to run
  39. SPFONT.  SPFNT1 also contains two Sprint documents: SPFONT.SPR, which is
  40. this documentation file that you are reading, and FONTS.SPR, a sample file
  41. that displays all characters in each font.
  42. SPFNT2.ARC@/contains SPFONT25.COM (for CGA), SPFONT25.SPS, SPFONT.SPR and
  43. FONTS.SPR.
  44. SPFNT3.ARC@/contains SPFONT8.FNT, SPFONT12.FNT, SPFONT.SPL, SPFONTED.EXE,
  45. SPFONTLD.EXE.  These files allow you to modify the character shapes and
  46. incorporate those changes in your copy of SPFONTnn.COM.  I have to
  47. apologize; some of the fonts (bold, italic & bold-italic) where "built"
  48. from the Plain font by computer program.  For other fonts (Large, Sub- &
  49. Superscript), I have not entered all the characters.  I would hope that
  50. someone who enjoys font design would download SPFNT3 and clean-up the
  51. fonts.
  52. SPFNT4.ARC@/contains SPFONT.ASM, SPFONT.MAK, SPFONTED.C and SPFONTLD.C. 
  53. These are the sources for SPFONT and the utilities for anyone who wants to
  54. extend or improve SPFONT.  The programs are written in TurboC and Turbo
  55. Assembler.
  56. END DESCRIPTION
  57. HEADINGC Command-Line Options
  58. SPFONT has the follwing command line options:
  59. BEGIN DESCRIPTION
  60. /i@/Install.  This argument is required for SPFONT to install itself in
  61. memory.  If /i is not specified, SPFONT will print a quick summary of
  62. options and will return to DOS without doing anything.
  63.  The Hercules version of SPFONT verifies that a Hercules graphics card
  64. exists before installing itself.  If one cannot be found, SPFONT will print
  65. a diagnostic message and return to DOS without installing itself.  If a
  66. Hercules card is found, then when SPFONT is "active" (in Sprint) SPFONT
  67. will configure the card for "HALF" operation; that is, only one graphics
  68. page is used and SPFONT can work in systems that have both Hercules & CGA
  69. cards connected.  Outside of Sprint, the card is reprogrammed for "TEXT"
  70. operation only.
  71. /u@/Uninstall.  If SPFONT is the last TSR (Terminate-and-Stay-Resident)
  72. program loaded and no other programs have stolen away the video & timer
  73. interrupt vectors used by SPFONT, then /u will cause SPFONT to remove
  74. itself from memory.  The /i and /u options are most often used in a batch
  75. file to load SPFONT just before Sprint and to remove SPFONT after Sprint is
  76. finished.
  77. /p@/Plain font only.  SPFONT contains 8 font tables at 2K each plus about
  78. 2K of its own program code, for a total of 18K.  Users who only want to use
  79. SPFONT for its 43*90 display can request that SPFONT install only the plain
  80. font in memory, thereby saving over 12K of precious memory.  Any requests
  81. to print a character in a font other than plain will print the character in
  82. reverse video.
  83. /b@/Blink off.  Sprint will start with a non-blinking cursor.  This option
  84. is most useful with laptop computers where the visibility of the cursor
  85. depends on the bightness & contrast settings of the display.
  86. /k@/Block cursor.  Sprint will start with a block cursor.
  87. /a@/Adjust cursor size.  Most macros (including the BlockCursor and
  88. ULCursor in the standard Glossary of Sprint v1.01) are written to recognize
  89. to types of display: CGA, with 8 dot high characters, and MDA/EGA, with 14
  90. dot high characters.  To most of these macros, SPFONT looks like a CGA
  91. screen even when running on a Hercules.  When used with the 12 dot high
  92. characters of SPFONT29, commands to change the cursor size end up either
  93. making a cursor of the wrong size, putting the cursor in the wrong place,
  94. or both.  The /a option allows SPFONT to adjust cursor size changes for the
  95. CGA to values that make sense for the 12 dot high font.
  96. END DESCRIPTION
  97. HEADINGC Recommended Installation
  98. Put the two files SPFONTnn.COM and SPFONTnn.SPS in your \SPRINT directory
  99. and make sure that your PATH statement contains "C:\SPRINT".
  100. To your AUTOEXEC.BAT file, add the line:
  101.     SPFONTnn /i /a
  102. If you do not already have a batch file that calls up Sprint, make the file
  103. SF.BAT in your \SPRINT directory containing the line:
  104.     sp -s=SPFONTnn %1 %2 %3 %4 %5 %6 %7 %8 %9
  105. Installing SPFONT once from the AUTOEXEC.BAT file saves time at the expense
  106. of having SPFONT lie around in memory when not in use.  If you would rather
  107. save memory, make the following SF.BAT file in your \SPRINT directory:
  108.     SPFONTnn /i
  109.     sp -s=SPFONTnn %1 %2 %3 %4 %5 %6 %7 %8 %9
  110.     SPFONTnn /u
  111. HEADINGC Important Note
  112. Sprint versions 1.00 and 1.01 have a problem after printing, paginating or
  113. doing a screen preview when SPFONT is active.  The editor passes the name
  114. of the SPFONT screen driver to the formatter, but the formatter forgets to
  115. pass it back when it returns to the editor!  So after any print operation
  116. the screen reverts to normal text mode.
  117. To prevent this situation from happening, press F10/Utilities/Macro/Enter
  118. then enter the line:
  119.     34->parg ovlwrite "%"
  120. and (E)xecute the macro.  This will prevent the formatter from overlaying
  121. the editor during printing to that the editor will remember reactivate
  122. SPFONT after printing.  This change will stay in the SP.OVL file until you
  123. select a new User Interface.
  124. HEADINGB Using SPFONT
  125. If you made one of the SF.BAT files as recommended above, then you can
  126. start Sprint by typing SF instead of SP.  Only when editing documents or
  127. printing a Screen Preview will the screen stay in 29 or 43 line mode.  If
  128. you execute a DOS command with F10/Utilities/DOS Command, SPFONT will
  129. revert back to the display's standard 25 line mode while the command
  130. executes.
  131. HEADINGC Manipulating the Cursor
  132. Sprint macros can be used to change the cursor in three ways:
  133. BEGIN ASTERISKS
  134. Enable/Disable blinking.  The following macro will toggle the blinking
  135. state of the cursor:
  136.     ToggleBlink:
  137.         (hardware "2>al 16 int 10h" ^ 1) hardware ">al 16 int 10h"
  138. Change its size.  The BlockCursor and ULCursor Glossary entries can be used
  139. to change the size of the cursor.  It is also possible to write macros to
  140. indicate the current insert/overwrite mode via the cursor's size.
  141. Display a 
  142.  cursor!  This feature was put in for the benefit of users
  143. who like the 43 line display but have trouble locating the cursor.  SPFONT
  144. contains a function that will turn the cursor into a huge "cross" that
  145. inverts all characters in the same row and same column as the normal
  146. cursor.  (It really has to be seen to be believed!)  The following macro,
  147. which assigns itself to the Alt-Shift-C key sequence, will blink the huge
  148. cursor 5 times and then revert back to normal.
  149.     FindCursor :
  150.         hardware "1>al 16 int 10h" int oldblink    ; turn on blink
  151.         hardware "1>al 17 int 10h" int oldcross    ; make huge cursor
  152.         2200 wait                            ; time for 5 blinks
  153.         oldcross hardware ">al 17 int 10h"        ; restore cursor shape
  154.         oldblink hardware ">al 16 int 10h"        ; restore blink
  155.     ~c : FindCursor                        ; assign to Alt-Shift-C
  156. END ASTERISKS
  157. HEADINGB SPFONT and TSRs
  158. Since SPFONT puts the screen into graphics mode to do its work,  not all
  159. TSR (Terminate-and-Stay-Resident) programs can safely "pop-up" and restore
  160. the display to its original settings when finished.
  161. Two solutions are available.  First, you can press F10/Utilities/DOSCommand
  162. and enter no command, which will deactivate SPFONT mode and call up a copy
  163. of DOS.  AT this point it is safe to press the "hotkey" for your TSR. 
  164. After your are finished with you TSR, type "exit" and Sprint will restore
  165. the display.
  166. The second solution is to enter the follwing macro, compile it and assign 
  167. SafeToHotkey to a key.  Whenever you want to call up a TSR, press the key
  168. that will execute SafeToHotkey first.
  169. SafeToHotkey :
  170.   hardware "254>al 0 int 10h"        ; out of SPFONT
  171.   rawout "Press any key to return to Sprint ...\n"
  172.   GetKey
  173.   hardware "255>al 0 int 10h"        ; back into SPFONT
  174.   redraw draw                    ; and refresh the screen
  175. HEADINGB Editing SPFONT.FNT
  176. The program SPFONTED is a simple, but usable, font editor for modifying the
  177. supplied font file.  Just type
  178.     SPFONTED SPFONThh.FNT
  179. (where hh = 8 or 12, depending on which font file you want to edit) and
  180. follow the information given onscreen.  SPFONTED will allow you to save a
  181. modified font file under a different name so that you can experiment making
  182. different fonts without burning your bridges behind you.
  183. To "load" a modifed font file into the working SPFONT program, type the
  184. command
  185.     SPFONTLD <comfile> <fontfile>
  186. For example,
  187.     SPFONTLD SPFONT29.COM SPFONT12.FNT
  188. will update the SPFONT29.COM program with a new copy of the SPFONT12.FNT
  189. file.  The next time that you run SPFONT29 /i the new fonts will be
  190. available in memory.
  191. HEADINGB Modifying SPFONT
  192. The file SPFNT4.ARC contains the sources to SPFONT, SPFONTED and SPFONTLD
  193. programs.  SPFONT can be regenerated with the command
  194.     MAKE -fSPFONT.MAK
  195. whereas the font editor & loader programs can be recompiled with
  196.     TCC SPFONTED.C
  197. or    TCC SPFONTLD.C
  198. The source and executable programs are supplied AS IS without any
  199. warranties of any kind (this is usual disclaimer although these programs
  200. are a reflection of my personal & professional reputation).
  201. HEADINGB For more information
  202. If you have any questions, comments or suggestions for improving SPFONT,
  203. please don't hesitate to contact me.  (On the other hand, if you have
  204. scathing criticisms, please take your time!)
  205. Andrew D. Morrow[Android]
  206. Compuserve 73627,2165
  207.