home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 1 / RISC_DISC_1.iso / pd_share / utilities / grabmenu / !GrabMenu / !Help next >
Encoding:
Text File  |  1994-08-26  |  4.8 KB  |  135 lines
  1. Help for GrabMenu 2.00 (26-Aug-1994)
  2.  
  3. This application will grab the menu(s) from the screen, and dump them
  4. into a masked sprite.  This is useful for documentation purposes.
  5.  
  6. It is copyrighted FreeWare, but please see below for details.
  7.  
  8. Hot Keys
  9. ========
  10.  
  11. Activation is by a user-defined hot key.  Any key can be used, but
  12. note that defining the hotkey as, say "A" is not much good, as the
  13. wimp tends to process these sort of keys itself if any window owns the
  14. input focus.  Better to use something like <Ctrl Shift> F9, or some
  15. such.
  16.  
  17. But note that sometimes windows that own the caret do not behave
  18. properly, and fail to pass on unrecognised key presses.  If this is
  19. the case, just close all windows which own the input focus, and try
  20. again.
  21.  
  22.  
  23. Files
  24. =====
  25.  
  26. The file handling is slightly unorthodox.  First you specify where to
  27. save the file, then the sprite file gets created when the hot key is
  28. pressed.  Only now, when I'm writing this document, did I realise It
  29. would be better to do it as: press hotkey, grab the menus, then bring
  30. up the saveas dbox.  Oh well, this method works, so what the hey?
  31.  
  32. The file is a standard Acorn format sprite file.
  33.  
  34.  
  35. Sprites
  36. =======
  37.  
  38. Since the problem was to create an exact copy of the menu's as seen
  39. on-screen, all this program does is grab the screen image.  So it is
  40. better to be in a 16-colour screen mode to save on file size.  If
  41. there are no dboxes, it is probably a better idea to use a four colour
  42. mode, since this will save even more memory.
  43.  
  44. If sub-menus are being grabbed, then a mask is created so junk doesn't
  45. show through.
  46.  
  47. Also, it would (probably) be better to save the menus in a
  48. high-resolution screen mode, so that there aren't twice as many x
  49. pixels as y.  Similarly, don't save them in a non-standard mode, as
  50. other people may not be able to view them.
  51.  
  52. (Also, if you use something like FontFixer to get a better font than
  53. the system font, you should disable this, as complete novices may get
  54. confused about tick marks, and such, that aren't exactly the same os
  55. on their screen)
  56.  
  57.  
  58. Sub-menus And DBoxes
  59. ====================
  60.  
  61. This program works on the assumption that menus are always the
  62. top-most windows on the desktop.  So all it does is find the outline
  63. of the topmost N windows, and grab this screen image into a sprite.
  64. This works fine.  It even works if there are no menus.
  65.  
  66. Note that if you want to grab the main menu and a sub-menu, then set N
  67. sub-menus to 1.  If you just want a copy of the sub-menu on its' own
  68. (usually preferable with big menu structures) then keep the N
  69. sub-menus to 0. This works because the sub-menu will be the window at
  70. the front of the window stack.  This can be extended, vis-a-vis you've
  71. got a heavily nested menu structure, just set N sub-menus to 2 to grab
  72. the three "rightmost" sub-menus.
  73.  
  74.  
  75. Colours
  76. =======
  77.  
  78. Now, on screen everything looks OK, but print anything out and you
  79. come across the Archimedes 4-bit palette restriction.  I.e. the screen
  80. palette entry for white is saved as &F0F0F0, only 240/256 = 94% white!
  81. Since future versions of the OS should fix this, I've added a toggle to
  82. disable the post processing done on the palette, i.e. copying of the
  83. top nyblle to the lower nybble.  This makes your whites even whiter!
  84.  
  85.  
  86. Credits
  87. =======
  88. Nicko van Someren for BugView
  89. Acorn for an excellent OS
  90. Frank Zappa for musical entertainment
  91.  
  92.  
  93. Updates
  94. =======
  95.  
  96. 11-May-1992   preliminary version, unreleased
  97. 14-May-1992   v1.00, and probably the last - it does its' job
  98. 15-May-1992   v1.10, palette problem fixed
  99. 30-Jun-1992   v1.20, delayed dbox creation
  100. 26-Aug-1994   v1.90, removed Interface, hi-resolution sprites
  101.  
  102.  
  103. Boring bit
  104. ==========
  105.  
  106. Written by, and copyright held by Cy Booker © 1992, 1994.  This
  107. program has been released as FreeWare with some restrictions.  That
  108. you use at your own risk, and if this program happens to reformat
  109. your hard disc, cause your monitor to blow up, or the keyboard to
  110. ignite, that's your problem.  If you want guarantees of stability, you
  111. can pay for a program.  All I will say, is that I've used this program,
  112. and so it works on at least an A440 and a Risc PC.
  113.  
  114. If you use this program in a profit orientated project, then bung us a
  115. 10 quid cheque and I'll send you the latest version.
  116.  
  117. If you wish to distribute this program with a "nominal service
  118. charge", then please contact me (that's P.D. libraries).  Other people
  119. are free to give away as many copies as they like.
  120.  
  121. If you find the program has any shortcomings, or you would like any
  122. extra features added, then I can be contacted:
  123.  
  124.                       Cy Booker
  125.                       86 Church View
  126.                       Main Road
  127.                       Crockenhill
  128.                       Swanley
  129.                       Kent.  BR8 8JW
  130.                       U.K.
  131.                       
  132.                       Internet:       cy@cheepnis.demon.co.uk
  133.                       Arcade BBS:     #1706
  134.  
  135. Ya Hozna!