home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / desktop / workspace / !WorkSpace / !Help next >
Text File  |  1998-09-05  |  17KB  |  374 lines
  1.  
  2.  
  3.                         !WorkSpace Desktop Utility
  4.                         ==========================
  5.  
  6.  
  7. Documentation for !WorkSpace application version 3.72 24-Aug-1998,
  8. requires RISC OS 3.1 or later.
  9.  
  10. Issue: 3.72 25-Aug-1998, replaces:      0.10 23-Oct-1992
  11.                                         1.00 25-Oct-1992
  12.                                         1.01 25-Nov-1992
  13.                                         2.00 16-Jan-1993
  14.                                         2.10 27-Jan-1993
  15.                                         3.00 12-Feb-1994
  16.                                         3.50 05-Apr-1994
  17.                                         3.60 01-Oct-1995
  18. Author: David J Ruck
  19.  
  20. Copyright © DEEJ Technology PLC 1992-1998
  21.  
  22.  
  23.  
  24. Overview
  25. ========
  26.  
  27. With the increasing amount of RAM available in new RISC OS machines it is now
  28. easy to have many applications running on the desktop at once, even with
  29. larger screen modes the desktop can often become overcrowded with windows,
  30. leading to annoyance and inefficiency.
  31.  
  32. !WorkSpace aims to solve this problem by providing six RISC OS desktop
  33. workspaces. These workspaces are similar to the feature provided on HP­VUE®
  34. on Hewlett Packard UNIX machines.
  35.  
  36. Workspaces can be switched between transparently to the applications, giving
  37. six times as much space to arrange windows as before, more elbow room than
  38. afforded by even the most expensive hi-res graphic card and large screen
  39. monitor.
  40.  
  41.  
  42. Using !WorkSpace
  43. ================
  44.  
  45. On installing !WorkSpace, six monitor icons are placed on the left hand side
  46. of the iconbar. Clicking on these icons will select the corresponding
  47. workspace. The current workspace has small picture of a desktop screen
  48. displayed on the iconbar monitor icons.
  49.  
  50. The desktop can be used in the normally in all workspaces, applications can
  51. be started and windows opened and moved around. On changing from one
  52. workspace to another, the windows in the current workspace will disappear
  53. and any windows in the new workspace will become visible. On changing back to
  54. the first workspace all windows on it are restored in the same position as
  55. before. The iconbar remains the same across all workspaces.
  56.  
  57. This will enable you to group applications windows together on each
  58. workspace, while still being able to access the full facilities of the
  59. machine. e.g. A wordprocessor’s windows in one workspace and a spreadsheet’s
  60. in another, along with the related filer windows for those files. Any hotlink
  61. facility will function across workspaces as normal.
  62.  
  63. Users often become used to arranging windows in different layouts according
  64. to which task is being accomplished, such as having the main editing window
  65. in one position and tools and other dialog boxes placed around it. If however
  66. more than set of applications needs to be used at once, it is often to  not
  67. possible to use a such layouts without windows overlapping and having to
  68. constantly use the back icon. Now different layouts can be used on each
  69. workspace, the WindOpen module also available from DEEJ Technology  can be
  70. used to automatically open and arrange windows from an Obey file.
  71.  
  72. Workspaces are preserved over mode changes and accessing the command line
  73. (via F12), although the window positions in a workspace can be altered if
  74. switching to a smaller mode. The desktop screen mode of each workspace can be
  75. fixed, so that when switching between workspaces the mode that used last time
  76. it was visited will be restored. For example; this will allow the user to run
  77. a painting program requiring a 24 bits per pixel colour mode in one
  78. workspace, and in another, a DTP application which performs better with a
  79. higher resolution 8 bpp mode.
  80.  
  81. Similarly the desktop palette can also be fixed for each workspace, allowing
  82. the standard palette to be used on one, a 16 grey level palette on another
  83. and a specialist colour one (such as supplied with !Artworks) on a third
  84. workspace.
  85.  
  86. Note: Occasionally windows from other workspaces will appear briefly as the
  87.       mode change is taking place, windows will be restored to their correct
  88.       positions after a few moments.
  89.  
  90. !Workspace regularly checks the position of windows to ensure that they are
  91. on the correct workspace and moves them if not, thus it can handle badly
  92. behaved applications which try to move their windows on screen when not
  93. desired.
  94.  
  95. Newly opened windows always appear on the current workspace.
  96.  
  97.  
  98. Selecting a windows workspace
  99. -----------------------------
  100. It is often desirable to allow a window to occupy more than one workspace, so
  101. it can be used from each without having to switch between them, e.g. this is
  102. useful for the root filer window, a CPU usage meter or a desktop clock.
  103.  
  104. If a window is present on more than one workspace it can have different sizes
  105. and positions in each. It is still the same window however, and not the same
  106. as the new view facility offered by programs such as !Draw, so it cannot have
  107. different attributes such as ‘zoom’ on each workspace.
  108.  
  109. If the menu button of the mouse is pressed over the back icon of a window, a
  110. selector box will appear allowing the workspaces that window occupies to be
  111. selected. It may be necessary to hold down the menu button for a few moments
  112. when the desktop is very busy.
  113.  
  114. The workspaces a window occupies is shown by the monitor icons, the picture
  115. of the desktop appears in the monitors corresponding to workspaces it is on.
  116. A window can occupy from one to all of the workspaces.
  117.  
  118. Clicking on a monitor icon with the select mouse button will select that
  119. workspace and deselect all others.
  120.  
  121. Clicking with the adjust button will toggle its state, allowing the window to
  122. be added or removed form a workspace with out affecting its presence on the
  123. others.
  124.  
  125. The ALL button can be used to quickly set the window to appear on all
  126. workspaces.
  127.  
  128. The OK button should be pressed after finishing selecting the window’s
  129. workspaces. If the window has been removed from the current workspace it will
  130. disappear immediately, it will then only be accessible from the other
  131. selected workspaces.
  132.  
  133. If OK is not pressed the state of the window before the dialog was called up
  134. will be restored. It is not possible to deselect a window from all
  135. workspaces, if this is desired the window should be closed instead.
  136.  
  137. To leave the selection box without changing anything, click on any other area
  138. of the desktop.
  139.  
  140.  
  141. Using the Hotkey
  142. ----------------
  143. It may sometimes be necessary to change the workspaces of a window which does
  144. not have a back icon, such dialog or tool boxes. A hot key feature is
  145. available to do this. Pressing the hot key (the default is CTRL SHIFT and TAB
  146. together) while the mouse is over the window in question will also bring up
  147. the selector box. It may be necessary to remove the caret from certain
  148. windows such as task windows (by clicking in another window) for this feature
  149. to work.
  150.  
  151.  
  152. Selecting multiple windows
  153. --------------------------
  154. Some windows such as those used by !Draw or !Impression have tool boxes or
  155. subpanes, when changing the workspace of the main window these will be not be
  156. affected, causing them to be left them behind on the original workspace.
  157.  
  158. To avoid this, or to change the workspace of many normal windows at once,
  159. chose the Select Windows option from the iconbar menu. The mouse pointer will
  160. change to an arrow and a picture of a window,  move the mouse to any part of
  161. the screen and hold down the select mouse button. You can then drag out a
  162. dotted rectangle containing the windows for which you want to change
  163. workspaces.
  164.  
  165. A workspace selector window will appear over one of the selected windows.
  166. After choosing the new workspace settings, all windows whose work areas are
  167. completely contained within the dragged rectangle will be given the new
  168. settings.
  169.  
  170.  
  171. The iconbar menu
  172. ----------------
  173. Info                    Displays a standard information dialogue box.
  174.  
  175. Fetch Window            Use ths option to fetch a window which is currently
  176.                         on another workspace and bring it to the current one.
  177.                         The option leads to a sub menus of tasks and windows.
  178.                         If the window is already on the current workspace it
  179.                         will be brought to the top of the window stack.
  180.  
  181. Goto Window             Use this option to goto the workspace occupied by a
  182.                         window. The window is choosen via submenus as above.
  183.                         If the window is on more than one workspace, the
  184.                         workspaces will be cycled through in turn.
  185.  
  186. Select Windows          Allows multiple windows to be selected, see above.
  187.                         Any of the WorkSpace iconbar menus can be used, the
  188.                         selection will always take place on the current
  189.                         workspace.
  190.  
  191. Choices                 The choices entry will bring up the choices dialog
  192.                         which is described in detail below.
  193.  
  194. Quit                    When the application is quit, windows on all
  195.                         workspaces will be restored, placing them back on
  196.                         screen in the positions that they occupied in each
  197.                         workspace.
  198.  
  199.  
  200. The choices dialog
  201. ------------------
  202. The choices dialog allows various workspace features to be set up and saved
  203. so that it becomes the default each time !WorkSpace is run.
  204.  
  205. Fix Mode                When fix mode is ticked for a the workspace, it will
  206.                         remember what mode it is currently in, and will
  207.                         change to it when next selecting the workspace. The
  208.                         mode can be changed as normal whilst fix mode is on.
  209.  
  210.                         If fix mode is not ticked, the workspace will always
  211.                         use the current mode, i.e. what ever mode is being
  212.                         used when switching to the workspace.
  213.  
  214.                         All workspaces may have fix mode set independently,
  215.                         and each workspace may operate in a different screen
  216.                         mode. A mode number can be entered in each writable
  217.                         box, so that this mode is used next time the
  218.                         workspace is switched to. New mode descriptions
  219.                         strings may be used under RISC OS 3.5 and above,
  220.  
  221.                                 e.g. X1024 Y768 C32K EX1 EY1 F60.
  222.  
  223. Fix Palette             Fix palette works in the same way as fix mode, the
  224.                         palette of the current workspace is remembered and
  225.                         will be restored on next selecting this workspace.
  226.  
  227.                         The current palette my be altered as usual and is
  228.                         preserved over mode changes both from the palettes
  229.                         utility and by changing mode using the fixed mode
  230.                         option of !WorkSpace.
  231.  
  232.                         The fix palette option only affects the desktop
  233.                         palette in 256 colour modes. Extended 8 bit palettes
  234.                         provided by graphics cards are not altered.
  235.  
  236. Icon sets               The WIMP and many applications provide two sets of
  237.                         icons, one for low resolution (2×4 pixel) and one
  238.                         for high resolution (2×2 pixel) modes. Normally the
  239.                         set of icons for the current type of mode is loaded
  240.                         and remains the same if the resolution is changed
  241.                         subsequently.
  242.  
  243.                         If use low & high resolution icon sets is ticked the
  244.                         correct set of icons will be loaded whenever the
  245.                         mode is changed from low to high or high to low
  246.                         resolution.
  247.  
  248.                         Sprite files containing a set of icons can be
  249.                         dragged to the high res and low res writable fields,
  250.                         or the pathname of the files typed in.
  251.  
  252.                         Two icon set files are provided within !WorkSpace
  253.                         providing icons similar to those from Acorns
  254.                         !NewLook application. These files can be found by
  255.                         double clicking on the !WorkSpace directory with
  256.                         shift held down. Extra icons from applications can
  257.                         be added to the files using !Paint.
  258.  
  259. Hot key                 The hot key is used to bring up a workspace selector
  260.                         for windows which don't have a back icon. By default
  261.                         it is CTRL+SHIFT+TAB, but if this key combination is
  262.                         used by another application, it can be changed to
  263.                         another.
  264.  
  265.                         To change click on the writable icon and press the
  266.                         desired key combination.
  267.  
  268.                         Valid hot keys are usually a key that does produce a
  269.                         printable character (darker grey on most keyboards)
  270.                         in combination with SHIFT and/or CTRL, for more
  271.                         information see the RISC OS User Guide.
  272.  
  273. Save                    By pressing the save button the current settings are
  274.                         stored with in !WorkSpace and will be restored every
  275.                         time !WorkSpace is run.
  276.  
  277. Cancel                  All changes made to the settings are abandoned, and
  278.                         the dialog is closed.
  279.  
  280. OK                      The changes made to the setting are applied and the
  281.                         dialog is closed unless adjust is used to click on
  282.                         the button.
  283.  
  284.                         If icon sets are in use the filenames are checked
  285.                         and the appropriate icon set for the current modes
  286.                         resolution is loaded.
  287.  
  288.                         If the fix mode number for the current workspace has
  289.                         been set, the mode will not be changed until this
  290.                         workspace is next selected.
  291.  
  292.  
  293. Information
  294. ===========
  295.  
  296. When using workspaces, windows which are already present on one workspace
  297. often will not appear when requested from another .
  298.  
  299. e.g.    Double clicking on a directory when its filer viewer is already in
  300.         another workspace, or trying to bring up task manager window from
  301.         its icon after having already having done this on another workspace.
  302.  
  303. The solution to this is to switch to the workspace which the desired window
  304. is on and allow it to occupy both workspaces using the selector dialog by
  305. pressing the menu mouse button over the windows back icon.
  306.  
  307. When switching between workspaces, windows are not closed, so no lose of
  308. data can occur, instead they are moved off screen using only legal RISC OS
  309. window manager calls.
  310.  
  311. While !WorkSpace is running you will be able to move windows partially off
  312. screen to the right and bottom, this is a feature of the desktop and can be
  313. enabled permanently using the !Configure application in the Apps folder.
  314.  
  315.  
  316. Artworks
  317. --------
  318. Please note that !Artworks and a few other badly behaved applications
  319. constantly force their tool boxes to stay on screen, thus causing them to
  320. stick on all workspaces, this is not a problem with !WorkSpace.
  321.  
  322. A work around for this problem is to iconify the offending main window (by
  323. holding down SHIFT and clicking on the close icon) before changing
  324. workspace. The window can the be restored onto any workspace by clicking on
  325. the windows icon on the backdrop.
  326.  
  327.  
  328. Windopen
  329. --------
  330. The DEEJ Technology PLC module WindOpen can be used to arrange windows into
  331. standard layout from a simple Obey file. It can interact with !WorkSpace, so
  332. that workspaces can be switched between, and windows set to occupy more than
  333. one workspace in different positions and sizes if desired. This is achieved
  334. by using simple *star commands which specifying the windows title and which
  335. task it belongs to.
  336.  
  337.  
  338. Programmers
  339. -----------
  340. If you are developing programs using multiple panned windows or non-standard
  341. titlebars, information on how to make your program !WorkSpace friendly can be
  342. obtained from DEEJ Technology PLC via your supplier.
  343.  
  344.  
  345. Changes
  346. =======
  347.  
  348. Since Version 3.60
  349. ------------------
  350. * New Fetch & Goto Windows Menus.
  351. * Choices saved to <WorkSpace$ChoicesDir>, setup in !Run.
  352. * Updated icons22 & icons24 sets from RISC OS 3.7 ROM.
  353. * Unused wimp message types filtered out.
  354. * Options dialog reverts all options on cancel.
  355. * No error if caret owner is not found on changing workspaces.
  356. * Windows brought to top when placed on new workspace.
  357. * Internationalisable messages file added.
  358. * Interactive help supported.
  359.  
  360. Since Version 3.70
  361. ------------------
  362. * Restrictions in RISC OS Lib over size and number of items in menus.
  363.   The task menu is limited to 64 entries, with additonal entries cannot be
  364.   displayed. If the windows menu becomes too big, additional submenus in the
  365.   task menu are created.
  366.   
  367. Since Version 3.71
  368. ------------------
  369. * Windows with no titles are not displayed in menus
  370. * Bug causing window submenus to be display in incorrect positions fixed
  371.  
  372. End of !WorkSpace.!Help
  373.  
  374.