home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 2 / DATAFILE_PDCD2.iso / utilities / _grabmenu / !GrabMenu / !Help < prev    next >
Encoding:
Text File  |  1992-05-15  |  4.5 KB  |  133 lines
  1. | Help for GrabMenu "1.10 (15-May-1992)"
  2. |
  3.  
  4. This application will grab the menu(s) from the screen, and dump them
  5. into a masked sprite.  This is useful for documentation purposes.
  6.  
  7.  
  8. Hot Keys
  9. ========
  10.  
  11. It is activated 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 - and with a sentence like that it is understandable I
  56. failed me English O level :-)
  57.  
  58.  
  59. Sub-menus And DBoxes
  60. ====================
  61.  
  62. This program works on the assumption that menus are always the
  63. top-most windows on the desktop.  So all it does is find the outline
  64. of the topmost N windows, and grab this screen image into a sprite.
  65. This works fine.  It even works if there are no menus.
  66.  
  67. Note that if you want to grab the main menu and a sub-menu, then set N
  68. sub-menus to 1.  If you just want a copy of the sub-menu on its' own
  69. (usually preferable with big menu structures) then keep the N
  70. sub-menus to 0. This works because the sub-menu will be the window at
  71. the front of the window stack.  This can be extended, vis-a-vis you've
  72. got a heavily nested menu structure, just set N sub-menus to 2 to grab
  73. the three "rightmost" sub-menus.
  74.  
  75.  
  76. Colours
  77. =======
  78.  
  79. Now, on screen everything looks OK, but print anything out and you
  80. come across the Archimedes 4-bit palette restriction.  I.e. the screen
  81. palette entry for white is saved as &F0F0F0, i.e. only 240/256 = 94%
  82. white! Since future versions of the OS should fix this, I've added a
  83. toggle to disable the post processing done on the palette, i.e.
  84. copying of the top nyblle to the lower nybble.  This makes your whites
  85. even whiter!
  86.  
  87.  
  88. Credits
  89. =======
  90. Simon Huntington for the Interface module
  91. Nicko van Someren for BugView
  92. Acorn for an excellent OS
  93. Frank Zappa for musical entertainment
  94.  
  95.  
  96. Updates
  97. =======
  98.  
  99. 11-May-1992   preliminary version, unreleased
  100. 14-May-1992   v1.00, and probably the last - it does its' job
  101. 15-May-1992   v1.10, palette problem fixed
  102.  
  103.  
  104. Boring bit
  105. ==========
  106.  
  107. Written by, and copyright held by Cy Booker © 1992.  This program has
  108. been put into the public domain with two provisos.  That you use at
  109. your own risk, and if this program happens to reformat your hard disc,
  110. cause your monitor to blow up, or the keyboard to ignite, that's your
  111. problem.  If you want guarantees of stability, you can pay for a
  112. program.  All I will say, is that I've used this program, and so it
  113. works on at least one machine.
  114.  
  115. If you use this program in a profit orientated project, then bung us a
  116. 10 quid cheque and I'll send you the latest version.
  117.  
  118. If you wish to distribute this program with a "nominal service
  119. charge", then please contact me (that's P.D. libraries).  Other people
  120. are free to give away as many copies as they like.
  121.  
  122. If you find the program has any shortcomings, or you would like any
  123. extra features added, then I can be contacted:
  124.  
  125. Cy Booker
  126. 86 Church View
  127. Main Road
  128. Crockenhill
  129. Swanley
  130. Kent.  BR8 8JW
  131. U.K.
  132.  
  133. Ya Hozna!