home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / new / util / cdity / multicx / multicx.doc < prev    next >
Text File  |  1995-01-17  |  12KB  |  331 lines
  1. ------------------------------------------------------------------------
  2.                          MultiCX 1.46 (18.1.95)
  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. - Screen Cycle
  52.  
  53.   MultiCX  allows you to cycle screens using either MiddleMouseButton or
  54.   BothMouseButtons, this is equivalent to LCOMMAND M.
  55.  
  56.   ToolTypes:
  57.  
  58.   SCRCYCLE=MMB|BMB      sets Screen Cycle to MMB or BMB
  59.  
  60. - Mouse Shift
  61.  
  62.   MultiCX  lets  you  use the RightMouseButton or MiddleMouseButton as a
  63.   Shift-Key for extended selection.
  64.  
  65.   And this is how it works with RightMouseButton:
  66.  
  67.   1. Press LeftButton to select first icon and hold it.
  68.   2. Press RightButton and hold it.
  69.   3. Release LeftButton and keep RightButton pressed.
  70.   4. Now select some more icons with LeftButton.
  71.   5. To deselect an icon, click on it with LeftButton and keep it
  72.      pressed, then release RightButton and press it again.
  73.  
  74.   Sounds much more complicated than it is...
  75.  
  76.   If  MOUSESHIFT  and SCRCYCLE are set to MMB, then MouseShift will stay
  77.   inactive.
  78.  
  79.   ToolTypes:
  80.  
  81.   MOUSESHIFT=RMB|MMB    sets MouseShift to RMB or MMB
  82.  
  83. - Window Cycle
  84.  
  85.   MultiCX  lets  you put a window to front/back by a configurable number
  86.   of LeftButton clicks. Qualifiers can be defined for both functions.
  87.  
  88.   ToolTypes:
  89.  
  90.   WINCYCLE=n            sets number of clicks for WindowCycle,
  91.                         0 means OFF
  92.   WINFRONTQUAL=Qual     sets Qualifier for WindowToFront
  93.   WINBACKQUAL=Qual      sets Qualifier for WindowToBack
  94.  
  95. - SUN-alike Window Activation
  96.  
  97.   MultiCX has three different options to activate windows automatically.
  98.   All  of  them activate the window under the mouse pointer, SunKey does
  99.   it  on  every  keypress,  SunMouse  does  it after mouse movement, and
  100.   SunRMB  does  it after pressing the right mouse button.  So SunKey and
  101.   SunMouse together seem to be rather useless.
  102.   Windows  with  active Gadgets  (like FileRequesters etc) will never be
  103.   deactivated by one of these functions.
  104.  
  105.   ToolTypes:
  106.  
  107.   SUNKEY                activates SunKey
  108.   SUNMOUSE              activates SunMouse
  109.   SUNRMB                activates SunRMB
  110.  
  111. - HoldX and HoldY
  112.  
  113.   MultiCX  allows you to lock a specific mouse dimension while holding a
  114.   defined Qualifier. If both Qualifiers are set to the same it locks all
  115.   mouse movements. So you are responsible for useful settings...
  116.  
  117.   ToolTypes:
  118.  
  119.   HOLDXQUAL=Qual        sets Qualifier for HoldX, none means OFF
  120.   HOLDYQUAL=Qual        sets Qualifier for HoldY, none means OFF
  121.  
  122. - Enter ASCII
  123.  
  124.   MultiCX  allows  you to enter ASCII codes directly by pressing the ALT
  125.   key  and the  numbers in the numeric block, for example: <ALT> 65 = A.
  126.   Maximum 3 digits, value must not be greater than 255.
  127.  
  128.   ToolTypes:
  129.  
  130.   ENTERASCII            activates EnterASCII
  131.  
  132. - CapShift
  133.  
  134.   This  option  changes  the  way  CapsLock  works.  Just try activating
  135.   CapsLock,  and  then  press some shifted letters to get an idea of it.
  136.   Hotkeys etc. are no longer affected by CapsLock.
  137.  
  138.   ToolTypes:
  139.  
  140.   CAPSHIFT              activates CapShift
  141.  
  142. - Window Close/Zoom
  143.  
  144.   MultiCX  allows you to close/zoom windows using pre-defined Qualifiers
  145.   and Keys.
  146.  
  147.   ToolTypes:
  148.  
  149.   WINCLOSE=Qual&Key     sets Qualifier and Key for CloseWindow,
  150.                         none means OFF
  151.   WINZOOM=Qual&Key      sets Qualifier and Key for ZoomWindow,
  152.                         none means OFF
  153.  
  154. - Window Remember
  155.  
  156.   MultiCX remembers the last active window on every screen, and the next
  157.   time  you  go  to  that  screen,  this  window  will  be  re-activated
  158.   automatically.
  159.  
  160.   ToolTypes:
  161.  
  162.   WINREMEMBER           activates WindowRemember
  163.  
  164. - PopCLI
  165.  
  166.   MultiCX  spawns  a  UserShell  using  the  given  command  string when
  167.   pressing  the  PopCLI  key.  Optionally the Workbench may be popped to
  168.   front first.
  169.  
  170.   ToolTypes:
  171.  
  172.   POPCLI=Qual&Key       sets Qualifier & Key for PopCLI, none means OFF
  173.   POPCLICMD=Command     sets command string for PopCLI, none means OFF
  174.   POPCLISTACK=n         sets stacksize for PopCLI (Default: 4096)
  175.   WBTOFRONT             activates WBToFront for PopCLI
  176.  
  177. - System Flags
  178.  
  179.   MultiCX lets you set/change some of the internal AmigaOS flags.  These
  180.   may  be  set,  unset  or  left unchanged, where a parameter of 0 means
  181.   deactivate, 1 or any value >0 means activate, and putting the ToolType
  182.   in brackets (the same as removing it) means no change.  Old values are
  183.   NOT  restored when quitting/disabling MultiCX, but Notification may be
  184.   used at any time.
  185.  
  186.   ToolTypes:
  187.  
  188.   BLACKBORDER=n         changes BlackBorder flag, ECS Denise needed
  189.   NOCLICK=n             changes NoClick flag for all drives,
  190.                         may not work with very old drives
  191.   WILDSTAR=n            changes flag for extended WildCarding,
  192.                         if ON "*" may be used instead of "#?"
  193.  
  194. ------------------------------------------------------------------------
  195.                             Notes and Hints
  196. ------------------------------------------------------------------------
  197.  
  198. - MultiCX must be started from WB, CLI/Shell is not supported.
  199.  
  200. - MultiCX  is  100%  compatible to Commodore's  specifications, so don't
  201.   complain if some bad-behaving software does not work with it.
  202.  
  203. - MultiCX's  Screen  Blanker  uses  BestModeID to find  the best display
  204.   mode.   Because  this is impossible under AmigaOS 2.x,  MultiCX uses a
  205.   special masking algorythm to find the display mode. But this relies on
  206.   the fact, that a DisplayID with all ModeKeys set to 0 exists.
  207.   Anyway you should use AmigaOS 3.x for best results.
  208.  
  209. - BlackBorder is not fully supported by AmigaOS 2.x, but should work.
  210.  
  211. - Some very old drives do not like NoClick,  so switch it off at once if
  212.   your drive makes funny noises...
  213.  
  214. - If  you  like to toggle some of MultiCX's features using  hotkeys, you
  215.   should try ToolManager 2.1 (by Stefan Becker) together with DoIcon (by
  216.   Lars Eilebrecht).
  217.  
  218. - MultiCX  may  be  enabled, disabled or removed  from within scripts by
  219.   using HandleCX (included in this archive).
  220.  
  221. ------------------------------------------------------------------------
  222.                                 History
  223. ------------------------------------------------------------------------
  224.  
  225. 1.00 - 1.20     internal Beta releases
  226.  
  227.        1.21     first public release
  228.  
  229.        1.22     - Keyboard Mouse works with SUNKEY now
  230.                 - SCRBLANK uses Standard Monitor now if BestModeID could
  231.                   not find a valid ScreenMode
  232.  
  233.        1.23     - improved MOUSESHIFT and MMBCYCLE, see details above
  234.  
  235.        1.24     - removed little bug in new MMBCYCLE
  236.  
  237.        1.25     - improved SCRBLANK under AmigaOS 2.x
  238.  
  239.        1.30