home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / mucx136.lha / MultiCX.doc < prev    next >
Encoding:
Text File  |  1994-12-17  |  10.4 KB  |  300 lines
  1. ------------------------------------------------------------------------
  2.                         MultiCX 1.36 (17.12.94)
  3. ------------------------------------------------------------------------
  4.  
  5. MultiCX  is the smallest Multi-Function-Commodity for the Amiga, thought
  6. as  a  replacement  for  many  larger  and  sometimes  badly  programmed
  7. programs.  It is a 100% pure commodity, which means that it does not use
  8. any  patches (SetFunction), no interrupts and no special input handlers.
  9. So it can safely be disabled or removed at any time.
  10.  
  11. ------------------------------------------------------------------------
  12.                                 Features
  13. ------------------------------------------------------------------------
  14.  
  15. - Notification
  16.  
  17.   MultiCX  recognizes  any  changes  of  the ToolTypes while running, so
  18.   there's no real need for a GUI.
  19.  
  20. - Screen Blanker
  21.  
  22.   MultiCX  includes  a  simple but compatible screen blanker.  It always
  23.   uses  the  display  mode  which  fits best to the actual front screen,
  24.   while taking the lowest resolution with only one plane.
  25.  
  26.   ToolTypes:
  27.  
  28.   SCRBLANK=n            sets number of seconds until screen blanks,
  29.                         0 means OFF
  30.  
  31. - Mouse Accelerator
  32.  
  33.   MultiCX  lets  you  set Acceleration and Theshold (minimum movement to
  34.   activate Acceleration) for smooth mouse handling.
  35.  
  36.   ToolTypes:
  37.  
  38.   ACCELERATION=n        sets Acceleration factor, 0 means OFF
  39.   THRESHOLD=n           sets Threshold value, 0 means no Threshold
  40.  
  41. - Mouse Blanker
  42.  
  43.   MultiCX  blanks the mouse pointer on keypress and/or after approx.  30
  44.   seconds when no mouse movement has occured.
  45.  
  46.   ToolTypes:
  47.  
  48.   KEYBLANK              activates MouseBlanking on keypress
  49.   TIMEBLANK             activates MouseBlanking after timeout
  50.  
  51. - MMB Cycle
  52.  
  53.   MultiCX  allows  you to cycle screens using MiddleMouseButton, this is
  54.   equivalent to LCOMMAND M.
  55.   If  MouseShift is disabled you can use LeftButton-RightButton (LButton
  56.   is Qualifier) as a replacement for MiddleMouseButton.  This is thought
  57.   for those handicapped people with only two buttons...  ;-)
  58.  
  59.   ToolTypes:
  60.  
  61.   MMBCYCLE              activates MMB Cycle
  62.  
  63. - Mouse Shift
  64.  
  65.   MultiCX  lets you use the RightMouseButton as a Shift-Key for extended
  66.   selection.  And this is how it works:
  67.  
  68.   1. Press LeftButton to select first icon and hold it.
  69.   2. Press RightButton and hold it.
  70.   3. Release LeftButton and keep RightButton pressed.
  71.   4. Now select some more icons with LeftButton.
  72.   5. To deselect an icon, click on it with LeftButton and keep it
  73.      pressed, then release RightButton and press it again.
  74.  
  75.   Sounds much more complicated than it is...
  76.  
  77.   ToolTypes:
  78.  
  79.   MOUSESHIFT            activates MouseShift
  80.  
  81. - Window Cycle
  82.  
  83.   MultiCX  lets  you put a window to front/back by a configurable number
  84.   of LeftButton clicks. Qualifiers can be defined for both functions.
  85.  
  86.   ToolTypes:
  87.  
  88.   WINCYCLE=n            sets number of clicks for WindowCycle,
  89.                         0 means OFF
  90.   WINFRONTQUAL=Qual     sets Qualifier for WindowToFront
  91.   WINBACKQUAL=Qual      sets Qualifier for WindowToBack
  92.  
  93. - SUN-alike Window Activation
  94.  
  95.   MultiCX has three different options to activate windows automatically.
  96.   All  of  them activate the window under the mouse pointer, SunKey does
  97.   it  on  every  keypress,  SunMouse  does  it after mouse movement, and
  98.   SunRMB  does  it after pressing the right mouse button.  So SunKey and
  99.   SunMouse together seem to be rather useless.
  100.   Windows  with  active Gadgets  (like FileRequesters etc) will never be
  101.   deactivated by one of these functions.
  102.  
  103.   ToolTypes:
  104.  
  105.   SUNKEY                activates SunKey
  106.   SUNMOUSE              activates SunMouse
  107.   SUNRMB                activates SunRMB
  108.  
  109. - HoldX and HoldY
  110.  
  111.   MultiCX  allows you to lock a specific mouse dimension while holding a
  112.   defined Qualifier. If both Qualifiers are set to the same it locks all
  113.   mouse movements. So you are responsible for useful settings...
  114.  
  115.   ToolTypes:
  116.  
  117.   HOLDXQUAL=Qual        sets Qualifier for HoldX, none means OFF
  118.   HOLDYQUAL=Qual        sets Qualifier for HoldY, none means OFF
  119.  
  120. - Enter ASCII
  121.  
  122.   MultiCX  allows  you to enter ASCII codes directly by pressing the ALT
  123.   key  and the  numbers in the numeric block, for example: <ALT> 65 = A.
  124.   Maximum 3 digits, value must not be greater than 255.
  125.  
  126.   ToolTypes:
  127.  
  128.   ENTERASCII            activates EnterASCII
  129.  
  130. - CapShift
  131.  
  132.   This  option  changes  the  way  CapsLock  works.  Just try activating
  133.   CapsLock,  and  then  press some shifted letters to get an idea of it.
  134.   Hotkeys etc. are no longer affected by CapsLock.
  135.  
  136.   ToolTypes:
  137.  
  138.   CAPSHIFT              activates CapShift
  139.  
  140. - Window Close/Zoom
  141.  
  142.   MultiCX  allows you to close/zoom windows using pre-defined Qualifiers
  143.   and Keys.
  144.  
  145.   ToolTypes:
  146.  
  147.   WINCLOSE=Qual&Key     sets Qualifier and Key for CloseWindow,
  148.                         none means OFF
  149.   WINZOOM=Qual&Key      sets Qualifier and Key for ZoomWindow,
  150.                         none means OFF
  151.  
  152. - Window Remember
  153.  
  154.   MultiCX remembers the last active window on every screen, and the next
  155.   time  you  go  to  that  screen,  this  window  will  be  re-activated
  156.   automatically.
  157.  
  158.   ToolTypes:
  159.  
  160.   WINREMEMBER           activates WindowRemember
  161.  
  162. - PopCLI
  163.  
  164.   MultiCX  spawns  a  UserShell  using  the  given  command  string when
  165.   pressing  the  PopCLI  key.  Optionally the Workbench may be popped to
  166.   front first.
  167.  
  168.   ToolTypes:
  169.  
  170.   POPCLI=Qual&Key       sets Qualifier & Key for PopCLI, none means OFF
  171.   POPCLICMD=Command     sets command string for PopCLI, none means OFF
  172.   WBTOFRONT             activates WBToFront for PopCLI
  173.  
  174. - System Flags
  175.  
  176.   MultiCX lets you set/change some of the internal AmigaOS flags.  These
  177.   may  be  set,  unset  or  left unchanged, where a parameter of 0 means
  178.   deactivate, 1 or any value >0 means activate, and putting the ToolType
  179.   in brackets (the same as removing it) means no change.  Old values are
  180.   NOT  restored when quitting/disabling MultiCX, but Notification may be
  181.   used at any time.
  182.  
  183.   ToolTypes:
  184.  
  185.   BLACKBORDER=n         changes BlackBorder flag, ECS Denise needed
  186.   NOCLICK=n             changes NoClick flag for all drives,
  187.                         may not work with very old drives
  188.   WILDSTAR=n            changes flag for extended WildCarding,
  189.                         if ON "*" may be used instead of "#?"
  190.  
  191. ------------------------------------------------------------------------
  192.                             Notes and Hints
  193. ------------------------------------------------------------------------
  194.  
  195. - MultiCX must be started from WB, CLI/Shell is not supported.
  196.  
  197. - MultiCX  is  100%  compatible to Commodore's  specifications, so don't
  198.   complain if some bad-behaving software does not work with it.
  199.  
  200. - MultiCX's  Screen  Blanker  uses  BestModeID to find  the best display
  201.   mode.   Because  this is impossible under AmigaOS 2.x,  MultiCX uses a
  202.   special masking algorythm to find the display mode. But this relies on
  203.   the fact, that a DisplayID with all ModeKeys set to 0 exists.
  204.   Anyway you should use AmigaOS 3.x for best results.
  205.  
  206. - BlackBorder is not fully supported by AmigaOS 2.x, but should work.
  207.  
  208. - Some very old drives do not like NoClick,  so switch it off at once if
  209.   your drive makes funny noises...
  210.  
  211. - If  you  like to toggle some of MultiCX's features using  hotkeys, you
  212.   should try ToolManager 2.1 (by Stefan Becker) together with DoIcon (by
  213.   Lars Eilebrecht).
  214.  
  215. - MultiCX  may  be  enabled, disabled or removed  from within scripts by
  216.   using HandleCX (included in this archive).
  217.  
  218. ------------------------------------------------------------------------
  219.                                 History
  220. ------------------------------------------------------------------------
  221.  
  222. 1.00 - 1.20     internal Beta releases
  223.  
  224.        1.21     first public release
  225.  
  226.        1.22     - Keyboard Mouse works with SUNKEY now
  227.                 - SCRBLANK uses Standard Monitor now if BestModeID could
  228.                   not find a valid ScreenMode
  229.  
  230.        1.23     - improved MOUSESHIFT and MMBCYCLE, see details above
  231.  
  232.        1.24     - removed little bug in new MMBCYCLE
  233.  
  234.        1.25     - improved SCRBLANK under AmigaOS 2.x
  235.  
  236.        1.30     - Signal/Message system completely rewritten to prevent
  237.                   deadlock situations
  238.                 - improved WINREMEMBER
  239.                 - created seperate version for OS 3.x only with reduced
  240.                   code overhead
  241.  
  242.        1.31     - improved WINCYCLE and SUN-functions
  243.  
  244.        1.32     - improved Signal/Message system and asynchronous design
  245.                 - improved documentation
  246.                   (Special thanks go to John C. Davis for his help)
  247.  
  248.        1.33     - removed some more deadlock candidates
  249.  
  250.        1.34     - removed a small message handling bug
  251.  
  252.        1.35     - fixed stupid bug in WINCYCLE (I hate those typos...)
  253.  
  254.        1.36     - fixed problem in WINREMEMBER which could cause
  255.                   Enforcer hits under some very special conditions
  256.  
  257. ------------------------------------------------------------------------
  258.                                  Author
  259. ------------------------------------------------------------------------
  260.  
  261.  
  262.                              Martin Berndt
  263.  
  264.                           Fr.-Alfred-Str. 115
  265.                              47226 Duisburg
  266.  
  267.                                 Germany
  268.  
  269.                E-Mail Germany: m_berndt@wanderer.dssd.sub.org
  270.          E-Mail International: m_berndt@wanderer.gun.de
  271.  
  272.  
  273. ------------------------------------------------------------------------
  274.                               Legal Stuff
  275. ------------------------------------------------------------------------
  276.  
  277. MultiCX  is  GIFTWARE,  so simply send me anything you like.
  278. Gold bars, Ferraris and programming jobs in the US are prefered...   ;-)
  279.  
  280. Copyright
  281. ---------
  282. MultiCX  is  written and copyright © 1994 by Martin Berndt.  No parts of
  283. this  program  may  be  altered  by  any  means  (this includes editing,
  284. reprogramming, crunching, resourceing etc.), except archiving.
  285.  
  286. Disclaimer
  287. ----------
  288. The  author  is in no way liable for any changes made to any part of the
  289. program,  or  consequences thereof as he is in no way liable for damages
  290. or loss of data directly or indirectly caused by this software.
  291.  
  292. Distribution
  293. ------------
  294. Neither fees may be charged nor profits may be made by distributing this
  295. piece  of  software.  Only a nominal fee for costs of magnetic media may
  296. be  accepted,  the  amount  of  US  $5  shouldn't be exceeded for a disk
  297. containing  MultiCX.  CD Manufactures are specifically granted the right
  298. to  include  this program on CD collections, as long as they are for the
  299. Public Domain.
  300.