home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 1 / RISC_DISC_1.iso / pd_share / utilities / resizer / !Resizer / !Help next >
Encoding:
Text File  |  1994-08-22  |  10.5 KB  |  258 lines
  1.                                 Forward>>Motion
  2.                     Window Resizer - Microsoft Windows-Style
  3.  
  4.                         © Nick Jarman Thu,24 Dec 1992
  5.  
  6.                      This software is in the public domain
  7.  
  8.  
  9.      Important Note
  10.      --------------
  11.      To use this program, you must have instant window dragging
  12.      enabled. This is the Risc OS 3.1 default so Resizer should work
  13.      correctly on most systems without the need for reconfiguration.
  14.      Use the Configure application in the Resources filing system to
  15.      set instant window dragging.
  16.  
  17.  
  18.      About the program
  19.      -----------------
  20.  
  21.      A Risc OS window looks something like this:
  22.  
  23.               +---+---+--------------------+---+
  24.               |[].| X |      A window      |'. |
  25.               +---+---+--------------------+---+
  26.               |                            | ^ |
  27.               |                            +---+
  28.               |                            |   |
  29.               |                            |   |
  30.               |                            |   |
  31.               |                            |   |
  32.               |                            |   |
  33.               |                            |   |
  34.               |                            |   |
  35.               |                            +---+
  36.               |                            | v |
  37.               +---+--------------------+---+---+
  38.               | < |                    | > |[']|
  39.               +---+--------------------+---+---+
  40.  
  41.      If you want to resize the window, you use the icon at the bottom
  42.      right hand corner (the resize icon), so it's only possible to expand
  43.      it downwards and to the right, or shrink it upwards and to the left.
  44.      Under Microsoft Windows, there are eight 'resize icons' all round the
  45.      window, so it's possible to expand or shrink it window in all
  46.      directions. I thought this would be a useful addition to Risc OS, so
  47.      I wrote this program...
  48.  
  49.  
  50.      How to use it
  51.      -------------
  52.  
  53.      Load RESIZER by double-clicking on its icon in the directory
  54.      viewer. The program will register itself as 'Resizer' on your
  55.      task display amd the Desktop will continue to operate as normal.
  56.      To give a window extra resize icons, position the pointer
  57.      anywhere over it and press the either left-hand or right-hand
  58.      Alt and Shift keys simultaneously. The result is something like
  59.      this:
  60.  
  61.               +-------+--------------------+-------+
  62.               | +---+-+-+------------------+-+---+ |
  63.               | |[].| X |      A window      |'. | |
  64.               | +---+---+--------------------+---+ |
  65.               +-+                            | ^ +-+
  66.               | |                            +---+ |
  67.               | |                            |   | |
  68.               | |                            |   | |
  69.               | |                            |   | |
  70.               | |                            |   | |
  71.               | |                            |   | |
  72.               | |                            |   | |
  73.               | |                            |   | |
  74.               | |                            +---+ |
  75.               +-+                            | v +-+
  76.               | +---+--------------------+---+---+ |
  77.               | | < |                    | > |[']| |
  78.               | +---+-+------------------+-+-+---+ |
  79.               +-------+--------------------+-------+
  80.  
  81.      The window can now be resized by dragging the resize icons which
  82.      have been attached to it. The pointer changes to indicate the
  83.      direction in which the window may be resized whenever it is over
  84.      a resize icon. Dragging a resize icon whilst holding down Shift
  85.      is equivalent to moving the window with the titlebar.
  86.  
  87.      RESIZER only provides an extra set of resize icons for one window
  88.      at a time but you may move them to another window whenever you
  89.      wish, using Alt and Shift. To remove the resize icons altogether,
  90.      press Alt and Shift when the pointer is over the window which they
  91.      are currently attached to. Only windows with a resize icon at the
  92.      bottom left hand corner can have extra resize icons attached.
  93.  
  94.  
  95.      Quitting
  96.      --------
  97.  
  98.      To quit RESIZER, click Menu on any of the resize icons and select
  99.      'Quit' from the menu that appears.
  100.  
  101.  
  102.      Configuration Options
  103.      ---------------------
  104.  
  105.      RESIZER has a number of user-definable settings. To change these
  106.      click Menu on any of the resize icons and select the Preferences
  107.      option. A window appears, allowing you to alter the following
  108.      settings:
  109.  
  110.      - Border width: The width of the resize icons round the window.
  111.        If you are having difficulty locating the pointer over the over
  112.        the resize icons you may wish to increase the value of this
  113.        variable.
  114.  
  115.      - Corner size: This determines the size of the four corner boxes.
  116.  
  117.      - Sleep time: Changing this variable allows you to alter the
  118.        responsiveness of RESIZER. It is the longest time (in centiseconds)
  119.        for which RESIZER will give control of the machine to other
  120.        programs running in the background (although it is quite possible
  121.        that other programs may choose to 'hog' the machine so RESIZER
  122.        will run even more slowly). If you find your desktop feels
  123.        considerably slower with RESIZER loaded (although there is no
  124.        reason why it should with a default Sleep time of 7), try increasing
  125.        its value. You may notice that you have to old Alt and Shift down
  126.        for longer to make the resize icons appear, and there may be a
  127.        perceivable delay in changing the shape of the pointer.
  128.  
  129.      - Absolute dragging: With Absolute dragging enabled, RESIZER keeps
  130.        the contents of the window stationary on the screen, and with it
  131.        disabled, the contents of the window are moved relative to the
  132.        edge(s) being dragged. If you find it difficult to understand this
  133.        description, open the task display and resize it with Absolute
  134.        dragging enabled and disabled. This option does not work properly
  135.        with Edit - but that's a problem with Edit rather than RESIZER.
  136.  
  137.      You can save your configuration by clicking the Save button, so you
  138.      won't have to alter the settings every time you load the program. The
  139.      Cancel button returns the settings to the state they were in before
  140.      the Preferences window was opened, and the OK button makes RESIZER
  141.      remember your setings but does not save them.
  142.  
  143.  
  144.      What's wrong with it
  145.      --------------------
  146.  
  147.      Nothing serious, fortunately, but here are some aspects that could
  148.      be improved:
  149.  
  150.      - When a window is at its maximum size, attempting to enlarge it moves
  151.        it across the screen. It should really stay stationary.
  152.      - It's a bit slow - especially if you don't have an ARM3!
  153.      - It doesn't work very well with Edit: Normal/Absolute dragging don't
  154.        seem to work as they should because the vertical scrollbar is
  155.        handled differently.
  156.      - Ran Mokady's USAGE program sometimes reports RESIZER is using 100%
  157.        of CPU time. This seems to happen whenever the Desktop is restarted
  158.        after being shut down - so low CPU usage (it should be around 0.2 -
  159.        0.6% on an ARM3 machine with a Sleep time of 7 and no resize icons
  160.        on a window) is only reported the first time the Desktop is used
  161.        after power-on, or after a shutdown followed by *Fx 200,3 and a hard
  162.        reset. I have not been able to determine whether this is a problem
  163.        with RESIZER or USAGE. If anyone can work out what is going on I
  164.        would like to know!
  165.      - There's no reason why it shouldn't provide borders for all
  166.        resizable windows... watch out for this feature in the next version!
  167.      - It would look even better if it used textured icons (like Acorn's
  168.        new Toolsprites set).
  169.  
  170.      I'm sure I'll think of more improvements as soon as I've finished
  171.      writing this - if you can think of any improvements or have any
  172.      comments about the program please let me know.
  173.  
  174.  
  175.      Versions
  176.      --------
  177.  
  178.      V0.00 - V1.00 (Late Dec 1992 - mid Feb 1993)
  179.      Developement versions. These used a window with eight icons for the
  180.      border. Pointer changing and all window redrawing was done by the
  181.      window manager, but resizing was very slow because the position of
  182.      each icon had to be calculated each time the window was redrawn.
  183.      Movement of the border window was not perfect - it stayed stationary
  184.      when the one in front of it was moved and only caught up when the
  185.      mouse button was released.
  186.  
  187.      V1.00 (mid Feb 1993)
  188.      Window movement problems cured by making the program handle all
  189.      redrawing of the border window. This meant that windows could be
  190.      resized faster because there was no need to calculate the new
  191.      positions of each of the icons. Window movement is now also handled
  192.      correctly. Menu with Info and Quit options added.
  193.  
  194.      V1.10 (Wed,24 Feb 1993)
  195.      Null event operation was inefficient, so this has been tidied up so
  196.      the program has control of the machine for as short a time as
  197.      possible. Absolute dragging and Preferences dialogue box added.
  198.  
  199.      V1.11 (Mon,01 Mar 1993)
  200.      Border is now highlighted in when its window has the caret. The
  201.      border will cannot now be attached to a window unless it is resizable
  202.      to start off with, ie: it has a resize icon.
  203.  
  204.      V1.12 (Tue,02 Mar 1993)
  205.      Window movement using Shift key added.
  206.  
  207.  
  208.      Legal Stuff
  209.      -----------
  210.  
  211.      'RESIZER' refers to all the files in the !Resizer directory.
  212.  
  213.      RESIZER is in the public domain, but I (Nick Jarman) hold the
  214.      copyright to RESIZER. You may copy and distribute RESIZER freely as
  215.      long as:
  216.  
  217.         1) You do not charge for doing so, except to cover the cost of
  218.            media
  219.  
  220.         2) You do not alter any part of RESIZER
  221.  
  222.         3) RESIZER is copied in its entireity
  223.  
  224.      I accept no responsibility for any loss or damage arising from
  225.      the use of RESIZER.
  226.  
  227.      Directory contents:
  228.  
  229.         !Help
  230.         !Run
  231.         !RunImage
  232.         !Sprites
  233.         Pointers
  234.         Preference
  235.         Sprites
  236.         Templates
  237.  
  238.  
  239.      The Author
  240.      ----------
  241.  
  242.      Comments, bug reports etc are all welcome - send correspondence to:
  243.  
  244.      Snail mail: Nick Jarman
  245.                  Grizedale College
  246.                  Lancaster University
  247.                  Lancs
  248.                  LA1 4YU
  249.                  UK
  250.  
  251.              or: Nick Jarman
  252.                  7 Cadet Way
  253.                  Church Crookham
  254.                  FLEET
  255.                  Hants
  256.                  GU13 0UG
  257.  
  258.           Janet: csc329@lancaster.ac.uk