home *** CD-ROM | disk | FTP | other *** search
/ Kosovo Orphans' Appeal Charity CD / KosovoOrphansAppeal.iso / commercialdemos / claresmicrosupplies / pca / flexlib / readme
Text File  |  1996-04-30  |  2KB  |  46 lines
  1. ReadMe.
  2. =======
  3.  
  4. This version of flex is designed to work with Acorn's Toolbox.
  5.  
  6.  
  7. It provides support for dynamic areas on the Risc Pc and allows a callback
  8. function to be registered, which will be called when a flex block moves.
  9. These changes were made by Andy Armstrong.
  10.  
  11. There is also support for the Virtualise module from Clares Micro Supplies.
  12. This module provides virtual memory for applications which use dynamic areas
  13. on the Risc PC. This support was added by David Jackson from Clares.
  14.  
  15. The main new call is.
  16.  
  17.  
  18. flex_initx(char * filename,int *msg,BOOL da,int maxsize,BOOL virtual)
  19.  
  20. This initialises flex and replaces flex_init.
  21.  
  22. the call flex_initx("fred",&msg,FALSE,-1,FALSE) is equivalent to the old flex_init("fred",&msg)
  23.  
  24. the extra parameter 'da' controls whether a dynamic area is to be used if
  25. available. If da is TRUE and you are not on a machine with dynamic areas,
  26. flex operates exactly as the original version.
  27.  
  28. The  extra parameter maxsize determines the maximum size to which the
  29. dynamic area can grow. It is important that you don't make this too big. You
  30. should let the user configure this. The Risc Pc has a limited address space
  31. (2Gb), and if several applications create areas which have a 256Mb maximum
  32. size, you soon run out of address space.
  33.  
  34. The final  extra parameter determines whether virtual memory is active on
  35. the area. If you create the area with VM off, you can activate virtual
  36. memory with 
  37.  
  38. flex_virtualstart()
  39.  
  40.  
  41.  
  42.  
  43. For details of the other calls, see flex.h and the Virtualise module
  44. documentation.
  45.  
  46.