home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 1 / RISC_DISC_1.iso / commercial / warmsilenc / larger / !Larger / !Help next >
Text File  |  1994-10-14  |  20KB  |  427 lines

  1. !Larger         Version 2.09b                               10th October 1994
  2. =============================================================================
  3.  
  4. (c) 1991-94 Warm Silence Software
  5.  
  6. Introduction:
  7.  
  8. !Larger  is a RISC OS Application designed to make life easier when using the
  9. Desktop. It performs several functions at once:
  10.  
  11. 1) It  provides  a  Sticky  Backdrop  facility,  allowing applications, Basic
  12. programs  and  datafiles  to  be  run,  dragged from, or moved by clicking or
  13. dragging icons on the backdrop.
  14.  
  15. Features include:
  16.  
  17.       * Sprites, and System Variables can be saved with Backdrop.
  18.       * Backdrop acts as filing system, with multiple directories,  and  full
  19.         filer functionality.
  20.       * Automatic Gridlocking.
  21.       * Facility to Select directories as CSD when opened from backdrop.
  22.       * Hotkey (Configurable - Default Ctrl-Tab) to  select  Directory  under
  23.         Pointer as CSD, or to set CSD to parent directory of file  in  editor
  24.         under pointer.
  25.       * Unique 'Gravity' feature separates Applications  and  Directories  as
  26.         specified by user.
  27.       * Launch Applications by dragging files onto them.
  28.       * Save into directories by dragging files onto them.
  29.       * Launch Applications by User-Definable Ctrl Keys.
  30.       * !Help Compatible.
  31.       * Iconiser Facilities aka Pinboard.
  32.       * Configurable Hotkey (Default Shift-Tab) iconises  all  windows  owned
  33.         by a task to one icon.
  34.       * Backdrop Sprite Facilities - Centred, Scaled or Tiled,  with  colours
  35.         automatically matched to screen mode and palette. (Now with  optional
  36.         cached redraw mode.)
  37.       * 'Cycle' windows from back to front by hotkey (Configurable -  Default
  38.         Ctrl-Shift-Tab).
  39.       * 'Cycle' through tasks with windows  open  by  hotkey  (Configurable -
  40.         Default Print).
  41.       * Caret can 'chase' pointer between windows.
  42.       * Configurable sprite for every backdrop item.
  43.       * Icon text toggleable on and off for every backdrop item.
  44.  
  45. 2) It  provides  a  Virtual  Desktop  facility,  enabling a desktop of almost
  46. infinite size to be used, simply by 'pushing' the edge of the screen with the
  47. pointer.  This  has  uses when using many different applications at once, and
  48. helps prevent cluttering of Screen displays. Whole screens can be scrolled at
  49. once by using 'Alt+Cursors'. Also, 'rooms' are implemented in which up to  10
  50. virtual desktops can be operating at once.
  51.  
  52. 3) An Application Manager is provided. On Command,  an  entire  application's
  53. windows  can  be hidden from view off screen, and brought  back  at  a  later
  54. date unchanged. This is intended to help reduce screen clutter.
  55.  
  56. 4) !Larger has a configurable menu tree which can be programmed  by  altering
  57. the file 'MenuData' in  the  directory  Prefs.  Full  information  as  to the
  58. programming of this menu tree is given in the file.
  59.  
  60. Menu Options:
  61. =============
  62.  
  63. From the IconBar Icon:
  64. ----------------------
  65.  
  66. Info        =>             Opens a window containing info on Larger.
  67.  
  68. Save        => Backdrop    Saves all the details of the current backdrop.
  69.             => System      Saves all the system variables currently known  to
  70.                Variables   an  Obey  file  'SysVars'  in  the   !Larger.Prefs
  71.                            directory. This file is executed, whenever !Larger
  72.                            is run, so the system variables will  be  returned
  73.                            to the same  state.  This  file  can  be  manually
  74.                            edited and customised.
  75.             => Sprites     Saves all the sprites seen by  the  desktop  to  a
  76.                            file !Larger.Prefs.Sprites. The sprites saved  can
  77.                            be filtered  by  setting  options  in  the  Config
  78.                            window.
  79.  
  80. Load        => Backdrop    Loads the previously saved backdrop.
  81.             => System      Loads the previously saved system variables.
  82.                Variables
  83.             => Sprites     Loads the previously saved desktop sprites.
  84.  
  85. Desktop     => Home        Scrolls the virtual desktop back to  its  original
  86.                            position.
  87.             => Retrieve    Pulls all the windows of  the  desktop,  onto  the
  88.                            screen. (Use this when you lose a window).
  89.             => Cycle       Pulls the rearmost window of the desktop (the  one
  90.                Windows     directly above the backdrop) to the front  of  the
  91.                            window stack.             
  92.             => Cycle       Pulls all the windows belonging to the  task  that
  93.                Tasks       owns the rearmost window of the desktop  (the  one
  94.                            directly above the backdrop) to the front  of  the
  95.                            window stack.             
  96.  
  97. User        =>             Submenu Leading to User defined Menu Tree. To edit
  98.                            this, edit the file 'MenuData' In Prefs.
  99.                            
  100. Map...                     This opens  the  window  map.  This  displays  the
  101.                            position of all windows open on the  desktop,  and
  102.                            contains the icons controlling rooms.
  103.  
  104. Config...                  This opens the configuration window. This can also
  105.                            be achieved by clicking on the icon bar  icon  (if
  106.                            selected)
  107.  
  108. Quit                       This quits !Larger.
  109.  
  110. From the backdrop:
  111. ------------------
  112.  
  113. Larger      =>             This leads  to  the  same  menu  as  is  given  by
  114.                            clicking on the icon bar icon.
  115.  
  116. Dir. 'xxx'/ =>             This option leads to a menu offering the  standard
  117. File 'xxx'/                RISC OS filer menu options, with the  addition  of
  118. Selection                  the following:
  119.  
  120.             => Display => Sprite     Allows the sprite used for each icon  to
  121.                                      be configured.
  122.             
  123.                        => Icon Text  Turns icon text on or off.
  124.  
  125.             => Drag Onto   This  allows  the  item  over  which  the menu was
  126.                            opened to have its 'Drag Onto' flag toggled.
  127.             => Open Parent This  opens the directory containing the icon over
  128.                            which the menu was opened.
  129.             => Ctrl Key    This allows you to set a Key so that Ctrl and that
  130.                            Key will 'run' that item.
  131.             => Pre Params  This accepts parameters  which  will  be  inserted
  132.                            after the command to be executed, and  before  the
  133.                            filename of the file dragged onto the  icon.  Thus
  134.                            if 'tar' is sat on the back drop, and  a  file  is
  135.                            dragged onto  it,  and  the  required  command  is
  136.                            'tar -xvf  <Filename>',  then  the  pre  paramater
  137.                            string should be set to -xvf. This option is  only
  138.                            used if a file is dragged to  the  icon,  and  the
  139.                            drag onto flag is set.
  140.             => Post Params This performs the same operation  as  Pre  Params,
  141.                            but inserts the  parameters  after  the  filename.
  142.                            The same conditions of use apply.
  143.             => Run With    This option allows the user to run an  application
  144.                            with  a  specific  string  passed   to   it.   The
  145.                            application will be invoked with a command  string
  146.                            consisting of:
  147.                            <Command> <Pre params> <Run With> <Post Params>
  148.                            This enables applications to be run with  (say)  a
  149.                            list of filenames.
  150.  
  151. The Delete option is replaced by:
  152.  
  153.             => Remove Item This removes the item from the backdrop.
  154.  
  155. Select All  =>             This selects all the icons on the backdrop.
  156.  
  157. Clear       =>             This deselects all the icons on the backdrop.
  158.   Selection
  159.  
  160. Options     => Confirm     These  options  behave  exactly  as  their   Filer
  161.                Verbose     counterparts do,  but  affect  only  multi-tasking
  162.                Force       filer operations started by !Larger.
  163.                Newer
  164.  
  165. New Backdrop=>             This creates a new backdrop. Clicking on this icon
  166.                            changes to a new backdrop,  associated  with  this
  167.                            icon.
  168.  
  169. Open Parent                This option takes us  back  up  the  heirarchy  of
  170.                            backdrops, to the Parent backdrop of  the  current
  171.                            backdrop.
  172.  
  173. Configuration Window:
  174. =====================
  175.  
  176. This allows fine tuning of the !Larger Application for individual users.  The
  177. possible options are listed below:
  178.  
  179. Organisation
  180. ------------
  181.               None:      If selected, no gravity is applied to icons  on  the
  182.                          backdrop.
  183.               Automatic: Gravity is always applied to icons on the  backdrop,
  184.                          according to the settings below.
  185.  
  186. Apps Gravity  Left       This  sets the  direction  of  gravity  to  use  for
  187.               Right      Applications or data files if automatic organisation
  188.               Up         is selected.
  189.               Down
  190.               None
  191.  
  192. Dirs Gravity  Left       This  sets the  direction  of  gravity  to  use  for
  193.               Right      directories  or  image  filing  system   files,   if
  194.               Up         automatic organisation is selected.
  195.               Down
  196.               None
  197.  
  198. Backdrop Gvty Left       This  sets the  direction  of  gravity  to  use  for
  199.               Right      sub-backdrop icons,  if  automatic  organisation  is
  200.               Up         selected.
  201.               Down
  202.               None
  203.  
  204. Iconised Gvty Left       This  sets the  direction  of  gravity  to  use  for
  205.               Right      iconised windows or tasks, if automatic organisation
  206.               Up         is selected.
  207.               Down
  208.               None
  209.  
  210. Display       
  211. -------
  212.  
  213. Show App Names           If selected, the names of applications are displayed
  214.                          beneath their icons.
  215. Show Plinths             If selected, plinths are drawn behind  the  backdrop
  216.                          icons.
  217. Install On Iconbar       If  selected,  !Larger  installs  an  Icon  on   the
  218.                          iconbar.
  219. Invert Selections        If selected, selected icons  on  the  backdrop  have
  220.                          their sprites inverted.
  221. 'Slab in' Selections     If selected, selected icons  on  the  backdrop  have
  222.                          their plinths (if any) replaced by  a  'Slabbed  in'
  223.                          plinth.
  224. Small Icons         If selected, small icons are  displayed  instead  of
  225.                          the standard sized ones.
  226. Colour of Icon text      This item gives access to a menu on which  the  icon
  227.                          text colourcan be selected.
  228. Backdrop Background      This item gives access to a menu on which the colour
  229.                          of the backdrop background can be selected.
  230.  
  231. When Opening Directories
  232. ------------------------
  233.  
  234. Open Filer Window        If selected, then double clicking a directory on the
  235.                          backdrop, will open the corresponding filer window.
  236. Set CSD                  If selected, then double clicking a directory on the
  237.                          backdrop, will set the CSD to that directory.
  238.  
  239. Virtual Desktop
  240. ---------------
  241.  
  242. Scroll around Screen     If selected, then the virtual  desktop  facilites of
  243.                          !Larger are turned on.
  244. With Shift               If selected, then Shift must be  held  down,  before
  245.                          the virtual desktop  will  scroll.  This  option  is
  246.                          greyed out, if Scroll around Screen is not selected.
  247. Automatic                If selected, then pushing the  pointer  against  the
  248.                          edge of the screen will cause the desktop to scroll.
  249.                          This option is greyed out if Scroll around Screen is
  250.                          not selected.
  251. Open Map at Startup      If selected, then the window map will be opened when
  252.                          !Larger starts up, at the position it was  when  the
  253.                          configuration was last saved.
  254.  
  255. Backdrop Saving
  256. ---------------
  257.  
  258. Selective Sprite Save    If selected, then the sprites saved from the desktop
  259.                          by the '[Larger =>] Save  =>  Sprites'  option,  are
  260.                          filtered before saving, so that only sprites used on
  261.                          the backdrop are saved.
  262. + Filetype Sprites       If selected, then in addition to the  sprites  saved
  263.                          according to the previous option, all known filetype
  264.                          sprites are saved as well.
  265.  
  266. Backdrop Sprite
  267. ---------------
  268.  
  269. Sprite                   If selected, then a  backdrop  sprite  is  used.  To
  270.                          select this option, drop a spritefile onto the  Load
  271.                          Point. The first sprite in this file will be used as
  272.                          a backdrop sprite.
  273. Centred                  If selected, this option centres the backdrop sprite
  274.                          within the desktop screen  (not  including  the area
  275.                          used by the iconbar). This option is greyed  out  if
  276.                          Sprite is not selected.
  277. Tiled                    If selected, this option tiles the  backdrop  sprite
  278.                          within the desktop screen (not  including  the  area
  279.                          used by the iconbar). This option is greyed  out  if
  280.                          Sprite is not selected.
  281. Scaled                   If selected, this option scales the backdrop  sprite
  282.                          to fill the desktop screen (not including  the  area
  283.                          used by the iconbar). This option is greyed  out  if
  284.                          Sprite is not selected.
  285.                          
  286. Cache Sprite for Speed   If selected, the current backdrop sprite  is  cached
  287.                          for the current mode to improve redraw  speed.  This
  288.                          costs memory, and requires disc accesses on  palette
  289.                          and mode changes, but is  much  faster  than  normal
  290.                          redraw mode.
  291.  
  292. HotKeys
  293. -------
  294.  
  295. Hide Task                The key shown here is the hotkey for hiding a  tasks
  296.                          window. To change the key, click  in  the  icon  and
  297.                          hit  the  required  key  combination.   Default   is
  298.                          Shift-Tab.
  299. Set CSD                  The key shown here is the hotkey that sets  the  CSD
  300.                          to the  directory/parent  directory  of  the  window
  301.                          under the pointer. This key can  be  set  as  above.
  302.                          Default is Ctrl-Tab.
  303. Cycle Windows            The key shown here is the hotkey  for  bringing  the
  304.                          rearmost window of the desktop to  the  front.  This
  305.                          can be set as above. Default is Ctrl-Shift-Tab.
  306. Cycle Tasks              The key shown here brings all the windows  belonging
  307.                          to the task with the rearmost window to  the  front.
  308.                          Repeatedly pressing this key will cycle through  the
  309.                          currently running tasks. This  key  can  be  set  as
  310.                          above. Default is Print.
  311. Front Key                The key shown here is the  hotkey  for  pulling  the
  312.                          window under the mouse pointer to the front  of  the
  313.                          window stack. If the window is at the front  of  the
  314.                          stack, then it is sent to the back. This key can  be
  315.                          set as above. Default is Insert.
  316. Grab next key            The key show here is a hotkey that grabs  the  input
  317.                          focus for one keypress. The first time this  key  is
  318.                          pressed, !Larger grabs the  input  focus.  If one of
  319.                          !Largers other  hotkeys  is  then  pressed  it  will
  320.                          perform the appropriate action. If  another  key  is
  321.                          then pressed (such as the Grab next key hotkey),  it
  322.                          will be passed along to the wimp as usual. This  key
  323.                          is intended to relieve the problems with key clashes
  324.                          between applications, as  !Largers  hotkeys  can  be
  325.                          prefixed by this hotkey. By default this key is  not
  326.                          set, though f12 is a reasonable choice for  it.  (So
  327.                          to get the command line you must then type f12, f12)
  328.  
  329. Back to Front            This option toggles the  backdrop  window  from  the
  330.                          back to the front of the window stack.
  331.  
  332. Desktop Options
  333. ---------------
  334.  
  335. Click to type            When  selected,  the  caret  can  be  moved  between
  336.                          windows by clicking where you want the caret  to  go
  337.                          (This is normal Acorn Caret behaviour).
  338. Move Focus With Pointer  When selected, the caret will automtically be  moved
  339.                          to be in the window below the pointer at all times.
  340.  
  341. All these preferences can be saved, by clicking 'Save' in the config  window,
  342. and the previously saved preferences can be loaded  by  clicking  'Load'.  To
  343. close the preferences window, and to use the currently set preference values,
  344. click 'OK'.
  345.  
  346. To Copy !Larger without any saved data:
  347. =======================================
  348.  
  349. 1) Drag !Larger to new disc
  350. 2) Delete all files in !Larger.Internal
  351. 3) Delete all files except 'MenuData' and 'Prefs' in !Larger.Prefs
  352.  
  353. Remember! Any copies you make have YOUR serial number on.
  354.  
  355. Copyright Notice:
  356. =================
  357.  
  358. !Larger is (c) 1991-1994 Warm Silence Software, all rights reserved.
  359.  
  360. This version of !Larger is available to registered users ONLY, and may not be
  361. copied except for the purposes of backup, or installation on harddrives.
  362.  
  363. Site licenses for !Larger may be obtained (normally free of charge  over  and
  364. above single user copies) by applying to the author in writing. Site licences
  365. MUST be applied for - They are not granted automatically. This is so  I  know
  366. how the program is being used, and that the site license system is not  being
  367. abused.
  368.  
  369. I hereby reserve the right to take action  against  any  person,  persons  or
  370. company which infringes the above conditions. Applications for permission  to
  371. distribute contrary to these  conditions  may  be  made  in  writing,  or  by
  372. electronic mail to the addresses given below.
  373.  
  374. This software is provided 'as is', with no guarantee of its  suitability  for
  375. any purpose. I will accept no responsibility for any data  lost  while  using
  376. this program. NO WARRANTY IS GIVEN!
  377.  
  378. If  you  do change the code at all, please let me know, as I refuse to try to
  379. support  other  peoples modifications unless I have been told about them, and
  380. I will probably be interested.
  381.  
  382. If anyone has any ideas on improvements or new features for !Larger,  however
  383. strange they may seem, please get in touch  with  me,  as  they  will  almost
  384. always be useful to someone else. I will try and implement  anything  (within
  385. reason) that people want.
  386.  
  387. Addresses To Contact the Author:
  388. ================================
  389.  
  390. Warm Silence Software,
  391. St Catherines College,
  392. Manor Road,
  393. Oxford,
  394. OX1 3UJ
  395.  
  396. By Janet: Robin.Watts@uk.ac.oxford.prg
  397.  
  398. (If all else fails try:
  399.  
  400. 217 Waterhouse Moor,
  401. Harlow,
  402. Essex,
  403. CM18 6BW)
  404.  
  405.  
  406. Thanks Go to:
  407. =============
  408.  
  409. Special Thanks to: Aidan Corey,
  410.                    Martin Ebourne,
  411.                    Ian Fry,
  412.                    Lee McGinty,
  413.                    Mark Greenwood,
  414.                    Dom Layfield,
  415.                    Simon Middleton,
  416.                    Simone Pharoah,
  417.                    Bryan Scattergood,
  418.                    Matt Segall,
  419.                    Fred Shaerlig,
  420.                    Steve Singer,
  421.                    Dom Symes,
  422.                    Alex T,
  423.                    CT,
  424.                    Mark Vevers,
  425.                    Tommy Wareing,
  426.                    and far to many other people to mention here.
  427.