home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / mag_discs / 11 / programs / !MultiScrn / !Help < prev    next >
Text File  |  1993-10-30  |  11KB  |  250 lines
  1.                                    !MultiScrn
  2.                                    ==========
  3.  
  4.                             © 1993 Michael R. Ellis
  5.  
  6. How to use !MultiScrn
  7. =====================
  8.  
  9.         !MultiScrn provides up to ten views of the RISC OS desktop.  Each
  10. view can be displayed singly,  or all ten views can be displayed
  11. simultaneously.  It is also possible to remove all windows so that pinboard
  12. items can be accessed easily.
  13.  
  14.         When !MultiScrn is first started it selects the first view,  known
  15. as "Screen 1",  and all the windows visible are automatically placed onto 
  16. this screen.  A row of buttons is added to the iconbar,  and it is through
  17. these that other screens may be selected.
  18.  
  19.  
  20. Basic Operation
  21. ===============
  22.  
  23.         !MultiScrn can operate in three distinct modes,  namely Selected, 
  24. All and None. The names are pretty self-explanatory - Selected mode
  25. displays the selected screen while All and None modes are used to display,
  26. respectively,  all and none of the available screens.
  27.  
  28.         When first started,  !MultiScrn is in the Selected mode.  To select
  29. a different screen you can either double-click Select over one of the
  30. buttons above the iconbar or,  alternatively,  you can use ⇧^f1
  31. (Shift-Control-f1) to ⇧^f10 to select screen 1 to 10 respectively.  In
  32. Selected mode,  each screen can have a different screen mode and palette
  33. which will be set up when that screen is selected.  To change the screen
  34. mode and/or palette, simply use the palette application (or any other, 
  35. similar utility) as normal.  To override the automatic mode and palette
  36. change hold down Control while double-clicking the appropriate button - it
  37. is not possible to override the mode change when using the keyboard
  38. shortcuts.
  39.  
  40.         Double-clicking on the currently depressed button will change
  41. !MultiScrn into None mode.  While in None mode all windows will be moved
  42. off screen,  the screen mode and palette will remain unchanged and any
  43. windows created will be assigned to the screen in effect before None mode
  44. was entered.
  45.  
  46.         Double-clicking any button with Adjust or pressing ⇧^f11 will
  47. change !MultiScrn in All mode - the screen mode and palette will be those
  48. in effect when All mode was entered.  Any windows created while in All mode
  49. will be assigned to all the screens.
  50.  
  51.         Clicking Menu over the buttons produces a menu which can give
  52. information about !MultiScrn,  quit !MultiScrn or change the text displayed
  53. in the button: !MultiScrn will automatically shorten the name to fit the
  54. available space if necessary.
  55.  
  56.  
  57. Advanced Operation
  58. ==================
  59.  
  60. Moving Windows around
  61. ---------------------
  62.  
  63.         There comes a time when you want to move a window from one screen
  64. to another,  and !MultiScrn allows you to do this in several different ways
  65. which are outlined below.  All of the operations are based upon the filer
  66. methods of moving and copying files around - it is much easier to
  67. understand the descriptions if this is remembered.
  68.  
  69.         Moving a single window is always done by dragging from a button on
  70. the button-bar to a window.  Two things must also be remembered.  First,
  71. there is only ever one copy of a window - if that copy is closed (using the
  72. normal 'close' icon on the window) then the window will disappear from all
  73. the screens it appeared on.  Second,  iconised windows,  backdrop windows
  74. and panes are never affected by !MultiScrn.
  75.  
  76.         Dragging with Select copies the window to the screen associated
  77. with the button.  This is similar to the method used by the filer to copy a
  78. file from one place to another except that the drag occurs in the 'wrong'
  79. direction.
  80.  
  81.         To move a window to a specific screen,  shift-drag with Select just
  82. as if you were going to copy a window as described above.  The window will
  83. disappear from all the screens it appears on and will re-appear on the
  84. destination screen.
  85.  
  86.         Dragging with Adjust instead will copy the window onto all the
  87. screens. Shift-dragging with Adjust will attempt to remove the window from
  88. the currently displayed screen.  Note that !MultiScrn will not allow you to
  89. remove the window from the last screen it appears on.
  90.  
  91. Moving Screens around
  92. ---------------------
  93.  
  94.         It is possible to move all the windows on a screen to another
  95. screen by dragging between two buttons on the button-bar.  Dragging and
  96. shift-dragging with Select both work as expected - the former copies all
  97. the windows while the latter moves the windows.  Note that in this case the
  98. drag works 'right way round' - the windows are copied/moved from the screen
  99. you drag from and to the screen you drag to.
  100.  
  101.         Dragging and shift-dragging with Adjust is a little more
  102. complicated.  The former moves any window which currently appears on all
  103. screens to all screens,  the net result of which is that it does nothing! 
  104. The latter moves any window which currently appears on all screens to the
  105. destination screen.
  106.  
  107. Command-line Operation
  108. ----------------------
  109.  
  110.         To ease the setting up of screens,  a means is provided whereby the
  111. currently selected screen and the names of any of the screens may be set
  112. from the command line or an 'Obey' file.  This is done by the "WIMP
  113. Messenger" module included with MultiScrn.  The commands recognised are :-
  114.  
  115. SendMessage MultiScrn Name <screen> <name>
  116. SendMessage MultiScrn Set  <screen>
  117.  
  118. where <screen> is a number between 1 and 10 (out of range values are
  119. ignored) and <name> is a text string to be used as the name.  The "Set"
  120. command also understands the screen known as 'all'.
  121.  
  122. Note that there is a "bug" (feature) in all current version of the RISC OS
  123. filer which prevents the Filer_OpenDir and Filer_CloseDir commands from
  124. working properly within scripts: all Filer_ commands are "saved up" until
  125. the end of the obey script and are then executed in reverse order.  This
  126. means that...
  127.  
  128. SendMessage MultiScrn Set 1
  129. Filer_OpenDir adfs::0.$.Dir1
  130. SendMessage MultiScrn Set 2
  131. Filer_OpenDir adfs::0.$.Dir2
  132.  
  133. ...will actually open both Dir1 and Dir2 on screen 2 with Dir1 on top of
  134. Dir2.  Sorry,  but there really is nothing I can do about this without
  135. re-writing the entire filer.
  136.  
  137.  
  138. Known Bugs and 'Features'
  139. =========================
  140.  
  141.         !MultiScrn assumes that you have the wimpflags (set using
  142. !Configure or the "*configure wimpflags" command) set to allow windows to
  143. be dragged off the
  144. right and bottom of the visible screen.
  145.  
  146.  
  147. Acknowledgements and Historical Information
  148. ===========================================
  149.  
  150.         The original idea for !MultiScrn can be traced back to the
  151. excellent "screen" program in the UNiX (® AT&T Labs) public domain:  screen
  152. allows the user to switch quickly between up to ten different tasks on a
  153. single textual terminal with a couple of keystrokes.  While this approach
  154. is not really valid in a graphical environment,  the principal was extended
  155. in several of the
  156. X-Windowing System window managers (in particular MOTiF and Open-Look
  157. Windows) which implement a system of "rooms" for the various windows.
  158.  
  159.         The Archimedes followed with the excellent !Larger,  which allowed
  160. the idea of "rooms" coupled to a large,  scrolling virtual desktop. 
  161. However,  after only a relatively brief exposure to !Larger,  I found the
  162. virtual desktop to be rather confusing:  it seemed very easy to lose a
  163. window,  and the familiarity I had with the UNiX "screen" program was
  164. missing.
  165.  
  166.         !MultiScrn is my answer to the problem - it implements "rooms", 
  167. called "screens",  without the complexity and confusion surrounding the
  168. virtual desktop.  Hot keys are provided to switch quickly between various
  169. screens even when the button bar is hidden,  and it is possible to move 
  170. all the windows off-screen so as to reveal all the items pinned to the 
  171. pinboard.
  172.  
  173.         !MultiScrn is written using some functions from DeskLib,  a
  174. FreeWare RISC OS Wimp library moderated by Jason Williams.
  175.  
  176.         The WIMPMessenger module was written by Michael R. Ellis and is
  177. similar in operation to the "Dialogue" module provided with StrongEd II
  178. (V2.50) by Guttorm Vik/Stallion Software.  WIMPMessenger was written from
  179. scratch and has several improvements over the Dialogue module.
  180.  
  181.         Thanks to Simon Lockhart for many suggestions and ideas,  some of
  182. which have been included in this version of !MultiScrn.  Simon also found a
  183. few small bugs in !MultiScrn,  but I'm not going to thank him for that! (-:
  184.  
  185.         "!Larger",  by Robin Watts,  has now moved into the commercial
  186. domain.
  187.  
  188. Version History
  189. ===============
  190.  
  191. 0.xx    18/07/93        Prototype versions - many with bugs and/or missing
  192.      to 08/08/93        features.  None were released.
  193.  
  194. 1.00    10/08/93        New version,  completely re-written and greatly
  195.                         improved
  196. 1.01    11/08/93        Some small bugs fixed.
  197. 1.02    31/08/93        Added the facility to have a window on all screens.
  198. 1.03    01/09/93        Improved the action on QUIT and upon multiple
  199.                         invocation
  200. 1.04    04/09/93        Added WIMPMessenger facilities.
  201. 1.05    08/09/93        Minor bug fixed - "thanks" Si!!!
  202. 1.06    13/09/93        Changed the user interface and added facilities for a
  203.                         window to appear on an arbitary set of screens.
  204.                         First official release version.
  205.  
  206.  
  207. Author's Note and Licence
  208. =========================
  209.  
  210.         The code and other files of !MultiScrn remain the copyright © 1993
  211. of the author,  Michael R. Ellis.  No part of the code nor the supporting
  212. files may by modified in any way without the prior written permission of
  213. the author.  No warranty,  express or implied,  is given with this software
  214. - you use it at your own risk.
  215.  
  216.         However,  this licence allows the distribution of !MultiScrn in an
  217. unaltered form as FreeWare by anyone provided that :-
  218.  
  219.   *     No charge is levied other than reasonable cost to cover
  220.         distribution and/or copying costs.  I regard more than £2 (or local
  221.         equivalent) as unreasonable (1993 prices).
  222.  
  223.   *     All files in the !MultiScrn directory are provided unaltered.
  224.  
  225.         WIMPMessenger is freeware in its own right and may be used in your
  226. own products provided that it is acknowledged in the !Help file of the
  227. application and that the application is distributed as FreeWare. 
  228. WIMPMessenger may not be used in commercial applications.  It is strongly
  229. recommended that the first parameter in any command issued via
  230. WIMPMessenger is the name of the application and that any application
  231. recognising the name should claim the message to prevent multiple actions
  232. from a single command.
  233.  
  234.         Bug reports and comments may be sent to me at the address below - I
  235. will attempt to fix any bugs found and incorporate any good ideas for
  236. improvements,  but I can make no promises.  If you supply a blank, 
  237. E-formatted disc and a post-paid reply envelope,  I will return your disc
  238. with the most up to date version of !MultiScrn and any other FreeWare
  239. products I have written.  My address is :-
  240.  
  241.                                 Michael R. Ellis,
  242.                                  33, Barnfield Avenue,
  243.                                   Kingston upon Thames,
  244.                                    Surrey,  KT2 5RD,
  245.                                     England.
  246.  
  247.                         InterNet email : mikee@dd.eng.bbc.co.uk
  248.  
  249.         Please note that the email address supplied with some of my earlier
  250. freeware packages is no longer valid.