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