home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 14 / CDACTUAL.iso / cdactual / demobin / share / program / c / XMS11.ZIP / README.TXT next >
Encoding:
Text File  |  1990-08-31  |  3.9 KB  |  87 lines
  1. -------------------------------
  2. Turbo C++ XMS Interface Library
  3. by Richard Vuduc
  4. Version 1.1
  5.  
  6. Copyright 1990, Richard Vuduc
  7. -------------------------------
  8.  
  9. Well, I'm glad to see you followed directions and are now
  10. 'reading.me'.  Here's a list of files included in this package
  11. (XMSCPP11.ZIP):
  12.  
  13.     - XMSCPPS.LIB       // Turbo C++ linkable routines for accessing
  14.                            extended memory (small model).
  15.     - XMSCPPL.LIB       // Turbo C++ linkable routines for accessing
  16.                            extended memory (large model).
  17.     - XMSHRW.CPP        // Src for Get/Store routines (XMSHandle)
  18.     - XMS.H             // Turbo C++ XMS header file
  19.     - XMSHNDL.H         // XMSHandle Class Header file
  20.     - README.TXT        // That would be this file
  21.     - XMSCPP.TXT        // Documentation on how to use the library
  22.     - XMSDEMO.CPP       // Library demonstration program source code
  23.     - XMSDEMO.EXE       // Library demonstration executable
  24.     - XMSDEMO2.CPP      // Demonstration file 2 (XMSHandle Class)
  25.     - XMSDEMO2.EXE      // Demonstration file 2 executable
  26.  
  27. Hardware and Software Requirements:
  28. -----------------------------------
  29. You need a 286 or above IBM AT compatible, enough conventional memory
  30. to run the Turbo C++ compiler, and 64k of extended memory to run the
  31. first demonstration program (XMSDEMO.EXE).  The 2nd demo program
  32. (XMSDEMO2.EXE) has the same requirements.
  33.  
  34. You also need to install HIMEM.SYS.  I haven't worked out any
  35. distribution agreements with Microsoft, but you can get it from them
  36. in HIMEM.ARC on MSSYS on CompuServe.  HIMEM is also bundled with
  37. Microsoft Windows 286 and MS Windows 3.0 (I don't know about Windows
  38. 386, but I imagine it's in there, too).
  39.  
  40. Usage:
  41. ------
  42. You can reach me about any technical problems or any comments on 
  43. improvements at my CIS Account: Richard Vuduc, 70022,1332.
  44.  
  45. To link this library with your programs, just type:
  46.    'tcc -mz xxxxx.cpp xmscppz.lib'
  47.           ^                 ^
  48. Notice that I've marked that 'z' in 'xmscppz.lib' and '-mz'.  You 
  49. should replace this 'z' with the letter that corresponds to the 
  50. correct library model (currently, the (s)mall and (l)arge models are
  51. supported.  I hope to get the other models, and the source, out
  52. real soon now.  The demo programs were compiled in the small
  53. model).
  54.  
  55. So, to compile the demonstration program, just type:
  56.     'tcc -ms xmsdemo.cpp xmscpps.lib'  <== for the small model
  57.     'tcc -ml xmsdemo.cpp xmscppl.lib'  <== for the large model
  58.  
  59. You can also link xmscpp[S|L].lib into the standard library.  See 
  60. the Turbo C++ manual for details.
  61.  
  62. I encourage you to give me any comments on the lib.  By doing that,
  63. you help ensure that I'll keep at it, with even BIGGER and GREATER
  64. things...  Also, there is NO fee, but any contributions to a
  65. starving, young programmer would be most appreciated.
  66.  
  67. To run the first demo, just type 'xmsdemo' and the program will go
  68. through a whole bunch of checks.  It will read from and write to 
  69. extended memory, and the High Memory Area.
  70.  
  71. To run the second demo, just type 'xmsdemo2.'  The program will fill
  72. three 4K blocks of extended memory with the letters 'a', 'b', and 
  73. 'c', and then display play them on screen.  After a screen has been
  74. filled with letters, strike any key to move on to the next screen.
  75. You will notice a slight delay while the program stuffs the extended
  76. memory blocks, but bear with it.  As a test, you can play around with
  77. the cache size (see source and documentation) and see the performance
  78. differences with the different sizes.
  79.  
  80. Things to Come...
  81. -----------------
  82. I hate to make this thing into vapor ware and spill the beans on my
  83. future plans, so I won't.  I still haven't added support for the
  84. Upper Memory Block functions HIMEM provides, and I know those are
  85. worth implementing.  If there's something else YOU'D like to see in
  86. this library, ASK FOR IT.
  87.