home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / customise / megaboard / Docs / Guide next >
Encoding:
Text File  |  1994-12-18  |  16.8 KB  |  434 lines

  1.                          ****************************
  2.                          *--------------------------*
  3.                          *- MegaBoard Version 1.63 -*
  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. Altered files:
  123. If a file whose icon is on MegaBoard, is deleted or renamed the icon will be
  124. automatically removed from MegaBoard. Similarly if the filetype is altered,
  125. the MegaBoard icon will be updated to reflect the change.
  126.  
  127. Window icons
  128. ------------
  129. iconising application windows:
  130. Clicking on a window's close icon with Shift will cause it to be reduced to a
  131. MegaBoard icon. An exception is filer windows, these will only be handled in
  132. the same way if the 'iconise dirs' option is set in the MegaBoard menu,
  133. otherwise the icon of the parent directory is placed on MegaBoard as a Filer
  134. icon (see above).
  135.  
  136. Removing:
  137. Window icons cannot be removed using the MegaBoard menu. Double clicking
  138. Adjust or Select on a window icon brings the window to the front and removes
  139. the icon. The icon will also be removed if the window's parent application
  140. closes or reopens the window.
  141.  
  142. Accessing menus of iconised windows:
  143. iconised windows may have menus associated with them, if this is the case
  144. then clicking Menu while pressing Shift opens this menu.
  145.  
  146. Note: Window icons cannot be locked.
  147.  
  148. Backdrops
  149. ---------
  150. To create a backdrop execute the following steps:
  151. 1. Choose the 'Make' option from the backdrop submenu. This opens the
  152.    backdrop setup dialogue box.
  153. 2. Drag the object (directory (see below), sprite, or draw file) containing
  154.    the backdrop to the appropriately marked icon.
  155. 3. Select the desired horizontal and vertical positioning icons or the tiled
  156.    icon.
  157. 4. Click on 'OK'.
  158.  
  159. To remove a backdrop choose the 'Remove' option from the Backdrop submenu.
  160. To change the colour of the background choose the 'Colour' option from the
  161. Backdrop submenu. The colour can then be chosen using a standard colour
  162. selector.
  163. When a backdrop is created, it is possible that part of the screen becomes
  164. corrupted and is then redrawn, this is normal and not a bug.
  165.  
  166. Cycled backdrops:
  167. It is possible to select a number of backdrop pictures that will be displayed
  168. successively each being visible for a user-defined time period before being
  169. replaced by the next. This is achieved by the following procedure:
  170.  
  171. - Create a directory to hold the backdrop pictures.
  172. - Copy the files into this directory (it is irrelevant whether these are draw
  173.   files or sprites or a mixture of both).
  174. - Create a script file, either by using the supplied !MakeScrpt application
  175.   or you can write it yourself:
  176.  
  177.   Write a text file containing a list of entries of the following format:
  178.  
  179.     Start_Backdrop
  180.       Horizontal position: <position>
  181.       Vertical position: <position>
  182.       Time: <Time the file should be displayed seconds>
  183.       Name: <Filename of the file>
  184.       Background colour red component: <percentage of colour saturation>
  185.       Background colour green component: <percentage of colour saturation>
  186.       Background colour blue component: <percentage of colour saturation>
  187.     End_Backdrop
  188.  
  189.   Where the horizontal position is one of the following words:
  190.   Centered
  191.   Scaled
  192.   Left
  193.   Right
  194.  
  195.   and the horizontal position one of the following:
  196.   Centered
  197.   Scaled
  198.   Top
  199.   Bottom
  200.  
  201.   The colour saturation percentages are floating point numbers between 0 and
  202.   100 e.g. "53.86%". The percent sign "%" is optional. If one or more of
  203.   these fields is blank then those colour components be preserved from the
  204.   previous backdrop.
  205.  
  206.   The filename should not be a complete path, but only a leafname i.e. if the
  207.   pathname was "adfs::harddisc4.$.fred.pic0" then the filename would be
  208.   "pic0". If this field is blank or the file does not exist in the directory
  209.   then the backdrop picture will be removed for the specified time.
  210.  
  211.   There should be one such entry for each file to be displayed.
  212.  
  213.   Save the file in the same directory as the pictures with the filename
  214.   "Script".
  215.  
  216. - Use the same procedure described above for creating normal backdrops, but
  217.   instead of a sprite or draw file, drag the directory to the icon in the
  218.   backdrop setup window. The settings of the positioning icons is irrelevant
  219.   in this case as the positioning of the pictures is determined by the script
  220.   file.
  221.  
  222. Special icons
  223. -------------
  224. Special icons are icons which can perform a variety of additional functions,
  225. and can be defined by users with a knowledge of ARM code programming. See the
  226. files 'ProgGuide' and 'ProgTut' for instructions on how to create new special
  227. icons.
  228.  
  229. Placing:
  230. Special icons are placed on MegaBoard by choosing their menu items from
  231. the Special icon submenu.
  232.  
  233. Locking:
  234. Special icons can be locked in the same way as filer icons, but contrary to
  235. filer icons they cannot be dragged at all when they are locked.
  236.  
  237.  
  238. This version of MegaBoard includes the following special icons:
  239.  
  240. Pointer:
  241. Displays the current position of the mouse pointer in screen coordinates.
  242.  
  243. Time:
  244. Displays the current time in the format defined in its Format parameter (see
  245. below for how to edit parameters). The Format parameter is a standard time
  246. and date format string as described on page 327 of the RISC OS 3 User Guide. 
  247. If the format string contained a syntax error the icon will not display the
  248. time, but the word "ERROR" instead.
  249.  
  250. Gobbler:
  251. Deletes files dragged onto it.
  252.  
  253. Acornlogo:
  254. Displays an Acorn logo in the top-right corner of the screen. (Logo sprite by
  255. Adam Goodfellow (adam@comptech.demon.co.uk)).
  256.  
  257. Parameters:
  258. Some special icons (e.g. Time) can be configured by the user. This is
  259. accomplished by editing its parameters in the following manner:
  260. A special icon has parameters associated with it if its menu item has a
  261. submenu arrow. This submenu contains a menu item for each parameter, each of
  262. these menu items has a submenu of its own, which contains a single writable
  263. menu item. Initially this contains the default value for the parameter. If
  264. you wish to change this edit the value displayed and choose it with Adjust
  265. (NOT Select as this will close the menu tree).
  266. Use the same procedure to change the value of any other parameters you wish
  267. to alter and subsequently place the icon by Choosing its menu item.
  268.  
  269. The Overview Window
  270. -------------------
  271. Opening:
  272. The overview window is opened by choosing the 'Overview' option from the
  273. MegaBoard Menu.
  274.  
  275. Function:
  276. Displayed on the overview window is a "map" of MegaBoard. The white rectangle
  277. around the centre represents the visible area i.e. the screen excluding the
  278. icon bar. The surrounding light grey represents the area invisible to the
  279. user.
  280.  
  281. Icons:
  282. Icons are represented on the overview menu by small colour coded rectangles,
  283. the following is a table of icon types and their colour codes:
  284.  
  285.   Red......File
  286.   Blue.....Directory
  287.   Green....Application
  288.   Magenta..iconised window
  289.   Black....Special icon
  290.  
  291. Dragging icons on the on overview window:
  292. Dragging an overview window icon and dropping it back onto the overview
  293. window has the same effect as dragging it would on the MegaBoard i.e. the
  294. icon is moved to the position it is dropped on. Dragging an overview window
  295. icon to a different window has no effect.
  296. Unless the 'Move locked' radio icon on the overview window is selected, an
  297. attempt to drag a locked icon will have no effect.
  298. If the 'Move locked' radio icon is selected, icons can be dragged and moved
  299. regardless of whether or not they are locked. However this only applies to
  300. the icons' representations on the overview window, restrictions to dragging
  301. locked icons on the MegaBoard remain.
  302.  
  303. * Commands
  304. ----------
  305. MegaBoard's support module provides two * Commands, '*Pin' and '*Backdrop'.
  306.  
  307. '*Pin <Pathname> <x_coordinate> <y_coordinate>' places the filer icon
  308. specified by <Pathname> on the MegaBoard at the given coordinates.
  309. Example: *Pin adfs::harddisc4.$.fred 200 200
  310.  
  311. '*Backdrop [-options] [Pathname]' creates a backdrop, whose positioning is
  312. determined by the options as follows:
  313.  
  314. '-Centre'  centres the backdrop horizontally and vertically.
  315. '-HCentre' centres the backdrop horizontally.
  316. '-VCentre' centres the backdrop vertically.
  317.  
  318. '-Scale'  Scales the backdrop horizontally and vertically.
  319. '-HScale' Scales the backdrop horizontally.
  320. '-VScale' Scales the backdrop vertically.
  321.  
  322. '-Tile' Makes the backdrop tiled.
  323.  
  324. '-Top'    Aligns the top of the backdrop picture with the top of the screen.
  325. '-Bottom' Aligns the bottom of the backdrop picture with the top of the icon
  326.           bar.
  327.  
  328. '-Left'  Aligns the left of the backdrop picture with the left of the screen.
  329. '-Right' Aligns the right of the backdrop picture with the right of the
  330.          screen.
  331.  
  332. '-Remove' Removes the current backdrop (if present).
  333.  
  334. This list of options is in order of reverse priority i.e. if two or more
  335. contradictory options are specified (e.g. -hscale and -hcentre) in one
  336. command the one lowest on the above list will take effect.
  337.  
  338. Example: *Backdrop -HCentre -VScale adfs::4.$.Pic0
  339.          Will use the picture in the file 'adfs::4.$.Pic0' as a backdrop. The
  340.          picture will be horizontally centred and vertically scaled.
  341.  
  342. -----------
  343. - Credits -
  344. -----------
  345. Thanks are due to the following for testing, ideas and nagging for more
  346. features:
  347. Pavendip Birah (IRC nickname: PAV)
  348. Asif Nazir (IRC nickname: Hawks)
  349.  
  350. and to Adam Goodfellow for letting me use his AcornLogo sprite.
  351.  
  352. --------------------
  353. - Copyright notice -
  354. --------------------
  355. Except for the addition of special icons this application may NOT be altered.
  356. Nor may it be distributed for profit without my approval, this includes
  357. distribution as an 'extra' with commercial products, however should you wish
  358. to do so you are welcome to contact me do discuss details. A small charge to
  359. cover copying and media is acceptable.
  360.  
  361. This program is SHAREWARE, if you find it useful please register as a user.
  362. Registered users will be entitled to receive free upgrades (see below) and
  363. improved support. The cost of registration is 15 Deutschmarks or 5 UK pounds
  364. including a disc with the latest version of MegaBoard.
  365. Please make all payments in cash only. Users outside the UK or Germany may
  366. send local currency in, it should be equivalent to 15 Deutschmarks. (No coins
  367. please. Should the amount sent exceed DM 15, you will be entitled to receive
  368. upgrades free of P&P equivalent to the excess amount.)
  369.  
  370. Send registrations, comments, bug reports etc. to:
  371.  
  372. Sham Gardner
  373. Vorderstr 19
  374. 76189 Karlsruhe
  375. GERMANY
  376.  
  377. or EMail: un9l@rz.uni-karlsruhe.de
  378.  
  379. Upgrades
  380. --------
  381. Registered users can receive upgrades as follows:
  382.  
  383. From within Germany: Send a disc and a stamped-addressed jiffy bag to the
  384.                      above address.
  385. From outside Germany: Send a disc and the equivalent of 3 Deutschmarks (e.g.
  386.                       1 Pound) to cover P&P to the above address.
  387. Or by EMail from anywhere in the world: Send a short mail to the above
  388.                                         address and I will reply with a
  389.                                         uuencoded archive containing the
  390.                                         latest version of MegaBoard (no P&P
  391.                                         for EMail).
  392.  
  393. -------------------
  394. - Version history -
  395. -------------------
  396.  
  397. 1.00 - First release version
  398.  
  399. 1.01 - Minor bug fixed that occasionally caused icons to disappear.
  400.        Option added to prevent double clicks with Adjust from removing icons.
  401.  
  402. 1.50 - Special icon interface rewritten to require special icons to be
  403.        written in ARM code. Avoiding the unpredictable memory requirements of
  404.        BASIC librarys.
  405.        The three special icons provided with MegaBoard rewritten in ARM code
  406.        to adjust to this requirement.
  407.  
  408. 1.51 - Minor bugs fixed and several little features added.
  409.  
  410. 1.52 - Overview window and option to place directories instead of iconising
  411.        filer windows added.
  412.        iconised windows reopened by their tasks are now automatically
  413.        removed.
  414.  
  415. 1.53 - Selections of objects dragged from filer windows no longer all appear
  416.        in the same spot
  417.  
  418. 1.54 - Bug in special icon placing removed
  419.  
  420. 1.55 - Scaled backdrops now require less memory.
  421.  
  422. 1.61 - * commands '*Pin' and '*BackDrop' supported allowing e.g. textures to
  423.        be set from !Configure.
  424.        Special icon 'AcornLogo' added.
  425.  
  426. 1.62 - Cycled backdrops supported.
  427.  
  428. 1.63 - Changes to the desktop font handled properly.
  429.        The colour picker now always reflects the current backdrop colour.
  430.        Filer and window icon text is either black or white to ensure it is
  431.        readable with any backdrop colour.
  432.        Filer icons whose objects are altered e.g. their have type changed are
  433.        automatically updated to reflect these changes.
  434.