home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / utilities / addsprites / AddHelp next >
Encoding:
Text File  |  1995-07-19  |  4.8 KB  |  106 lines
  1. <============================================================================
  2.                               A D D S P R I T E S
  3.                            Version 0.05, 20 May 1995
  4.                          © Andrew Clover of DoggySoft
  5. ============================================================================>
  6.  
  7.  
  8. ==> What's it all about?
  9.  
  10.  If you have designed your own sprites, or use a desktop new-look program
  11. such as NewLook, DeskPatch, or our own NewerLook, you will no doubt be
  12. annoyed when an application replaces your lovely 3D, high-resolution icons
  13. with its own poor-looking 2D blocky nasty ones. This happens a lot with
  14. shared filetypes like drawfiles, and badly-behaved applications which place
  15. new option icons, arrow icons and such in the WIMP pool.
  16.  
  17.  You will also be concerned, if you don't have lots of memory, at all the
  18. memory those small icons will be taking up, if you only use large icons,
  19. and so don't need them.
  20.  
  21.  You may even get annoyed when applications use their own private sprites for
  22. window furniture (option, radio, arrow and gright) instead of the nice ones
  23. you've loaded into your WIMP pool. This is getting more and more of a problem
  24. as applications designers think it's a good idea to build NewLook icons into
  25. the application, which is bad (especially if you don't use NewLook).
  26.  
  27.  This module fixes these problems. It intercepts the OS_SpriteOp "merge
  28. sprites file" call, and alters the action of the SWI action to disallow small
  29. icons, and to make sure new icons do not replace old ones. But it must know
  30. that the pool involved is indeed the WIMP sprite pool, otherwise it would
  31. change all sprite merges, which could cause undesired effects. So you must
  32. mark the WIMP sprite pool with a sprite called "⇨wimppoolme⇦", *IconSpritesed
  33. with your main sprite file or separately, probably through your !Boot system,
  34. if you have one. If you use NewerLook, you need not worry - that does
  35. everything for you.
  36.  
  37.  AddSprites forces applications to use WIMP sprites for window furniture by
  38. intercepting the OS_SpriteOp "plot sprite" call, and replacing it with a call
  39. to Wimp_SpriteOp as long as the following case applies: the sprite being
  40. plotted must be the same size (in OS units, not necessarily pixels) as its
  41. counterpart in the Wimp pool, and its name is one of the special names (which
  42. are the opts, the radios, the arrows and the grights). So that AddSprites
  43. doesn't get into an infinite loop changing OS_SpriteOps to Wimp_SpriteOps,
  44. you do need the "⇨wimppoolme⇦" in the WIMP pool again.
  45.  
  46.  Of course, you might occasionally want *IconSprites to work as normal,
  47. when some sprites need to be replaced, without having to kill the module.
  48. AddSprites deactivates itself when the system variable <AddSprites$Control>
  49. is set to "Off". So, to disable AddSprites, press F12 and type (or include in
  50. an obey file):
  51.  
  52. *Set AddSprites$Control Off
  53.  
  54. And to turn it back on:
  55.  
  56. *Set AddSprites$Control On   [actually, anything other than "Off" will do]
  57.  
  58.  Also, you might use IconDir or Menon, and thus need small icons anyway. To
  59. do this, use the AddSprites$Small variable:
  60.  
  61. *Set AddSprites$Small [On|Off|Filer]
  62.  
  63.  The three settings mean: On - small sprites are always added (this is the
  64. setting you want if you use IconDir or Menon); Off - small sprites are never
  65. added to the WIMP sprite pool; Filer - small sprites are added to the WIMP
  66. pool only if the Filer is set to display them. If the variable is not set
  67. to any of these, the default, Filer, is chosen. Note that newer versions of
  68. IconDir automatically set AddSprites$Small to On.
  69.  
  70.  You can also disable the WIMP-forcing feature by setting the system variable
  71. <AddSprites$ForceWimp> to "Off".
  72.  
  73.  Oh, one last NB: this module only protects sprites loaded into the RAM WIMP
  74. pool. It won't protect ROM-based sprites. Sorry.
  75.  
  76.  That's about it really. Enjoy!
  77.  
  78.  
  79. ==> History
  80.  
  81. 0.01 : Stops replacement of existing WIMP sprites. Not publically released.
  82. 0.02 : Now includes <AddSprites$Control> variable to allow module to be
  83.        temporarily disabled. Included with NewerLook release 1.00.
  84. 0.03 : Stops small icons from being added if the Filer is configured to
  85.        'large icons'. Not publically released.
  86. 0.04 : Now allows the adding of small icons to be controlled with another
  87.        variable. Released separately and with NewerLook releases 1.01 to
  88.        2.01.
  89. 0.05 : Now intercepts OS_SpriteOp sprite plots in order to make sure certain
  90.        standard sprites are plotted from the WIMP pool. Released separately
  91.        and with NewerLook release 2.02 and later.
  92.  
  93.  
  94. ==> Contacts
  95.  
  96.  To contact me, for praise, to suggest new bits to add, or, heaven forbid,
  97. to report a bug, please write to:
  98.  
  99.    7 Blackhorse Crescent,
  100.     Amersham,
  101.      Bucks.,
  102.       HP6 6HP.
  103.  
  104.  You can phone me on 01494-431916, send a fax on 01494-675878, send me some
  105. email as ajc@doggysft.demon.co.uk or even telex on 83675 Brit G.
  106.