home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / progbas / baswind4.arj / BASWIN22.ZIP / READ.ME < prev    next >
Encoding:
Text File  |  1987-01-27  |  5.7 KB  |  128 lines
  1.  
  2.  
  3.                               Updates to BASWIND2
  4.  
  5.  
  6.  
  7.  
  8.  
  9. Version 2.2     January 24, 1987
  10.  
  11. CHANGES IN THIS RELEASE
  12.  
  13. Module SCROLL:
  14.  
  15. A minor fix to this module. The values of ULR and ULC are adjusted by decre-
  16. menting them by 1 at the beginning of the module to accomodate the zero ref-
  17. erence required by the DOS call. However, at two points in the program, a
  18. SCREEN function was used to determine screen attributes which used the mod-
  19. ified values of ULR and ULC without making allowance for this adjustment.
  20. This has been corrected in this release.
  21.  
  22. Also in this release the ARCHIVE file has been updated to include all the
  23. source code referenced in the previous 2.1 release, but which was inadvert-
  24. ently left out of that ARCHIVE. My apologies to all for this oversight.
  25.  
  26. Added to archive the source for DEMO1 as a means of demonstrating typical
  27. uses of the BASWIND2 routines.
  28.  
  29. --------------------------------------------------------------------------------
  30.  
  31. Version 2.1  December 10, 1986
  32.  
  33. CHANGES IN THIS RELEASE
  34.  
  35. Module NEWSCRN:
  36.  
  37. This module had the most serious problem - it would not work correctly with
  38. monochrome or Hercules cards. Blame this on me - I don't have a monochrome
  39. card so I never tested it. However, this version HAS been tested on a mono
  40. monitor and has been verified to work. As part of the fix, the names of the
  41. called procedures have been changed for SCRNSAVE and SCRNREST to SAVESCRN
  42. and RESTSCRN. This will insure that you don't inadvertently get the old
  43. versions linked into your corrected programs. Also, as shown in the new doc-
  44. umentation file included in this release, the calling convention is somewhat
  45. different. Now there are two integers to be passed in the CALL: the first
  46. tells the routine whether to test retrace status when using a color monitor
  47. to prevent snow, and the second passes the location of the first element in
  48. the array obtained by the VARPTR function. A typical call would be as follows:
  49.  
  50.                 10 DIM SCRNDATA%(2000):'4000 bytes, holds one screen
  51.                  .
  52.                  .
  53.                  .
  54.                  .
  55.  
  56.                 80 NOTEST%=0
  57.                 90 FIRST%=VARPTR(SCRNDATA%(0))
  58.                100 CALL SAVESCRN(NOTEST%,FIRST%)
  59.  
  60. The NOTEST% parameter is used primarily for the IBM CGA adapter. When you set
  61. this variable to 0, testing is forced; which will eliminate snow on the screen
  62. but will also slow down operation somewhat. Non-IBM color cards and the EGA do
  63. not require this testing, so if you set the variable to 1, testing will be
  64. bypassed and the screen writes will be as fast as possible. Regardless of the
  65. value of this variable, a monochrome system will be automatically detected and
  66. testing will be defeated since it is not required.
  67.  
  68.  
  69. Module MAKEWIND:
  70.  
  71. There have been no changes to this module; however, I have found that when the
  72. routine is compiled, it requires the /D switch on the compiler to generate
  73. error-checking code in order to work correctly. I discovered that when the /D
  74. option was omitted, when a 'growing' window was requested, the growing effect
  75. was not properly executed. Instead of growing from the center outward, it in-
  76. stead grew from the right-hand side to the left! I still don't know what is
  77. causing this, so for this reason I am including in this release the source
  78. code to this and the SCROLL modules so that you BASIC jocks that are more
  79. knowledgeable than I am can see what is going on and perhaps find the culprit.
  80. Adding the /D switch makes the size of the module considerably larger; so there
  81. is some benefit to leaving it off if the problem can be corrected. If anyone
  82. finds out what the problem is, please post me a message on Compuserve (ID #
  83. 72456,2325) or GEnie (Address: D.EVERS) and I'll spread the word around.
  84.  
  85. Module SCROLL:
  86.  
  87. No changes in this release.
  88.  
  89. Module USERLIB2:
  90.  
  91. This is an addition to this release of BASWIND. In the first release, I decided
  92. not to distribute a User Library form of these routines because of the fact that
  93. they required the presence of the USERLIB module distributed with QuickBASIC.
  94. Since I assume this module is copywrited by Microsoft, I chose to let the
  95. user create his own User Library at his end using his copy of USERLIB. However,
  96. a problem arose in that because of the fact that the MAKEWIND module was com-
  97. piled using the /D switch, it included some code linked in from the BRUN20.LIB
  98. module which made reference to the module ABSOLUTE. The problem was that
  99. USERLIB.OBJ also includes a module ABSOLUTE, which resulted in a Duplicate
  100. Module Name error occuring during the BUILDLIB procedure. As far as I was able
  101. to determine, this error was more of a warning nature than a severe one, as I
  102. simply ignored it and used the library anyway. (By the way, there are no calls
  103. to the module ABSOLUTE anywhere in BASWIND). However, this proved to be dis-
  104. turbing to many people (and rightly so); so I have taken a step of questionable
  105. legality by including in this package a module USERLIB2; which is the Quick-
  106. BASIC USERLIB.ASM edited to remove the ABSOLUTE procedure and reassembled. I
  107. don't really believe this presents much of an infringement problem; since
  108. everyone who buys QuickBASIC gets a copy of USERLIB and it is of no use to
  109. anyone without QuickBASIC. Anyway, using this USERLIB2 module instead of the
  110. original USERLIB will correct once and for all the Duplicate Module Name
  111. problem.
  112.  
  113.  
  114. I sincerely apologize for any inconvenience these problems might have caused
  115. anyone using BASWIND2; and I hope that these corrected programs solve any
  116. problems you might have. If not, please do not hesitate to leave me a note
  117. on Compuserve or GEnie; or to drop me a line at my home address given in the
  118. documentation file.
  119.  
  120.  
  121.  
  122. Thank you for your support,
  123.  
  124.  
  125. Dave Evers
  126.  
  127.  
  128.