home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 563.lha / Flanker_v1.0 / Flanker.doc.pp / Flanker.doc
Text File  |  1991-11-07  |  6KB  |  193 lines
  1.  
  2. Flanker.doc                                                     10/24/91
  3.  
  4.  
  5.  
  6.                                Flanker 1.0
  7.  
  8.                      Copyright © 1991 by Keith Young
  9.  
  10.                            All Rights Reserved
  11.  
  12.  
  13.  
  14.  
  15. Disclaimer
  16. ~~~~~~~~~~
  17.  
  18.    While every attempt has been made to insure the quality of this
  19. software...
  20.  
  21.     The author of this program (Keith Young) makes no warranty, expressed
  22. or implied, nor assumes any responsibility  for  accuracy,  completeness
  23. or usefulness of any information, product or process disclosed, or
  24. represents that its use will not infringe privately-owned rights. Mention
  25. of any product,  its manufacturer, or suppliers is not intended to imply
  26. approval, disapproval, or fitness for any particular use.
  27.  
  28.    The user of this software accepts full responsibility for any possible
  29. consiquences (sp) of using it.
  30.  
  31.  
  32. Other Legal Stuff
  33. ~~~~~~~~~~~~~~~~~
  34.  
  35.     "Amiga" and "AmigaDOS" are trademarks or registered trademarks of
  36.     Commodore-Amiga, Inc.
  37.  
  38.  
  39. Distribution
  40. ~~~~~~~~~~~~
  41.  
  42.    Flanker is 'FreeWare'.
  43.  
  44.    Flanker may be freely distributed throughout the galaxy with the
  45. following restrictions:
  46.  
  47.    ·  It must remain 'intact' (in archive form or unarced but in a
  48.       dedicated directory on disk) with the files listed below under
  49.       'Contents'.
  50.  
  51.    ·  It may not be distributed with commercial products without my prior
  52.       consent (if in doubt, contact me at the E-mail address below).
  53.  
  54.    ·  No charge can be made for this program above and beyond a reasonable
  55.       media and duplication cost when included on PD disks.
  56.  
  57.    ·  It may explicitly be included by Fred Fish in his fine collection
  58.       of software.
  59.  
  60.  
  61.  
  62. Contents
  63. ~~~~~~~~
  64.  
  65.    The following is a list of files in this distribution:
  66.  
  67.    ·  Flanker           -- The main binary program file.
  68.    ·  Flanker.info      -- An Icon for Flanker.
  69.    ·  Flanker.doc       -- The file you are reading now.
  70.    ·  Flanker.doc.info  -- An Icon for the file you are reading now.
  71.    ·  POSTER            -- A short text description of the program that
  72.                            can be used when uploading to BBS's.
  73.    ·  POSTER.info       -- An Icon for the above.
  74.  
  75.  
  76. Description
  77. ~~~~~~~~~~~
  78.  
  79.    Before switching to AmigaDOS 2.0, I used to use 'qmouse' to speed up
  80. my mouse, give me screen cycling and a few other features.
  81.  
  82.    Version 2.0 of the OS gave me most of those features, but there were
  83. a few that it didn't replace... when you cycled screens using qmouse,
  84. when the new screen popped up, the "last active window on that screen"
  85. was auto-magically reactivated.
  86.  
  87.    This (as well as 'mouse blanking'), is essentually what Flanker does.
  88. By default, it replaces the intuition key combination of Left-Amiga 'm'
  89. and when you cycle screens, it will activate the window on the new screen
  90. that was active when that particular screen was last in front.
  91.  
  92.    If it can't find the window that was last active, or it doesn't yet
  93. know about the screen, it will attempt to activate the 'top' window.
  94.  
  95.  
  96.   (NOTE: Flanker is actually a replacement of another 2.0 commodity
  97.          by me called 'Flip'... in case you were wondering, 'Flanker'
  98.             is short for "Screen Flipper / Mouse Blanker")
  99.  
  100.  
  101. Usage
  102. ~~~~~
  103.  
  104.    Flanker has been written as a 2.0 'commodity' program and thus
  105. requires version 2.0x of the OS to run.
  106.  
  107.    You should copy Flanker and Flanker.info to your commodities drawer
  108. and/or your WBtartup drawer (if you want it run at boot up).
  109.  
  110.    Operation is pretty straight-forward... one option that can be set by
  111. the user, is what key combination is used to cycle the screens.  The
  112. default combination used is Left-Amiga 'm' which replaces the built-in
  113. intuition screen flipper.
  114.  
  115.     The other function of Flanker is to blank the mouse after a certain
  116. amount of time has passed or when any key is pressed.  Once the mouse
  117. pointer has been blanked, it will un-blank any time the mouse is moved,
  118. a new screen/window opens (and becomes active) or most any other input
  119. event (other than keyboard use and timer events).
  120.  
  121.  
  122.    You can change the screen-flipping key combination by setting the
  123. CYCLE keyword to a new key combination as described in the A3000 user
  124. manual.
  125.  
  126.     Two other keywords operate the 'mouse blanking' feature...
  127.  
  128.     BLANKMOUSE=0
  129.     SECONDS=60
  130.  
  131.  
  132.     The default values for these keywords are:
  133.  
  134.     CYCLE=lcommand m    (replace the built-in screen-flipper)
  135.     BLANKMOUSE=1        (mouse blanking enabled)
  136.     SECONDS=10            (10 seconds before the pointer is blanked)
  137.  
  138.  
  139.     You can change any or all of these by...
  140.  
  141.  
  142.    From Workbench:
  143.  
  144.       Using the 'Information' feature of Workbench on the Flanker icon, set
  145.       up or change the various tooltypes to the values of your choice.
  146.  
  147.  
  148.    From the CLI:
  149.  
  150.       Pass the keyword=value on the command-line, for example...
  151.  
  152.       1> run Flanker "CYCLE=alt m"
  153.  
  154.       Note that when you do this from the CLI and you have spaces in the
  155.       string, you must inclose the string in quotes.
  156.  
  157.  
  158.    Once the program is running, you can manipulate (disable/enable or
  159. kill) it using the 'Exchange' commodity controller program.  Flanker also
  160. has a window that you can open to control the mouse blanking feature.
  161.  
  162.     To open it's window, either use the 'Show' option of the Exchange
  163. program or use the Hotkey combination (the hotkey combination is settable
  164. via the tooltypes of the icon using the keyword CX_POPKEY (default hotkey
  165. combination is "shift f1")).
  166.  
  167.  
  168.  
  169. Conclusion
  170. ~~~~~~~~~~
  171.  
  172.    I wrote this program because I wanted these particular functions... it
  173. was not intended to be a grab-bag of other features and I didn't take the
  174. time to worry about optimizing it or add any bells and whistles.
  175.  
  176.    I may or may not add to it in the future, so if you have any specific
  177. requests or bug reports, I can be reached on Compuserve as:
  178.  
  179.       Keith Young    CIS: 73170,307
  180.  
  181.  
  182. -------------------------------------------------------------------------
  183.  
  184.    "You never see the back side of any surface in a closed polyhedron
  185.     because they all face the invisable inside of it"
  186.  
  187.                         - Bruce Artwick
  188.  
  189. -------------------------------------------------------------------------
  190.  
  191.  
  192.  
  193.