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