home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / amigalibdisks / disk947 / smaus / smaus.doc < prev    next >
Text File  |  1993-12-21  |  23KB  |  539 lines
  1.  
  2.  
  3.  
  4.  
  5.                                Documentation
  6.  
  7.                                     for
  8.  
  9.                                    SMaus
  10.  
  11.  
  12.  
  13.                     Copyright © 1991-1993 Stefan Sticht
  14.  
  15.                             All rights reserved
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                                  Shareware
  23.  
  24.      SMaus is shareware. SMaus is not freeware. If you use  SMaus  you
  25.      must register your copy.
  26.  
  27.  
  28.                                Registration
  29.  
  30.      To  register  your  copy  of  SMaus  print  out  the  file  named
  31.      "Registration", fill it out and send  it  to  me  along  with  an
  32.      euro-cheque, money order or cash.  The  registration  fee  is  US
  33.      $5.-/DM 5.-.
  34.  
  35.  
  36.                                 No warranty
  37.  
  38.      THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED  BY
  39.      APPLICABLE LAW. EXCEPT  WHEN  OTHERWISE  STATED  IN  WRITING  THE
  40.      COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE  THE  PROGRAM  "AS
  41.      IS" WITHOUT WARRANTY OF ANY KIND, EITHER  EXPRESSED  OR  IMPLIED,
  42.      INCLUDING,  BUT  NOT  LIMITED  TO,  THE  IMPLIED  WARRANTIES   OF
  43.      MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE  ENTIRE
  44.      RISK AS TO THE QUALITY AND PERFORMANCE OF  THE  PROGRAM  IS  WITH
  45.      YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE  COST  OF
  46.      ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  47.      IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW  OR  AGREED  TO  IN
  48.      WRITING WILL ANY COPYRIGHT HOLDER, OR ANY  OTHER  PARTY  WHO  MAY
  49.      REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR
  50.      DAMAGES,  INCLUDING   ANY   GENERAL,   SPECIAL,   INCIDENTAL   OR
  51.      CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO  USE
  52.      THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF  DATA  OR  DATA
  53.      BEING RENDERED INACCURATE OR LOSSES SUSTAINED  BY  YOU  OR  THIRD
  54.      PARTIES OR A FAILURE OF THE PROGRAM TO  OPERATE  WITH  ANY  OTHER
  55.      PROGRAM), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED  OF
  56.      THE POSSIBILITY OF SUCH DAMAGES.
  57.  
  58.  
  59.                                Distribution
  60.  
  61.      You may copy and distribute  verbatim  copies  of  the  program's
  62.      executable code and documentation  as  you  receive  it,  in  any
  63.      medium, provided that you conspicuously and appropriately publish
  64.      only the original, unmodified program, with all copyright notices
  65.      and  disclaimers  of  warranty  intact  and  including  all   the
  66.      accompanying documentation, example files and anything else  that
  67.      came with the original. You may only charge a small fee  for  the
  68.      costs  of  media,  handling  and  postage.  SMaus  may   not   be
  69.      distributed along with or as part of commercial products  without
  70.      a license from the author.
  71.  
  72.      SMaus_nowin is a special version of SMaus  without  a  graphical
  73.      user interface. Everything said for SMaus applies to SMaus_nowin,
  74.      too.
  75.  
  76.  
  77.                                Introduction
  78.  
  79.      SMaus has been written to replace the commodity AutoPoint,  which
  80.      is part of AmigaOS 2.0 and above. SMaus is highly configurable.
  81.  
  82.      The primary purpose  is  to  activate  windows  under  the  mouse
  83.      pointer. There  are  different  actions  which  will  activate  a
  84.      window:
  85.  
  86.      Mouse movement: while or after moving the mouse the window  under
  87.      the pointer gets activated. You can select a  speed  below  which
  88.      windows get activated. If you move the mouse fast, no window gets
  89.      activated. If you move the mouse slowly, the  windows  under  the
  90.      mouse  get  activated.  In  the  one  extrem,  windows  only  get
  91.      activated after  you  stopped  the  mouse  movement.  This  helps
  92.      minizing the "jumping" of the pointer on 68000 based Amigas  when
  93.      a window gets activated, because AmigaOS has to redraw the border
  94.      of the window which got activated and has no time left for moving
  95.      the pointer. After the  border  has  been  redrawn,  the  pointer
  96.      jumps. On faster Amigas, e.g. the A3000, the  "jumping"  is  less
  97.      noticable, at least when you  move  the  mouse  slowly.  On  this
  98.      machines you can allow SMaus to activate windows at once, as long
  99.      as you move the mouse slowly.
  100.  
  101.      Time: Unfortunately SMaus and Autopoint can't be informed by  the
  102.      OS, if a new window or screen has been opened or the front screen
  103.      has been changed. Therefore SMaus and Autopoint  always  have  to
  104.      look which window is under the  mouse  pointer  after  a  certain
  105.      time. This technic is known as "polling" and  must  be avoided on
  106.      multitasking operating systems like AmigaOS. But  as  the  window
  107.      under the mouse pointer should be active, SMaus  for  example has
  108.      to test if another window opened active and the window under  the
  109.      pointer has to be reactivated, etc. With SMaus you can select the
  110.      time, after which SMaus tests this, or  disable  this  option  at
  111.      all. You may increase the timeout to minimize CPU usage. With the
  112.      additional option "Keypress" (described below) you may  select  a
  113.      great timeout without disadvantages.
  114.  
  115.      Keypress: If you like it, SMaus activates the  window  under  the
  116.      pointer at any key pressed.
  117.  
  118.      Mousemovement by keyboard: SMaus recognizes  mousemovements  done
  119.      by keyboard using  an  Amiga  key  and  the  cursor  keys.  SMaus
  120.      activates the window under the pointer after movement.
  121.  
  122.      Often it would be better not to activate  the  window  under  the
  123.      pointer. The  following  options disable  the  window  activation
  124.      temporarily:
  125.  
  126.      Window title: you can specify titles of windows, which are  never
  127.      to  be  deactivated.  You  can  use  normal   AmigaOS   wildcards
  128.      therefore. Thus you can tell SMaus not to deactivate e.g. windows
  129.      called "System request" or "Arq", because you'd  like  to  answer
  130.      this requesters with the keyboard immediately.
  131.  
  132.      Screen title: like window titles, you may specify screen  titles.
  133.      If the screen title of the frontmost screen matches,  SMaus  does
  134.      nothing on this screen.
  135.  
  136.      System  requesters:  they  don't  get  deactivated.  This  option
  137.      doesn't work with some requester replacements like "Arq".
  138.  
  139.      Already active windows don't get activated  again.  SMaus  has  a
  140.      graphical user interface for easy configuration. You can  save  a
  141.      configuration and load it. SMaus has been  programmed  respecting
  142.      the rules of AmigaOS. No OS functions get patched. SMaus has been
  143.      programmed on an A3000 with SAS/C and has been  tested  with  the
  144.      debugging tools Enforcer and Mungwall.
  145.  
  146.  
  147.                             System requirements
  148.  
  149.      SMaus requires at least AmigaOS 2.04, Kickstart  version  37.175.
  150.      If you have Workbench 2.1, version 38.xx or better, you can use a
  151.      localized user interface. This means SMaus uses messages in  e.g.
  152.      german language. SMaus will not work with AmigaOS 1.2 or 1.3.
  153.  
  154.  
  155.                               Starting SMaus
  156.  
  157.      Before you test  SMaus,  please  make  sure  you're  not  running
  158.      autopoint at  the  same  time.  Remove  autopoint  by  using  the
  159.      Commodities Exchange utility provided by AmigaOS.
  160.  
  161.      You may start SMaus either from Shell or by  double  clicking  on
  162.      its icon. If you haven't changed any tool type in  SMaus's  icon,
  163.      double clicking on it starts SMaus and tells the program to  open
  164.      its window immediately. As SMaus can't run  twice  simultanously,
  165.      because there's no sense in doing so. Starting SMaus  twice  will
  166.      tell the first running copy of SMaus to open its window.  If  you
  167.      want to start SMaus from the shell and be able to close the shell
  168.      afterwards, use
  169.  
  170.                            Run >NIL: <path>SMaus
  171.  
  172.      to start it.
  173.  
  174.      Now it's time to explain the various options:
  175.  
  176.  
  177.                                   Options
  178.  
  179.      Activation Threshold:
  180.  
  181.      With the top most slider in SMaus's window  you  can  change  the
  182.      threshold for the speed of mouse movement,  above  which  windows
  183.      don't get activated at once. The speed of movement is measured in
  184.      pixel/event. Just test this: select a threshold of  0.  Now  move
  185.      the pointer across wi