home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilsm / megaboard / Docs / Guide next >
Text File  |  1995-05-04  |  18KB  |  460 lines
  1.                          ****************************
  2.                          *--------------------------*
  3.                          *- MegaBoard Version 1.67 -*
  4.                          *--------------------------*
  5.                          ****************************
  6.  
  7. Please note this program is SHAREWARE, please refer to the end of this file
  8. for details.
  9.  
  10. ---------------------------------------------
  11. - Upgrading from versions earlier than 1.50 -
  12. ---------------------------------------------
  13. In this version of MegaBoard the special icon interface has been completely
  14. rewritten (for exact details see the ProgInfo file), therefore special icons
  15. written for earlier versions will no longer work. This drastic change was
  16. necessary because of the unpredictable memory requirements of BASIC
  17. libraries. I apologise to any authors of special icons for this
  18. inconvenience.
  19. Saved configurations that do not contain special icons can still be used with
  20. this version.
  21.  
  22. ----------------
  23. - Introduction -
  24. ----------------
  25. MegaBoard is a desktop Backdrop utility designed as a replacement for the
  26. Pinboard Module supplied with Risc OS 3. It offers a number of extra features
  27. and enhancements.
  28.  
  29. -----------------------
  30. - System Requirements -
  31. -----------------------
  32. MegaBoard requires Risc OS 3.5 or greater in order to operate correctly. At
  33. the time of writing this was only available on the RiscPC. Should a version
  34. be released for other models MegaBoard should run correctly on these
  35. machines as well.
  36.  
  37. ---------------
  38. - Terminology -
  39. ---------------
  40. "MegaBoard" refers to this Program.
  41. "Pinboard"  refers to the Risc OS 3 utility.
  42.  
  43. ---------------
  44. - Starting up -
  45. ---------------
  46. MegaBoard can be Loaded by double clicking on the icon !MegaBoard in the
  47. directory viewer.
  48. When MegaBoard is first loaded it is necessary for it to reinitialise the
  49. Filer. This will cause all open Filer Windows to be closed. Installing
  50. MegaBoard into the boot sequence (see below) avoids this Problem.
  51.  
  52. -------
  53. - Use -
  54. -------
  55.  
  56. Filer icons
  57. -----------
  58. Placing Filer icons on MegaBoard:
  59. An icon is placed on MegaBoard by dragging it from a Filer window and
  60. dropping it on MegaBoard.
  61.  
  62. Moving:
  63. An icon dragged and dropped onto another part of MegaBoard will be moved
  64. to that position unless it is locked (see below).
  65.  
  66. Positioning and Grid lock:
  67. Normally filer icons are positioned at the exact position they were dropped
  68. on MegaBoard. However if the Grid lock option is on then any icons
  69. placed or moved on MegaBoard will be positioned at the closest grid
  70. point. The Grid lock option is toggled by choosing the Grid lock menu item
  71. on MegaBoard menu.
  72. Note: Grid lock only applies to Filer icons placed or moved when it is
  73.       activated. Activating Grid lock has no effect on existing icons unless
  74.       they are moved.
  75.       Grid lock has no effect on special or window icons
  76.  
  77. Double-clicking:
  78. Double-clicking Select on an icon placed in the manner described above has
  79. the same effect as it would in a Filer window. Double-clicking Adjust is
  80. identical unless the 'Adjust Removes' option is set in the main menu, in
  81. which case the icon is also removed from MegaBoard.
  82.  
  83. Dragging:
  84. Icons dragged from MegaBoard and dropped on other applications (including the
  85. Filer) are also treated in the same way as icons dragged from a Filer window
  86. with the exception of dragging with Shift copying not moving the selected
  87. items.
  88. Dragging with Adjust additionally removes the items from MegaBoard if the
  89. 'Adjust Removes' option is set in the main menu.
  90.  
  91. Selecting:
  92. Filer icons can be selected in several ways:
  93. 1. Clicking Select on an unselected icon selects it and deselects all others.
  94.    Clicking Select on a selected icon has no effect.
  95. 2. Clicking Adjust on an unselected icon selects it.
  96.    Clicking Adjust on a selected icon deselects it.
  97. 3. Dragging Select on MegaBoard produces a bounding box within which all
  98.    icons are selected.
  99. 4. Dragging Adjust on MegaBoard produces a bounding box within which all
  100.    unselected icons are selected and selected icons are deselected.
  101. 5. Clicking Menu over an icon when none are selected selects that icon and
  102.    opens the main menu.
  103.  
  104. Information:
  105. Information on a Filer icon can be obtained by choosing the 'Info' option
  106. from the 'File' Submenu.
  107.  
  108. Removing:
  109. Filer icons that are no longer required can be removed from MegaBoard by
  110. selecting them and choosing the 'Remove' option from the 'File' submenu.
  111.  
  112. Opening the parent directory:
  113. The parent directory of a file or directory can be opened by choosing the
  114. 'Open Directory' option from the 'File' submenu.
  115.  
  116. Locking:
  117. An icon can be locked to MegaBoard to prevent it from being moved. Locking is
  118. toggled by choosing the 'Lock' option in the 'File' submenu. Locked filer
  119. icons can still be dragged, but dropping them back onto MegaBoard will not
  120. move them.
  121.  
  122. Moving to the front or back:
  123. Should an icon be obscuring another it is possible to move it to the back of
  124. the heap by choosing the 'Back' option from the 'File' submenu. Similarly an
  125. icon can be moved to the front by choosing the 'Front' option from the same
  126. submenu.
  127.  
  128. Altered files:
  129. If a file whose icon is on MegaBoard, is deleted or renamed the icon will be
  130. automatically removed from MegaBoard. Similarly if the filetype is altered,
  131. the MegaBoard icon will be updated to reflect the change.
  132.  
  133. Window icons
  134. ------------
  135. iconising application windows:
  136. Clicking on a window's close icon with Shift will cause it to be reduced to a
  137. MegaBoard icon. An exception is filer windows, these will only be handled in
  138. the same way if the 'iconise dirs' option is set in the MegaBoard menu,
  139. otherwise the icon of the parent directory is placed on MegaBoard as a Filer
  140. icon (see above).
  141.  
  142. Removing:
  143. Window icons cannot be removed using the MegaBoard menu. Double clicking
  144. Adjust or Select on a window icon brings the window to the front and removes
  145. the icon. The icon will also be removed if the window's parent application
  146. closes or reopens the window.
  147.  
  148. Accessing menus of iconised windows:
  149. iconised windows may have menus associated with them, if this is the case
  150. then clicking Menu while pressing Shift opens this menu.
  151.  
  152. Note: Window icons cannot be locked.
  153.  
  154. Backdrops
  155. ---------
  156. To create a backdrop execute the following steps:
  157. 1. Choose the 'Make' option from the backdrop submenu. This opens the
  158.    backdrop setup dialogue box.
  159. 2. Drag the object (directory (see below), sprite, or draw file) containing
  160.    the backdrop to the appropriately marked icon.
  161. 3. Select the desired horizontal and vertical positioning icons or the tiled
  162.    icon.
  163. 4. Click on 'OK'.
  164.  
  165. To remove a backdrop choose the 'Remove' option from the Backdrop submenu.
  166. To change the colour of the background choose the 'Colour' option from the
  167. Backdrop submenu. The colour can then be chosen using a standard colour
  168. selector.
  169. If the 'Autoscale' option in the 'Backdrop' submenu is selected then the
  170. backdrop will be scaled to always occupy the same number of OS-units not
  171. pixels on the screen in the same way as icons. E.g. a backdrop in the
  172. standard 1600x600 mode will be scaled to the same size it would be if the
  173. resolution were 1600x1200. This sounds more complicated than it is the effect
  174. of the autoscale option is best understood by experimentation.
  175. When a backdrop is created, it is possible that part of the screen becomes
  176. corrupted and is then redrawn, this is normal and not a bug.
  177.  
  178. Cycled backdrops:
  179. It is possible to select a number of backdrop pictures that will be displayed
  180. successively each being visible for a user-defined time period before being
  181. replaced by the next. This is achieved by the following procedure:
  182.  
  183. - Create a directory to hold the backdrop pictures.
  184. - Copy the files into this directory (it is irrelevant whether these are draw
  185.   files or sprites or a mixture of both).
  186. - Create a script file, either by using the supplied !MakeScrpt application
  187.   or you can write it yourself:
  188.  
  189.   Write a text file containing a list of entries of the following format:
  190.  
  191.     Start_Backdrop
  192.       Horizontal position: <position>
  193.       Vertical position: <position>
  194.       Time: <Time the file should be displayed seconds>
  195.       Name: <Filename of the file>
  196.       Background colour red component: <perce