home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / desktop / b059_1 / !Pinboard / !Help next >
Text File  |  1994-01-21  |  7KB  |  202 lines
  1. Setting up
  2. ----------
  3.  
  4. First of all, you will have to make the new Pinboard+ module:
  5. 1. Ensure that the original Pinboard 0.50 is loaded. If it isn't, you can do it
  6.    like this: Enter the cli, type 'RMKill Pinboard', type 'RMReInit Pinboard',
  7.    and return to the desktop.
  8. 2. Doubleclick on !MakePin+ in the !Pinboard directory.
  9.  
  10. To load the new Pinboard+, double click on !Pinboard.
  11. If you want to load it as part of your bootfile, you should remove the last
  12. 2 lines of !Pinboard.!Run ('Echo' and 'Desktop') and run it before the desktop
  13. starts.
  14.  
  15. Pinboard+ 1.00
  16. --------------
  17.  
  18. Pinboard+ will behave more or less like the original Pinboard, until you
  19. double click on a menufile or issue a *BackMenu <filename>.
  20.  
  21. Clicking Menu on the background now produces your 'User Menu'.
  22. The normal Pinboard menu is accessible by holding Ctrl and clicking Menu.
  23. Shift-Menu works as before.
  24.  
  25. The User Menu enables you to have easy access to a wide range of often used
  26. commands. The main advantage is, that you have complete control over the
  27. appearance and contents of this menu, as well as what is to happen when you
  28. select an item.
  29. It is also possible to select up to 4 hotkeys for any item, making trivial tasks
  30. like opening your favorite dir in a sensible place, or changing to your favorite
  31. mode, very easy and fast. You can have hotkeys to bring up parts of the menu as
  32. well.
  33.  
  34. The menu, the keys, and their actions are edited with the '!MenuDes' program,
  35. see its !Help file for more details.
  36.  
  37. Changes in version 1.00:
  38. ------------------------
  39. € Several bugs in the original Pinboard fixed. Redundant code removed.
  40. € Will now display icons in large or small versions.
  41. € 'Remove selection' moved into a submenu, where also the size can be changed.
  42. € There are now 3 grids. One for large icons, one for small, and one for the
  43.   'Tidy' operation.
  44. € *Pin command changed slightly, so it just ignores an attempt to *Pin an
  45.   object that doesn't exist.
  46. € You can customise the appearance of the pinboard/tinydir icons by supplying
  47.   a different text and/or spritename.
  48. € An icon can be 'Locked', meaning that it doesn't move when you drag it.
  49.   This can be overridden by dragging with ctrl held down.
  50. € Locked icons will not be snapped to the grid.
  51. € Locked icons will not be removed when doubleclicked with adjust.
  52. € Grid-behaviour made more consistent wrt large and small icons.
  53.   Large icons lock to the bottom center of the bounding box, thereby aligning
  54.   them on a line.
  55.   Small icons lock to the left center of the bounding box, giving aligned
  56.   columns.
  57. € Changed and added a few commands, see later for details.
  58. € You can drag a previously unsaved file directly from an editor to the
  59.   pinboard. This will save the file in <Pinboard$Scrap> and pin the icon.
  60. € Iconised windows will appear along the iconbar.
  61. € The sprites used now follows the following scheme: 
  62.  
  63. Display size    Object type            Sprite priority
  64. ---------------------------------------------------------------
  65. Large        Application '<app>' OR        1. '!<app>'
  66.         image file with the        2. '<app>'
  67.         'app' bit set            3. 'application'
  68.  
  69.         Directory '<dir>'        1. '#<dir>'
  70.                         2. 'directory'
  71.  
  72.         Image file '<file>'        1. '#<file>'
  73.                         2. 'file_<type>'
  74.                         3. 'directory'
  75.  
  76.         File '<file>'            1. 'file_<type>'
  77.                         2. 'file_xxx'
  78.  
  79. Small        Application '<app>' OR        1. '*!<app>'
  80.         image file with the        2. 'sm!<app>'
  81.         'app' bit set            3. 'sm<app>'
  82.                         4. '!<app>'      (half size)
  83.                         5. '<app>'       (half size)
  84.                         6. 'small_app'
  85.  
  86.         Directory '<dir>'        1. '*#<dir>'
  87.                         2. '#<dir>'      (half size)
  88.                         3. 'small_dir'
  89.  
  90.         Image file '<file>'        1. '*#<file>'
  91.                         2. '#<file>'     (half size)
  92.                         3. 'small_<type>'
  93.                         4. 'file_<type>' (half size)
  94.                         5. 'small_dir'
  95.  
  96.         File '<file>'            1. 'small_<type>'
  97.                         2. 'file_<type>' (half size)
  98.                         3. 'small_xxx'
  99.  
  100.                               Pinboard+ commands
  101.                               ==================
  102.  
  103. *Pin
  104. ----
  105. Adds a file, application or directory to the desktop pinboard.
  106. Syntax: *Pin <filename> <x> <y> [-Text <icontext>] [-Sprite <spritename>] [-SmallIcon] [-Locked] [-Halfsize]
  107. -SmallIcon    will make the icon small, it is large by default.
  108. -Locked        will disable movement of the icon.
  109. -Text <text>    defines an alternative text for the icon.
  110. -Sprite <name>    defines an alternative sprite.
  111. -Halfsize    (in combination with -SmallIcon and -Sprite) will display the
  112.         alternative sprite at half size.
  113. Default text and sprite is the leafname of the file and the same sprite as used in the Filer windows.
  114. If the object doesn't exist, you will be ignored.
  115.  
  116. *PinSave
  117. --------
  118. Saves the Pinboard state to an obey-file, equivalent to the one saved from the
  119. menu.
  120. Syntax: *PinSave <filename>
  121.  
  122. *Pinboard_SelectAll
  123. -------------------
  124. Will select all the icons on the desktop background.
  125.  
  126. *Pinboard_ClearSelection
  127. ------------------------
  128. Will deselect all the icons on the desktop background.
  129.  
  130. *Pinboard_RemoveBackdrop
  131. ------------------------
  132. Will remove the desktop backdrop sprite.
  133.  
  134. *Pinboard_RemoveIcon
  135. --------------------
  136. Removes a file, application or directory icon from the pinboard. When no
  137. filename is given, the current selection is removed.
  138. If the file isn't on the pinboard, you will be ignored.
  139. Syntax: *Pinboard_RemoveIcon [<filename>]
  140.  
  141. *Pinboard_LargeIcon
  142. -------------------
  143. Makes the icon large. If no filename is given, the current selected icons are
  144. made large.
  145. If the file isn't on the pinboard, you will be ignored.
  146. Syntax: *Pinboard_LargeIcon [<filename>]
  147.  
  148. *Pinboard_SmallIcon
  149. -------------------
  150. Makes the icon small. If no filename is given, the current selected icons are
  151. made small.
  152. If the file isn't on the pinboard, you will be ignored.
  153. Syntax: *Pinboard_SmallIcon [<filename>]
  154.  
  155. *Pinboard_FreeIcon
  156. ------------------
  157. Allows free movement of the icon. If no filename is given, the current selected
  158. icons are made free.
  159. If the file isn't on the pinboard, you will be ignored.
  160. Syntax: *Pinboard_FreeIcon [<filename>]
  161.  
  162. *Pinboard_LockIcon
  163. ------------------
  164. Locks the icon in place. If no filename is given, the current selected icons
  165. are locked.
  166. If the file isn't on the pinboard, you will be ignored.
  167. Syntax: *Pinboard_LockIcon [<filename>]
  168.  
  169. *Pinboard_Update
  170. ----------------
  171. Will re-pin all the icons on the pinboard. This will ensure that any sprite
  172. changes are displayed correctly, and any deleted files are removed. Any
  173. unlocked icons will get snapped to the grid, if it is active.
  174.  
  175.   
  176.     
  177. Thomas Olsson, 21 Jan 1994
  178.  
  179.  
  180. Disclaimer
  181. ----------
  182.  
  183. The resulting program and this documentation is intended as an educational
  184. example of arm-code, and it isn't meant to be executed on actual hardware.
  185. Any hint of usefulness is therefore a product of a deranged imagination.
  186.  
  187.  
  188. Thanks to:
  189. ----------
  190.  
  191. Jens H. Ovesen for betatesting, good 'consistency discussions' and lots of
  192. suggestions. Also thanks for the SWI-module and the Filer patch, which all just
  193. makes life a lot easier!
  194.  
  195. The historic discussions with Brain Madsen started this off with a firm goal.
  196.  
  197. My coffee machine didn't break down during this either.
  198.  
  199. Acorn for the cpu and OS of course, what would we do without it?
  200. (YABOP, 'yet another bunch of pc-programmers' springs to mind)
  201.  
  202.