home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 294.lha / Bag_v1.0 / README < prev   
Encoding:
Text File  |  1989-10-08  |  2.3 KB  |  65 lines
  1.         BAG 1.0 - a Better ActivateGadget Patch Routine
  2.  
  3.             Written by Justin V. McCormick 89-09-26
  4.       Placed in the Public Domain - Freely Redistributable
  5.  
  6. Synopsis:
  7. ---------
  8.   BAG (BetterActivateGadget) is a tiny patch for the Intuition
  9. ActivateGadget() function.  After you install BAG, normal calls
  10. to the ActivateGadget() function will be redirected through the
  11. new BAG function.  This is similar to the way FastFonts improves
  12. text output by changing the Graphics library Text() function.
  13.  
  14. Reasons to use BAG:
  15. -------------------
  16.   With a fast CPU installed you may find that string gadgets act
  17. unreliable.  This problem is especially noticable with small
  18. windows containing string gadgets.  Many programs do not provide
  19. sufficient delay after a new Window opens before calling
  20. ActivateGadget().  This will cause the string gadget to be
  21. activated in an unpredictable manner.
  22.  
  23. Theory of Operation:
  24. --------------------
  25.   BAG modifies the behavior of ActivateGadget() so that up to
  26. five tries will be made before aborting the activation request.
  27. Between each unsuccessful attempt, a short time delay (i.e.,
  28. busy wait) occurs, giving Intuition a chance to finish the
  29. Window or Requester rendering or refresh and unlock the layers.
  30. The boolean return from ActivateGadget() is used to determine
  31. when the activation is successful.  The operation of the patch
  32. function is otherwise identical to the normal ActivateGadget()
  33. function, and should be transparent in use.
  34.  
  35. Installation:
  36. -------------
  37.   BAG should be placed in your C:  or other utility directory.
  38. BAG can be run from the CLI, Workbench, or launched from your
  39. startup-sequence after SetPatch:
  40.  
  41.     BAG >NIL:
  42.  
  43. This way you can silently install BAG every time you boot your
  44. Amiga.  Once BAG is installed, it can be removed by simply
  45. running the program again.  BAG only consumes 56 bytes of memory
  46. when installed and in no way interferes with the normal
  47. operation of ActivateGadget(), so you should not need to remove
  48. BAG under normal situations.
  49.  
  50. Note:  BAG only applies to Kickstart V1.2/1.3, since earlier
  51. versions of Intuition did not have the ActivateGadget()
  52. function.
  53.  
  54. I welcome discussion, comments, criticism, and code
  55. contributions.  Give me a call or drop me a line!
  56.  
  57.     Justin V. McCormick
  58.     8330 E. Quincy Ave., #C-312
  59.     Denver, CO 80237
  60.  
  61.       BIX: jmccormick
  62.     PLINK: JVM
  63.       VOICE: 303-290-8429
  64.  
  65.