home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / QBAS / SMALLFNT.ZIP / SMALLFNT.DOC < prev   
Text File  |  1990-02-15  |  3KB  |  65 lines
  1.               SmallFont  Copyright (c) 1990  Thomas G. Hanlin III
  2.  
  3.  
  4.  
  5.  
  6. The SmallFont routines are protected by copyright.  However, you may use them
  7. in your own programs free of charge.  The SmallFont collection may be
  8. distributed under the following conditions:
  9.  
  10.    1) All original files are included: CREATE.BAT, EXAMPLE.BAS, EXAMPLE.TXT,
  11.       MAKELIBS.BAT, SMALLFNT.BAS, SMALLFNT.BI, and SMALLFNT.DOC.
  12.  
  13.    2) No fee of over $10.00 may be charged for distribution.  This applies
  14.       specifically to physical copies and is not meant to prevent
  15.       distribution by telecommunications.
  16.  
  17. These routines are designed for use with QuickBASIC 4.x and/or BASCOM 6.x.
  18. They allow you to display small characters in CGA hi-res graphics mode
  19. (SCREEN 2), giving you a screen size of 106x33.  This gives you 75% more
  20. space to play with and can be useful for occasions when you need to squeeze
  21. text into a small area of the screen.
  22.  
  23. The displayed characters are indeed small, but reasonably legible.  Lowercase
  24. characters are not supported and will be converted to their uppercase
  25. equivalents.  Most of the normal symbols are supported, but graphics
  26. characters are not.  The control codes 13 (carriage return), 10 (linefeed),
  27. and 8 (nondestructive backspace) are supported.  Like the normal PRINT
  28. statement, going past the right edge of the screen causes wrapping to the
  29. next line, and going past the bottom of the screen causes scrolling.  The
  30. print speed is reasonably quick even on a 4.77 MHz XT, although scrolling is
  31. a bit on the slow side.
  32.  
  33. The provided MAKELIBS.BAT file will convert SMALLFNT.BAS into SMALLFNT.LIB
  34. and SMALLFNT.QLB files, which are libraries that you can use either from the
  35. command-line compiler or within the QuickBASIC environment.  You may need to
  36. modify the "BQLB45" to "BQLB41" or "BQLB40", depending on which version of
  37. QuickBASIC you are using.  If you have not set up a PATH to your BASIC
  38. compiler and a LIB setting for your library files, you must execute MAKELIBS
  39. in the subdirectory in which your BASIC compiler is stored.
  40.  
  41. The CREATE.BAT file compiles the EXAMPLE.BAS program and links it with the
  42. SmallFont library that was created by MAKELIBS.  Look at CREATE.BAT and
  43. EXAMPLE.BAS to see how they work.
  44.  
  45. To use SmallFont routines with your program, all you need to do is INCLUDE
  46. the SMALLFNT.BI file at the top of your program (this declares the SmallFont
  47. routines for you) and link in the SmallFont library.  If you are using the
  48. QuickBASIC environment, specify the library when you start up:
  49.    QB /L SMALLFNT
  50.  
  51. You must also DIMension an integer array in which the font will be stored:
  52.    DIM SmallFont%(0 TO 320)
  53.  
  54. The following routines are provided:
  55.  
  56.    InitSmallFont SmallFont%()
  57.    SmallPrint SmallFont%(), Text$
  58.    SmallLocate SmallFont%(), Row%, Column%
  59.  
  60. InitSmallFont loads the small font from SMALLFNT.DAT.
  61. SmallPrint displays a string.  Add CHR$(13)+CHR$(10) to the string if you
  62.    want a carriage return and linefeed, since this is not automatic.
  63. SmallLocate sets the cursor position.  The row may be 1-33 and the column may
  64.    be 1-106.
  65.