home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 83 / af083a.adf / XSize32 / XSize.doc < prev    next >
Text File  |  1995-04-10  |  6KB  |  189 lines
  1.  
  2.                         XSize 3.2 - Documentation 
  3.  
  4.                               (10.04.95)
  5.                         
  6. COPYRIGHT
  7.  
  8.   This program is © 1994-95 by Carsten Melberg and Günther Rehm.
  9.   Based on XSize 1.0 (© 1990 by Mikael Karlsson).
  10.  
  11.  
  12. NOTES
  13.  
  14.   XSize was developed under AmigaOS 3.1 but it will run under 
  15.   AmigaOS 2.x/3.x and it also runs under Kickstart 1.x (hopefully).
  16.   Under AmigaOS 2.x/3.x XSize will be a commodity.
  17.   The code was produced with SAS/C Version 6.55. 
  18.  
  19.  
  20. INTRODUCTION
  21.  
  22.   XSize is a tool which allows you to resize any (sizeable) window in
  23.   a X-Windows like manner. It is possible to size the window in all directions
  24.   not only like the AmigaOS standard to the right and to the bottom.
  25.  
  26.   There are two ways of initiating the window sizing:
  27.  
  28.     1. Press and hold the left mouse button over the sizing
  29.        gadget in a window.
  30.     2. Press and hold the specified qualifier and press and
  31.        hold the left mouse button anywhere in the window.
  32.  
  33.     A sizing frame is drawn over the window. It looks like this:
  34.  
  35.     +---+---+---+
  36.     |   |   |   |
  37.     +---+---+---+
  38.     |   |   |   |
  39.     +---+---+---+
  40.     |   |   |   |
  41.     +---+---+---+
  42.  
  43.     You can now move the mouse around (while still holding down
  44.     the left mouse button, it's ok to release the qualifier if
  45.     you used that way of initiating XSize) freely inside the frame.
  46.     Nothing happens until you reach an (outer) edge of the frame.
  47.     When you do, that edge starts to follow the mouse. Now only one
  48.     edge follows the mouse. If you move the mouse to a corner the
  49.     second edge that forms the corner also starts to follow the mouse.
  50.     To change the active edge hold down the right mouse button,
  51.     move to another edge and release the right mouse button.
  52.  
  53.  
  54. INSTALLATION
  55.  
  56.   To install XSize just put in any directory or drop the Icon into the 
  57.   WBStartup drawer, if you like it to start every time you reboot.  
  58.  
  59.  
  60. USAGE
  61.  
  62.   To start XSize:
  63.  
  64.   CLI: XSize <QUALIFIER>   (use 'run >NIL:' to detache) 
  65.  
  66.   WB:  Tooltypes: QUALIFIER=<hex>
  67.                   TOOLPRI=<Priority of Task>
  68.                   STARTPRI=<Startpriority in WBStartup>
  69.                   DONOTWAIT (to detache)
  70.  
  71.   QUALIFIERS (always entered in HEX) 
  72.  
  73.     0001    Left Shift
  74.     0002    Right Shift
  75.     0004    Caps Lock
  76.     0008    Control
  77.     0010    Left Alt
  78.     0020    Right Alt
  79.     0040    Left Amiga Key
  80.     0080    Right Amiga Key
  81.     0100    Numeric Key Pad Key (not useful)
  82.     0200    Repeat              (not useful)
  83.     0400    Interrupt           (not useful)
  84.     0800    Multibroadcast      (not useful)
  85.     1000    Middle Mouse Button 
  86.     2000    Right Mouse Button
  87.     4000    Left Mouse Button
  88.  
  89.     Note: Combinations are allowed, in which case any one of the
  90.           elected qualifiers along with the left, right mouse button
  91.           will cause the appropriate action to occur.
  92.  
  93.  
  94.   To stop XSize simply run it again (from CLI or WB).
  95.   
  96.   AmigaOS 2.x/3.x:
  97.  
  98.     As noted before XSize will be a commodity, if started under
  99.     AmigaOS 2.x/3.x. This means you have some special functions to
  100.     enable or disable XSize (for further information about this see
  101.     the EXCHANGE program documentation in your Amiga handbook).
  102.  
  103.  
  104. DISTRIBUTION
  105.  
  106.   XSize may be freely distributed, as long as no charge is made other
  107.   than to cover time and copying costs (US $5). The package must be 
  108.   distributed as the original archive. If you want to include XSize as 
  109.   part of a commercial package, contact the authors listed below. Fred Fish 
  110.   is specifically given permission to include XSize in his fine disk 
  111.   library (also CD). It is also allowed to put XSize on free accessible 
  112.   BBS's or Internet sites. 
  113.   It is absolutely forbidden to change anything in this archive, although 
  114.   XSize is some kind of FreeWare it is still © by the authors!
  115.  
  116.  
  117. LEGAL DISCLAIMER
  118.  
  119.   WITH  THIS  DOCUMENT  WE  MAKE  NO  WARRANTIES  OR  REPRESENTATIONS, EITHER
  120.   EXPRESSED  OR  IMPLIED,  WITH RESPECT TO THE PRODUCT DESCRIBED HEREIN.  THE
  121.   INFORMATION  PRESENTED  HEREIN IS BEING SUPPLIED ON AN "AS IS" BASIS AND IS
  122.   EXPRESSLY  SUBJECT TO CHANGE WITHOUT NOTICE.  THE ENTIRE RISK AS TO THE USE
  123.   OF  THIS INFORMATION IS ASSUMED BY THE USER.  IN NO EVENT WILL WE BE LIABLE
  124.   FOR  DIRECT,  INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING FROM
  125.   ANY  CLAIM ARISING OUT OF THE INFORMATION PRESENTED HEREIN, EVEN IF WE HAVE
  126.   BEEN ADVISED OF THE POSSIBILITIES OF SUCH DAMAGES.
  127.  
  128.  
  129. CARDWARE
  130.  
  131.   If you like this little program and use it, please send us a postcard to
  132.   the addresses below.
  133.  
  134.  
  135. AUTHOR
  136.  
  137.   Snailmail and Postcards:
  138.  
  139.     Carsten Melberg             Günther Rehm      
  140.     Nuernberger Strasse 76      Am Färberhof 6    
  141.     91052 Erlangen              91052 Erlangen  
  142.     Germany                     Germany           
  143.  
  144.   Email:
  145.  
  146.   cnmelber@cip.informatik.uni-erlangen.de 
  147.   IRC: Paulmut (frequently on #amiga and #amigager)
  148.  
  149.   grrehm@cip.e-technik.uni-erlangen.de    
  150.   IRC: Gue on (sometimes on #amiga and #amigager, frequently on #chocolate)
  151.  
  152.  
  153. HISTORY
  154.  
  155.   Version 1.0 © 1990 Mikael Karlsson (t.y.v.m.!)
  156.  
  157.   Version 2.0 - new enhancend argument parsing 
  158.               - ToolType support for WB
  159.               - reduced code size 
  160.               - removed strange detaching :-)
  161.  
  162.   Version 3.0 - added commodity support for AmigaOS 2.x/3.x
  163.               - added German documentation
  164.               - totally rewritten main program
  165.               - some optimizing to keep the code small
  166.               - still Kickstart 1.x compatible
  167.                 (I don't why I have done this :-))
  168.  
  169.   (never released)
  170.   Version 3.1 - fixed bug: QUALIFIER was lost after (new) activating via EXCHANGE
  171.               - fixed bug: program crashed, if en-/disabled two times (only
  172.                            possible with CycleToMenu)
  173.                      
  174.   Version 3.2 - fixed bug: XSize does no longer crash, if the resizing
  175.                            window is closed by an event
  176.  
  177.  
  178. TODO
  179.  
  180.   This is your part !
  181.  
  182.  
  183. BUGS
  184.  
  185.   I hope none...
  186.  
  187.  
  188.                     'Only Amiga makes it possible' sure it does...
  189.