home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / program / d / filepoll / ReadMe < prev   
Encoding:
Text File  |  1992-05-31  |  2.8 KB  |  56 lines
  1.  FilePoll 0.02
  2.  -------------
  3.  
  4.  FilePoll is hot on the heels of StartUp and performs a related function, it
  5. polls the wimp while loading a file.
  6.  
  7.  This is the spin off from something else I'm trying to write, to poll the
  8. wimp during all loads, which means patching the OS_File vector, but you have
  9. all sorts of problems with re-entrancy, eg. RMLoad will call OS_File, which
  10. if you start polling other tasks while loading the module, and another task
  11. calls RMLoad aswell then all sorts of nasties can happen, never mind what
  12. state the RMA is in during a RMLoad. I hope to get away with only polling
  13. the wimp if OS_File is called from User mode, which should mean the app
  14. itself made the call, though the things you want to have polling, like
  15. loading sprite areas is disabled ! I'm telling you all this so you can go
  16. away and think about it aswell !!!!
  17.  
  18.  Anyway, what FilePoll does it emulate the loading/calling of a absolute
  19. file, reading in chunks and polling the wimp. It only copes with files with
  20. a Absolute filetype, it won't cope with any other filetype, infact it
  21. ignores the filetype and just treats the given file as absolute. The size of
  22. the chunk read in at a time is either &400 or filesize/32, whichever is
  23. larger You may like you change the code to give bigger/smaller chunks, I
  24. think filesize/32 is about right though.
  25.  
  26.  FilePoll has to have somewhere to exist while it loads the absolute file,
  27. so it reads the length of the file and moves itself to above where the file
  28. will end up, this means that slightly (and I mean slightly, only a couple of
  29. hundred bytes) more memory is required, this should be catered for by the
  30. page size steps, but if not add a 1 to the wimpslot (you'll get a Abort on
  31. data transfer if there isn't space).
  32.  
  33.  You call the thing by /FilePoll -<fsp>, so it's best to have it in your
  34. library, the fsp being the absolute file, so for a !Run file you just have
  35. to change the Run <Obey$Dir>.!RunImage to /FilePoll -<Obey$Dir>.!RunImage.
  36. The enviroment string is altered before the actual absolute code is called
  37. and Obey$Dir is preserved, so the absolute code shouldn't notice anything
  38. different.
  39.  
  40.  I can't think off hand of anything objecting to FilePoll, but you never
  41. know, if a app doesn't like it then just put the old plain Run back in.
  42.  
  43.  Remember to check that the file you are running is a absolute file,
  44. FilePoll assumes it is !
  45.  
  46.  For bootup purposes it's best to keep !Run as normal and have a !RunPoll
  47. which calls FilePoll and run that on bootup instead of the normal !Run,
  48. which is when you really should use FilePoll.
  49.  
  50. (c)1992 G.W.Babb
  51.  
  52. Normal copyright stuff applies, you can distribute where you want aslong as
  53. it isn't for profit. You must distribute as-is, though the source is
  54. included for your enjoyment, which you may expand upon and distribute as you
  55. please.
  56.