home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / desktop / multidesk_1 / !MultiDesk / !Help next >
Text File  |  1995-09-20  |  12KB  |  313 lines
  1.         MultiDesk 1.13 (9 Sep 1995)
  2.         ----------------------------
  3.  
  4.  
  5. Introduction
  6. ------------
  7.  
  8. MultiDesk provides a 'Virtual Desktop' - a desktop which is many times
  9. larger than your normal computer display.
  10.  
  11. MultiDesk displays a map of the virtual desktop, which is updated in
  12. real time. You can change the part of the virtual desktop that is
  13. displayed on your monitor, and also drag windows (or groups of windows)
  14. around the virtual desktop.
  15.  
  16. MultiDesk requires RISC OS 3.10 or later.
  17.  
  18. MultiDesk supports interactive help, so run !Help and !MultiDesk
  19. together to find out how to use it.
  20.  
  21. Read on for a slightly fuller description.
  22.  
  23.  
  24.  
  25.  
  26. What MultiDesk does
  27. -------------------
  28.  
  29. When MultiDesk is run, it will install a multi-coloured icon on your
  30. iconbar.
  31.  
  32. Clicking SELECT on this iconbar icon (or choosing 'Open Window' from the
  33. iconbar menu) will open MultiDesk's main window. This shows a
  34. scaled-down version of the virtual desktop, displaying all the windows
  35. that are currently open.
  36.  
  37. Each window is represented as a coloured rectangle, with as much of the
  38. window's title displayed as possible. 
  39.  
  40. You can drag the windows around inside MultiDesk's main window with
  41. SELECT or ADJUST. When this is done, the corresponding 'real' window
  42. will also move around the screen/virtual desktop. When you drag/resize
  43. real windows, the corresponding rectangle in MultiDesk's main window
  44. will change accordingly.
  45.  
  46. Holding down ALT while dragging will move windows in screensize steps.
  47. This is useful when you want to preserve a windows position within a
  48. screen-size area.
  49.  
  50. If you click/drag on a window with SELECT, it will come to the top of
  51. the window stack. If you use ADJUST, the window will stay at the same
  52. position in the window stack.
  53.  
  54. If you start dragging a window with <Shift> down, all windows owned by
  55. the same application will also be dragged.
  56.  
  57. If you start dragging a window with <Ctrl> down, all windows in the same
  58. area of the virtual desktop (ie. the same screen-size rectangle) will
  59. also be dragged.
  60.  
  61. If you change screen-mode while MultiDesk is running, all windows will
  62. be moved so that they are in approximately the same 'screen' area of the
  63. virtual desktop. This means that if you change (for example) to Mode 0
  64. and then back again, all your windows will be in (approximately) the
  65. same position as before.
  66.  
  67.  
  68.  
  69. Moving around the Virtual Desktop
  70. ---------------------------------
  71.  
  72. MultiDesk's main window is divided into rectangles. These correspond to
  73. the physical size of your screen. The part of the virtual desktop that
  74. is currently being displayed on your monitor is shown with a red border.
  75.  
  76. The iconbar icon has a small coloured rectangle for each screen-size
  77. area in the virtual desktop, with a black circle showing which part of
  78. the virtual desktop is being shown on your monitor (the area which is
  79. outlined in red in MultiDesk's main window). 
  80.  
  81. There are three ways of looking at a different part of the virtual
  82. desktop:
  83.  
  84. 1)  double click inside MultiDesk's main window anywhere inside the
  85.     screen-sized area you want to move to. It is best to do this with
  86.     the Adjust button so that you don't inadvertently bring a window to
  87.     the top.
  88.  
  89. 2)  Click with ADJUST on one of the coloured squares on the iconbar
  90.     icon. 
  91.  
  92. 3)  Hold down the Alt key and press a cursor key. This moves to the next 
  93.     screen-sized area in the virtual desktop, either above, below, to
  94.     the left, or to the right of area currently visible.
  95.  
  96. NB, Note that Acorn don't like programs to respond to Alt-keypresses,
  97. because Alt is supposed to be reserved for generating special
  98. characters. To turn the key-detection off, change line 3 of the Basic
  99. program !MultiDesk.MakeMod to be 'detect_hotkey% = FALSE'.
  100.  
  101.  
  102. MultiDesk remembers which window in each screen-area had input focus the
  103. last time the screen-area was displayed, and restores input focus to
  104. this window when the view is moved back to the screen-area. This
  105. facility can be turned off in the 'Choices' window - see below.
  106.  
  107.  
  108.  
  109. Iconbar menu  
  110. ------------
  111.  
  112. This contains the usual Info and Quit items, plus the following:
  113.  
  114. 'Help'           loads this !Help file into your text-editor.
  115.  
  116. 'Open Window'    will open the main window which shows the virtual
  117.                  desktop (clicking SELECT on the iconbar icon is easier
  118.                  though).
  119.  
  120. 'Recall windows' moves all windows to the part of the virtual desktop
  121.                  which is currently visible.
  122.                  (When you quit MultiDesk, all windows are automatically 
  123.                  recalled.) 
  124.  
  125. 'Choices...'     Opens a dialogue box in which you can set various
  126.                  options. See later on for more info.
  127.  
  128. The submenu of the 'Quit' menu item allows you to quit while leaving all
  129. windows in their present position. Also, your display will move to the
  130. top-left of the virtual desktop (otherwise even restarting MultiDesk
  131. would not give access to windows above and to the left of the current
  132. position - MultiDesk will start off assuming the visual area of the
  133. desktop is at the top-left of the virtual desktop).
  134.  
  135. If you do this, there is no easy way of getting non-visible windows back
  136. without running MultiDesk again. Also, if the directory which contains
  137. !MultiDesk is open and not in the visible region of the virtual desktop,
  138. you won't even be able to start MultiDesk; to help matters, type
  139. 'recallwindows' in a taskwindow to get all the windows back (this
  140. command is set in the !Run file as an alias).
  141.  
  142.  
  143.  
  144.  
  145.  
  146. Other things
  147. ------------
  148.  
  149. Something to be aware of: if you have a directory-window open somewhere
  150. on the virtual desktop, re-opening this directory will not move the
  151. directory window to the visible screen, so you might have to search for
  152. it elsewhere on the virtual desktop. If there is sufficient interest,
  153. I'll look for a way of detecting re-opening of such windows and
  154. moving them to the visible region.
  155.  
  156. While MultiDesk is running, windows can be dragged off the screen in all
  157. directions, regardless of how you configure your machine with
  158. !Configure.
  159.  
  160. MultiDesk attempts to display windows in its main window using the right
  161. colour. However, a lot of windows don't actually have a colour (the
  162. window's application draws in the background colour itself), and these
  163. will be displayed as blue.
  164.  
  165. The title text in MultiDesk's main window is displayed with special
  166. justification which tries to always show the leafname of titlebar
  167. filenames.
  168.  
  169. Re-opening MultiDesk's main window (eg by clicking with SELECT on the
  170. iconbar icon) always forces a re-scan of the window-stack.
  171.  
  172. If you set, in the Choices window, the scale to be very small,
  173. MultiDesk's main window might show a bigger virtual desktop than it
  174. should. This is because the main window's back/close/toggle icons mean
  175. that it has a minimum size.
  176.  
  177. If you press Alt-cursorkey to move around the virtual desktop, you
  178. Alt-cursor keypress will be sent to whatever window currently has input
  179. focus, which can cause some programs to treat the Alt-cursor as a
  180. conventional cursor key. MultiDesk will try to stop this happening, but
  181. the keypress will only be acted on *after* you desktop has finished
  182. redrawing in the new position within the virtual desktop. The code
  183. which stops Alt-cursorkey's from reaching applications checks
  184. whether the Alt key is down. Hence to avoid Alt-cursor presses being
  185. treated as normal keypresses, you need to hold down the Alt key until
  186. after the screen has stopped redrawing, so that the code which stops the
  187. Alt-cursors knows that the keypress was used by MultiDesk to move around
  188. the virtual desktop.
  189.  
  190.  
  191.  
  192. Options - the 'Choices' window 
  193. ------------------------------
  194.  
  195. All options can be changed in the 'Choices' window - see the iconbar
  196. menu. You can save options to disc (where they will be stored inside the
  197. !MultiDesk application directory in the file 'Choices'), and they will
  198. automatically be loaded the next time MultiDesk is run.
  199.  
  200. You can set the delay (in 100ths of a second) between checking for any
  201. windows which have been opened but not dragged, and the delay (again in
  202. 100ths of a second) between re-scanning every window's titlebar, in case
  203. they have changed. 
  204.  
  205. When you move to a different part of the virtual desktop which contains
  206. a window which previously held the input focus, MultiDesk will move the
  207. input focus to this window. This can be turned off.
  208.  
  209. You can also set the font which MultiDesk uses in its display. If you
  210. don't select 'Outline font', MultiDesk will use the system font scaled
  211. to be as small as possible.
  212.  
  213.  
  214. 'Factory settings' are:
  215.  
  216. Virtual desktop width:                    2 
  217. Virtual desktop height:                   4
  218. Display scale:                           12 %
  219. Window delay:                           200 cs
  220. Window title delay:                    1000 cs
  221. Auto input-focus:                        On
  222. Text display:        8 point Trinity-medium
  223.  
  224.  
  225.  
  226.  
  227. Things to do  
  228. ------------
  229.  
  230. Have an option to emulate the !Configure option to only allow windows
  231. off the screen downwards and to the right when they are being dragged
  232. conventionally. This might be tricky - would have to allow windows off
  233. the screen when they are being dragged by MultiDesk, for eg.
  234.  
  235. Make the iconbar icon show a smaller version of the main-window display.
  236.  
  237.  
  238.  
  239. How it works 
  240. ------------
  241.  
  242. MultiDesk traps all calls to the SWIs Wimp_Open/Close/DeleteWindow, so
  243. that it knows exactly what windows are open, and their position and
  244. size.
  245.  
  246. Unfortunately, this doesn't detect menu-windows opening/closing, so
  247. MultiDesk checks the whole window stack every 2 seconds to make sure it
  248. is up to date. It also checks every window's titlebar every 10 seconds
  249. (you can change these update times - see below). You can see the virtual
  250. desktop display update in this manner when you open menus, for eg.
  251.  
  252. Note that MultiDesk will execute a *configure command when it is run to
  253. allow windows to be moved off the screen. Your original setting is
  254. restored when MultiDesk quits.
  255.  
  256.  
  257.  
  258.  
  259.  
  260. Other Stuff
  261. -----------
  262.  
  263. MultiDesk uses DeskLib extensively. This has made it much easier to
  264. write than would have been the case. Thanks to Jason Williams et al for
  265. this freeware C library.
  266.  
  267. Thanks also to Domonic Symes for the Zap text editor, Martin Ebourne for
  268. the C-code Zap mode, Dick Alstein for TemplEd, Mike Enderby for many
  269. helpful comments and beta testing and to Clive Jones, Dick Alstein, Andy
  270. Southgate and Andy Armstrong for help on intercepting Wimp_ SWIs. Thanks
  271. also to Simon Proven for improvements to MultiDeskModule.
  272.  
  273. This program is freeware. It may NOT me used in connection with any
  274. profit-making activities without my permission. Please contact me if you
  275. want to distribute MultiDesk in a PD library.
  276.  
  277. MultiDesk is copyright Julian Smith 1994, 1995.
  278.  
  279.  
  280. ************************************************************************
  281. *                                                                      *
  282. * If you find this program useful, you might like to make a donation   *
  283. * to Amnesty International, say £5, by sending me a cheque made out to *
  284. * them. I shall send you new versions of MultiDesk as they become      *
  285. * available if you do this, and I'll also be more likely to add        *
  286. * features/bug fixes for you.                                          *
  287. *                                                                      *
  288. ************************************************************************
  289.  
  290.  
  291. Also, please let me know if you have any comments, problems, suggestions
  292. or praise, or have found a bug.
  293.  
  294.  
  295.  
  296.  
  297. - Julian Smith
  298.  
  299.  
  300. -------------------------
  301. julian.smith@psy.ox.ac.uk
  302. -------------------------
  303.  
  304. or:
  305.  
  306. -------------------------------------
  307. Department of Experimental Psychology
  308. South Parks Road
  309. Oxford
  310. OX1 3UD
  311. UK
  312. -------------------------------------
  313.