home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga Shareware Floppies / ma34.dms / ma34.adf / MultiCX / MultiCX.doc < prev    next >
Text File  |  1995-03-19  |  15KB  |  419 lines
  1. ------------------------------------------------------------------------
  2.                          MultiCX 1.60 (19.3.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.   HOTBLANK=Qual&Key     sets hotkey for immediate blanking
  31.   LIKEWB                forces cloning the WB's display mode
  32.   SCRMODE=ModeName      selects a display mode by name
  33.  
  34.   If  LIKEWB  and  SCRMODE  are  set,  SCRMODE is only used if WB is not
  35.   available for some reason.  But this should never happen...
  36.  
  37. - Moire Blanker
  38.  
  39.   MultiCX has a really nice screen blanker, too!  It steals no processor
  40.   time  from other tasks, and if it couldn't draw a line for longer than
  41.   10  seconds  it  falls  back to a simple black screen.  There are some
  42.   parameters to play with...
  43.  
  44.   ToolTypes:
  45.  
  46.   MOIRE                 selects Moire blanker
  47.   LINES=n               number of lines, default is 2
  48.   TRAIL=n               length of trail, default is 64
  49.   XSPEED=n              x offset for next line, default is 4
  50.   YSPEED=n              y offset for next line, default is 6
  51.   CSPEED=n              color cycling delay, default is 16
  52.   COLOR=n               drawing color, range is 1-4095
  53.                         0 means Random, -1 means Color Cycling
  54.  
  55. - Mouse Accelerator
  56.  
  57.   MultiCX  lets  you  set Acceleration and Theshold (minimum movement to
  58.   activate Acceleration) for smooth mouse handling.
  59.  
  60.   ToolTypes:
  61.  
  62.   ACCELERATION=n        sets Acceleration factor, 0 means OFF
  63.   THRESHOLD=n           sets Threshold value, 0 means no Threshold
  64.  
  65. - Mouse Blanker
  66.  
  67.   MultiCX  blanks the mouse pointer on keypress and/or after approx.  30
  68.   seconds when no mouse movement has occured.
  69.  
  70.   ToolTypes:
  71.  
  72.   KEYBLANK              activates MouseBlanking on keypress
  73.   TIMEBLANK             activates MouseBlanking after timeout
  74.  
  75. - Screen Cycle
  76.  
  77.   MultiCX  allows you to cycle screens using either MiddleMouseButton or
  78.   BothMouseButtons, this is equivalent to LCOMMAND M.
  79.  
  80.   ToolTypes:
  81.  
  82.   SCRCYCLE=MMB|BMB      sets Screen Cycle to MMB or BMB
  83.  
  84. - Mouse Shift
  85.  
  86.   MultiCX  lets  you  use the RightMouseButton or MiddleMouseButton as a
  87.   Shift-Key for extended selection.
  88.  
  89.   And this is how it works with RightMouseButton:
  90.  
  91.   1. Press LeftButton to select first icon and hold it.
  92.   2. Press RightButton and hold it.
  93.   3. Release LeftButton and keep RightButton pressed.
  94.   4. Now select some more icons with LeftButton.
  95.   5. To deselect an icon, click on it with LeftButton and keep it
  96.      pressed, then release RightButton and press it again.
  97.  
  98.   Sounds much more complicated than it is...
  99.  
  100.   If  MOUSESHIFT  and SCRCYCLE are set to MMB, then MouseShift will stay
  101.   inactive.
  102.  
  103.   ToolTypes:
  104.  
  105.   MOUSESHIFT=RMB|MMB    sets MouseShift to RMB or MMB
  106.  
  107. - Window Cycle
  108.  
  109.   MultiCX  lets  you put a window to front/back by a configurable number
  110.   of  LeftButton  clicks.  Qualifiers can be defined for both functions.
  111.   Additionally  there  are two hotkeys available for TopWindowToBack and
  112.   BottomWindowToTop.  But only windows with a Depth Gadget  are affected
  113.   by Window Cycling.
  114.  
  115.   ToolTypes:
  116.  
  117.   WINCYCLE=n            sets number of mouse clicks for WindowCycle,
  118.                         0 means OFF
  119.   WINFRONTQUAL=Qual     sets Qualifier for WindowToFront
  120.   WINBACKQUAL=Qual      sets Qualifier for WindowToBack
  121.   FRONT2BACK=Qual&Key   sets hotkey for TopWindowToBack
  122.   BACK2FRONT=Qual&Key   sets hotkey for BottomWindowToTop
  123.  
  124. - SUN-alike Window Activation
  125.  
  126.   MultiCX has three different options to activate windows automatically.
  127.   All  of  them activate the window under the mouse pointer, SunKey does
  128.   it  on  every  keypress,  SunMouse  does  it after mouse movement, and
  129.   SunRMB  does  it after pressing the right mouse button.  So SunKey and
  130.   SunMouse together seem to be rather useless.
  131.   Windows  with  active Gadgets  (like FileRequesters etc) will never be
  132.   deactivated by one of these functions.
  133.  
  134.   ToolTypes:
  135.  
  136.   SUNKEY                activates SunKey
  137.   SUNMOUSE              activates SunMouse
  138.   SUNRMB                activates SunRMB
  139.  
  140. - HoldX and HoldY
  141.  
  142.   MultiCX  allows you to lock a specific mouse dimension while holding a
  143.   defined Qualifier. If both Qualifiers are set to the same it locks all
  144.   mouse movements. So you are responsible for useful settings...
  145.  
  146.   ToolTypes:
  147.  
  148.   HOLDXQUAL=Qual        sets Qualifier for HoldX, none means OFF
  149.   HOLDYQUAL=Qual        sets Qualifier for HoldY, none means OFF
  150.  
  151. - Enter ASCII
  152.  
  153.   MultiCX  allows you to enter ASCII codes directly by pressing the RALT
  154.   key  and the  numbers in the numeric block, for example: <ALT> 65 = A.
  155.   Maximum 3 digits, value must not be greater than 255.
  156.  
  157.   ToolTypes:
  158.  
  159.   ENTERASCII            activates EnterASCII
  160.  
  161. - CapShift
  162.  
  163.   This  option  changes  the  way  CapsLock  works.  Just try activating
  164.   CapsLock,  and  then  press some shifted letters to get an idea of it.
  165.   Hotkeys etc. are no longer affected by CapsLock.
  166.   CapShift is ignored if NoCapsLock is active.
  167.  
  168.   ToolTypes:
  169.  
  170.   CAPSHIFT              activates CapShift
  171.  
  172. - NoCapsLock
  173.  
  174.   ... simply switches off CAPSLOCK completely.
  175.  
  176.   ToolTypes:
  177.  
  178.   NOCAPSLOCK            activates NoCapsLock
  179.  
  180. - Window Close/Zoom
  181.  
  182.   MultiCX  allows you to close/zoom windows using pre-defined Qualifiers
  183.   and Keys.
  184.  
  185.   ToolTypes:
  186.  
  187.   WINCLOSE=Qual&Key     sets Qualifier and Key for CloseWindow,
  188.                         none means OFF
  189.   WINZOOM=Qual&Key      sets Qualifier and Key for ZoomWindow,
  190.                         none means OFF
  191.  
  192. - Window Remember
  193.  
  194.   MultiCX remembers the last active window on every screen, and the next
  195.   time  you  go  to  that  screen,  this  window  will  be  re-activated
  196.   automatically.
  197.  
  198.   ToolTypes:
  199.  
  200.   WINREMEMBER           activates WindowRemember
  201.  
  202. - PopCLI
  203.  
  204.   MultiCX  spawns  a  UserShell  using  the  given  command  string when
  205.   pressing  the  PopCLI  key.  Optionally the Workbench may be popped to
  206.   front first.
  207.  
  208.   ToolTypes:
  209.  
  210.   POPCLI=Qual&Key       sets Qualifier & Key for PopCLI, none means OFF
  211.   POPCLICMD=Command     sets command string for PopCLI, none means OFF
  212.   POPCLISTACK=n         sets stacksize for PopCLI (Default: 4096)
  213.   WBTOFRONT             activates WBToFront for PopCLI
  214.  
  215. - System Flags
  216.  
  217.   MultiCX lets you set/change some of the internal AmigaOS flags.  These
  218.   may  be  set,  unset  or  left unchanged, where a parameter of 0 means
  219.   deactivate, 1 or any value >0 means activate, and putting the ToolType
  220.   in brackets (the same as removing it) means no change.  Old values are
  221.   NOT  restored when quitting/disabling MultiCX, but Notification may be
  222.   used at any time.
  223.  
  224.   ToolTypes:
  225.  
  226.   BLACKBORDER=n         changes BlackBorder flag, ECS Denise needed
  227.   NOCLICK=n             changes NoClick flag for all drives,
  228.                         may not work with very old drives
  229.   WILDSTAR=n            changes flag for extended WildCarding,
  230.                         if ON "*" may be used instead of "#?"
  231.  
  232. ------------------------------------------------------------------------
  233.                             Notes and Hints
  234. ------------------------------------------------------------------------
  235.  
  236. - MultiCX must be started from WB, CLI/Shell is not supported.
  237.  
  238. - MultiCX  is  100%  compatible to Commodore's  specifications, so don't
  239.   complain if some bad-behaving software does not work with it.
  240.  
  241. - MultiCX's  Screen  Blanker  uses  BestModeID to find  the best display
  242.   mode.   Because  this is impossible under AmigaOS 2.x,  MultiCX uses a
  243.   special masking algorythm to find the display mode. But this relies on
  244.   the fact, that a DisplayID with all ModeKeys set to 0 exists.
  245.   Anyway you should use AmigaOS 3.x for best results.
  246.  
  247. - BlackBorder is not fully supported by AmigaOS 2.x, but should work.
  248.  
  249. - Some very old drives do not like NoClick,  so switch it off at once if
  250.   your drive makes funny noises...
  251.  
  252. - If  you  like to toggle some of MultiCX's features using  hotkeys, you
  253.   should try ToolManager 2.1 (by Stefan Becker) together with DoIcon (by
  254.   Lars Eilebrecht).
  255.  
  256. - MultiCX  may  be  enabled, disabled or removed  from within scripts by
  257.   using HandleCX (included in this archive).
  258.  
  259. ------------------------------------------------------------------------
  260.                                 History
  261. ------------------------------------------------------------------------
  262.  
  263. 1.00 - 1.20     internal Beta releases
  264.  
  265.        1.21     first public release
  266.  
  267.        1.22     - Keyboard Mouse works with SUNKEY now
  268.                 - SCRBLANK uses Standard Monitor now if BestModeID could
  269.                   not find a valid ScreenMode
  270.  
  271.        1.23     - improved MOUSESHIFT and MMBCYCLE, see details above
  272.  
  273.        1.24     - removed little bug in new MMBCYCLE
  274.  
  275.        1.25     - improved SCRBLANK under AmigaOS 2.x
  276.  
  277.        1.30     - Signal/Message system completely rewritten to prevent
  278.                   deadlock situations
  279.                 - improved WINREMEMBER
  280.                 - created seperate version for OS 3.x only with reduced
  281.                   code overhead
  282.  
  283.        1.31     - improved WINCYCLE and SUN-functions
  284.  
  285.        1.32     - improved Signal/Message system and asynchronous design
  286.                 - improved documentation
  287.                   (Special thanks go to John C. Davis for his help)
  288.  
  289.        1.33     - removed some more deadlock candidates
  290.  
  291.        1.34     - removed a small message handling bug
  292.  
  293.        1.35     - fixed stupid bug in WINCYCLE (I hate those typos...)
  294.  
  295.        1.36     - fixed problem in WINREMEMBER which could cause
  296.                   Enforcer hits under some very special conditions
  297.  
  298.        1.37     - improved AutoRepeat behaviour
  299.  
  300.        1.40     - Exchange's "Show Interface" or HandleCX's "POPUP"
  301.                   will open WB Icons/Information now (OS 3.x only!)
  302.                 - fixed bug in SCRBLANK
  303.  
  304.        1.41     - implemented CX_POPKEY feature (OS 3.x only!)
  305.                 - MultiCX opens WBInfo now if it is already running
  306.                   and started again (OS 3.x only!)
  307.  
  308.        1.42     - POPCLI Shell gets full path now (what a bad hack...;-)
  309.                 - SCRBLANK, WINCYCLE, ACCELERATION and THRESHOLD no
  310.                   longer accept negative values
  311.  
  312.        1.45     - improved handling of windows with active menu
  313.                 - implemented timeout for re-blanking of screen
  314.                 - screen will be unblanked when disk is inserted
  315.                 - Mouse Blanker is more compatible to (bad) graphics
  316.                   boards now
  317.                 - implemented POPCLISTACK ToolType
  318.                 - MMBCYCLE changed to SCRCYCLE, see details above
  319.                 - improved MOUSESHIFT, see details above
  320.  
  321.        1.46     - deselecting an icon now works with MOUSESHIFT=MMB,
  322.                   just keep LButton pressed while releasing MButton
  323.                   for a short while
  324.  
  325.        1.47     - Mouse Blanker changed back to old routine, because
  326.                   some gfx board drivers seem to have even more problems
  327.                   with ss_height > 0
  328.                 - implemented HOTBLANK and LIKEWB features
  329.  
  330.        1.48     - improved ENTERASCII slightly
  331.  
  332.        1.49     - improved SCRCYCLE, MOUSESHIFT and ENTERASCII
  333.                 - some code optimizations
  334.  
  335.        1.50     - some very small bugs fixed
  336.                 - overall code improvements
  337.  
  338.        1.51     - implemented MOIRE Screen Blanker and some ToolTypes,
  339.                   see details above
  340.  
  341.        1.52     - implemented Color Cycling for MOIRE Blanker
  342.                 - implemented SCRMODE ToolType
  343.                 - HOTBLANK works always now, even if SCRBLANK is 0
  344.  
  345.        1.53     - implemented CSPEED ToolType for Moire Blanker
  346.  
  347.        1.54     - Blanker timer was not cleared on Enable/Disable
  348.  
  349.        1.55     - LINES=1 or TRAIL=1 waked up the guru...
  350.                 - improved Amiga-is-busy blanking
  351.                 - improved CAPSHIFT to handle foreign characters (ALT)
  352.                 - ENTERASCII now uses RALT only, this should prevent
  353.                   problems with other software using ALT-NUMKEYs
  354.  
  355.        1.56     - CX_POPKEY now brings Workbench screen to front before
  356.                   opening WBInfo
  357.                 - implemented Window Cycling via hotkeys, new ToolTypes
  358.                   are FRONT2BACK and BACK2FRONT
  359.  
  360.        1.57     - Mouse was not always blanked with HOTBLANK
  361.  
  362.        1.58     - Arghhhh...
  363.                   Mouse blanking still was not 100% ok, but now it is!
  364.                 - some code optimizations
  365.  
  366.        1.59     - fixed some problems with BMB ScreenCycling
  367.  
  368.        1.60     - implemented NOCAPSLOCK
  369.                 - included new version of HandleCX
  370.  
  371.  
  372. ------------------------------------------------------------------------
  373.                                  Author
  374. ------------------------------------------------------------------------
  375.  
  376.  
  377.                              Martin Berndt
  378.  
  379.                           Fr.-Alfred-Str. 115
  380.                              47226 Duisburg
  381.  
  382.                                 Germany
  383.  
  384.                E-Mail Germany: m_berndt@wanderer.dssd.sub.org
  385.          E-Mail International: m_berndt@wanderer.gun.de
  386.  
  387.  
  388. ------------------------------------------------------------------------
  389.                               Legal Stuff
  390. ------------------------------------------------------------------------
  391.  
  392. MultiCX  is  GIFTWARE,  so simply send me anything you like.
  393. Gold bars, Ferraris and programming jobs in the US are prefered...   ;-)
  394.  
  395. BTW:   Only 5 (in words: FIVE) users have sent a gift, yet.  So it seems
  396.        that  it's not worth the effort, because nobody is using MultiCX.
  397.        Is that true?
  398.  
  399. Copyright
  400. ---------
  401. MultiCX is written and copyright © 1994-1995 by Martin Berndt.  No parts
  402. of  this  program  may  be  altered by any means (this includes editing,
  403. reprogramming, crunching, resourceing etc.), except archiving.
  404.  
  405. Disclaimer
  406. ----------
  407. The  author  is in no way liable for any changes made to any part of the
  408. program,  or  consequences thereof as he is in no way liable for damages
  409. or loss of data directly or indirectly caused by this software.
  410.  
  411. Distribution
  412. ------------
  413. Neither fees may be charged nor profits may be made by distributing this
  414. piece  of  software.  Only a nominal fee for costs of magnetic media may
  415. be  accepted,  the  amount  of  US  $5  shouldn't be exceeded for a disk
  416. containing  MultiCX.  CD Manufactures are specifically granted the right
  417. to  include  this program on CD collections, as long as they are for the
  418. Public Domain.
  419.