home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d7xx / d798 / aswarmii.lha / ASwarm / ASwarm.doc < prev    next >
Text File  |  1993-01-10  |  29KB  |  709 lines
  1.                           ASwarm II V1.3 - Manual
  2.  
  3.  
  4. NAME
  5.     SYS:WBStartup/ASwarm
  6.  
  7. SYNOPSIS
  8.     ASwarm
  9.      CX_PRIORITY/N/K     : <System Priority>
  10.      CX_POPKEY/K         : <Hot Key Description String>
  11.      CX_POPUP/S          : <Yes | No>
  12.      BLANKKEY/K          : <Hot Key Description String>
  13.      SECONDS=TIMEOUT/N/K : <1 - 3600>
  14.      CLIENTTIMEOUT/N/K   : <1 - 60>
  15.      DISPLAY/K           : <Display Description String>
  16.      CYCLE/S             : <Yes | No>
  17.      AIM/S               : <Yes | No>
  18.      WASPS/N/K           : <1 - 10>
  19.      BEES/N/K            : <1 - 500>
  20.      SPEED/N/K           : <1 - 4>
  21.      TIGHTNESS/N/K       : <1 - 10>
  22.      MOUSEBLANKMETHOD/K  : <Hardware | FreeSprite>
  23.  
  24. DESCRIPTION
  25.     A Screenblanker Commodity with high security. Does not burn in
  26.     the graphic into the screen when CPU is really busy.
  27.     It's funny to watch, runs only under Amiga OS Release 2.04 or newer.
  28.  
  29. SOURCE
  30.     The source code is included, it can be compiled with SAS-C 5.10a or
  31.     with the registered version of Dice V2.06.40 (or newer).
  32.     The source is included to give you a chance to use the Client/Server
  33.     model of ASwarm II, or to look how we've done the Commodity Interface.
  34.     Please don't spread your improved versions of ASwarm II under the name
  35.     of ASwarm, because this may confuse the public and it's not fair.
  36.  
  37. COPYRIGHT
  38.     ASwarm II V1.3 is freely distributable.
  39.     ASwarm II V1.3 is free to be spread on public-domain and shareware disks
  40.     especially on Fred Fish's AmigaLibDisks, as long as they are sold for a
  41.     reasonable charge that is less than US $6 or DM 8.- .
  42.     For use in commercial products the permission of the authors is required.
  43.     ASwarm II V1.3 may be copied and distributed via electronic networks such
  44.     as the Internet, also it may be held available on anonymous ftp-servers,
  45.     mail-boxes or BBS's.
  46.     The Copyright is still by the Authors.
  47.     The source may be changed or improved. Please DON'T spread your own
  48.     version of ASwarm II under the  name of ASWARM, this will produce too
  49.     much confusion (such as we had with ASwarm III, which is not our product).
  50.     Just send us a note what you've changed, and if you really think it's
  51.     necessary to spread your own version, use another name.
  52.  
  53. AUTHOR & SUPPORT
  54.     Markus Illenseer            # Graphic routines
  55.     Kurt-Schumacherstr. 16       # Documentation
  56.     D-4800 Bielefeld 1            # Dice Support
  57.     Germany
  58.     INTERNET: markus@techfak.uni-bielefeld.de
  59.     ZERBERUS: markus%techfak.uni-bielefeld.de@uucp.zer
  60.     IRC: ill
  61.  
  62.     Matthias Scheler            # Server-Client model
  63.     Schützenstraße 18            # User Interface
  64.     D-4799 Borchen/Nordborchen    # SAS/C Support
  65.     Germany
  66.     INTERNET: tron@uni-paderborn.de
  67.     FIDO:     Matthias Scheler@2:242/55.36
  68.     ZERBERUS: tron%uni-paderborn.de@uucp.zer
  69.     IRC: Tron
  70.  
  71.     SUPPORT FTP ADDRESS:
  72.     ftp.uni-paderborn.de [131.334.2.32] anonymous access.
  73.     amiga.physik.unizh.ch [130.60.80.80] anonymous access.
  74.  
  75.     Please refer to "KNOWN PROBLEMS" below, before you contact
  76.     us for a Bug-report, any comment is welcomed of course.
  77.  
  78. CHANGES
  79.     For those who already know ASwarm II V1.0 or V1.1, please refer
  80.     to the "SYNOPSIS" and "STARTUP" chapters. V1.2 of ASwarm II has been
  81.     improved heavily. V1.3 fixes some bugs and is enhanced to work
  82.     with new graphic modes.
  83.  
  84.     If you start ASwarm in the "SYS:WBStartup" drawer (or Workbench in
  85.     general), please have a closer look to the new "Save Config"-routine
  86.     which is able to update the Tool Types of ASwarm's icon automically.
  87.  
  88.     With ASwarm II V1.3 we changed the graphic routines to work fine with
  89.     the interleaved bitmaps of Kickstart 3.0 and the VGA boards avaible for
  90.     the Amiga.
  91.  
  92.     The input handler has been completely rewritten.
  93.  
  94.     Finally we found and removed the bug which sometimes caused swarms to
  95.     dance in circles at the lower left corner of the screen. This happened
  96.     in Aim-Mode only.
  97.  
  98. PURPOSE & THEORY
  99.     ASwarm is a screenblanker. The graphic during blanking phase is loosely
  100.     based upon Jeff Buterworth's "xswarm" for X11 Windowing System.
  101.  
  102.     A screenblanker's goal should be to blank (disable) the screen output
  103.     in order to prevent burning images into the monitor's phosphor.
  104.  
  105.     As it is boring just to disable the screen, and as the Amiga can
  106.     handle multitasking, we could also draw some funny stuff while blanking
  107.     the screen. The only problem about that: when we draw something, we must
  108.     take care that our animations don't burn themself into the monitor.
  109.  
  110.     This usually happens, when the screen blanker has not enough time
  111.     to draw, so the graphics rest on the same place. When the
  112.     screenblanker has not enough CPU time, it's because there is another
  113.     CPU-intensive programm, such as a raytracer or C-compiler, running.
  114.  
  115.     As the screenblanker isn't important for the user, we found
  116.     a way to manage both cases: Screenblanker has CPU time or not.
  117.     When it has CPU time, the blanker draws the funny graphics, when
  118.     it hasn't, the screenblanker-draw routine is disabled and the
  119.     screen is really blanked (black) until it gains back CPU time.
  120.  
  121.     This is done with a simple server-client model. The server runs
  122.     with a normal priority, but just has a WaitPort()-loop (NO real
  123.     CPU usage) to detect the time-out and to detect the amount of CPU time.
  124.     The client is started when the server reached the TIMEOUT, the client
  125.     runs with a low priority. When the server reached the CLIENTTIMEOUT and
  126.     remarks that the client wasn't able to draw anything, then the screen
  127.     is really blanked.
  128.  
  129.     There was a discussion on comp.sys.amiga.misc (Usenet) for
  130.     screenblankers, at all, we found that ASwarm completely fits on the
  131.     demanded features and requirements.
  132.  
  133. VERSION
  134.     To prevent a Version War, we renamed ASwarm to ASwarm II .
  135.     There are some other versions of ASwarm or Swarm available, such
  136.     as ASwarm as IPC-Port-Blanker for DMouse, written by
  137.     Markus Illenseer (written in KickPascal, available with Source
  138.     on demand), or Swarm by Christian von Roques, with
  139.     assembler subroutines for drawing, unfortunately not with the
  140.     multiple-swarm option (yet ?) (also for DMouse).
  141.     There is also a Swarm-Modul for 'Shadow-Master', refer there.
  142.     The upcoming 'Crepuscule', a multi-blanker also contains an
  143.     ASwarm-Modul.
  144.  
  145.     As ASwarm can be compiled with DICE _and_ (or) SAS/C, you can
  146.     detect the Version with: (CLI) "Version ASwarm FULL"
  147.     It will show you the used compiler. Default is SAS-C.
  148.     Also the size of the binary should differ:
  149.         19284  Bytes for the DICE version.
  150.         16996  Bytes for the SAS/C version.
  151.  
  152.     Unfortunately Jake Rose 'improved' our ASwarm II V1.0, renamed it
  153.     to ASwarm III (which is correct, it's a new version of ASwarm).
  154.  
  155.     Please DON'T use ASwarm III, it has too many Bugs (Sorry Jake,
  156.     not your fault). Those Bugs are fixed in our ASwarm II V1.1 or V1.2,
  157.     but still exist in Jake's version. It is possible that ASwarm III (and
  158.     of course our old ASwarm II V1.0) crashes your machine.
  159.  
  160. STARTING
  161.     ASwarm II is a COMMODITY, therefore it _only_ runs under WB Release
  162.     2.0 (V37.175) and newer. A Commodity is normally started in the
  163.     "SYS:WBStartup" drawer. So it will be automatically started on the
  164.     workbench startup (LoadWB, usually in "S:Startup-Sequence").
  165.     So, just copy "ASwarm" and "ASwarm.info" to "SYS:WBStartup", or
  166.     click and move the icon to the drawer.
  167.  
  168.     To get ASwarm started without rebooting now, double-click the icon.
  169.     If the Tool Types weren't changed yet, a window shows up. Double-click
  170.     once more, if the window doesn't show up.
  171.     This is the 'Edit-window' of ASwarm.
  172.  
  173.     Now click on the Gadget 'Hide' or the 'Close-Gadget' to close
  174.     the window.
  175.  
  176.     ASwarm is now started. After 60 seconds the screen will be
  177.     blanked, of course only when the user doesn't touch the keyboard or
  178.     the mouse (or other Input-event's occure).
  179.  
  180.     You can start ASwarm from the CLI or another Shell.
  181.     For example you can start ASwarm in the S:User-Startup:
  182.         Run >NIL: <NIL: ASwarm CX_POPUP=NO
  183.  
  184.     ASwarm II now supports "dos.library/ReadArgs()". For a small help on the
  185.     command line arguments, start ASwarm with a '?' as Parameter.
  186.  
  187. ARGUMENTS
  188.     As every good Commodity, ASwarm supports Tool Type entries.
  189.     Click the ASwarm.info and press "Right Amiga i" (or use the
  190.     Workbench Menu Item 'Information') to change or add a Tool Type
  191.     entry.
  192.     In fact this is no longer necessary, as we do support a
  193.     'Save Config' now, which does save all parameters into the
  194.     Tool Types of the icon.
  195.  
  196.     In the ToolType list there is (per default) entered:
  197.  
  198.         DONOTWAIT                 # Tell WB to not wait on a return
  199.         CX_PRIORITY=0             # Priority in "commodities.library"'s queue
  200.         CX_POPUP=YES              # Show up the window on start
  201.         CX_POPKEY=CTRL ALT s      # Edit Window Hot Key
  202.         BLANKKEY=CTRL ALT b       # Immediate Blank Hot Key
  203.         TIMEOUT=60                # Time after which ASwarm blanks
  204.         CLIENTTIMEOUT=5           # Time after which the Client is disabled
  205.         DISPLAY=PAL:Hires         # The Resolution of the Display
  206.         CYCLE=YES                 # The Color-Cycling is enabled
  207.         AIM=NO                    # The Aim-Mode is disabled
  208.         WASP=2                    # Number of Waps is 2
  209.         BEES=25                   # Number if Bees is 25
  210.         SPEED=4                   # Speed is set to Speed-Mode 4
  211.         TIGHTNESS=5               # Tightness of Bees is set to 5
  212.         MOUSEBLANKMETHOD=Hardware # how to blank the mouse
  213.  
  214.     These Tool Types are the normal way to give arguments for Commodities
  215.     and pure Workbench programs.
  216.     Please refer also to your AmigaDOS Manual (Section "Workbench Programms",
  217.     especially chapter "The WBStartup Drawer") to get an idea of the Tool
  218.     Types entries.
  219.  
  220. TOOL TYPES
  221.     DONOTWAIT
  222.                 When started from WBStartup, let
  223.                 WB know that it doesn't have to wait
  224.                 for ASwarm.
  225.  
  226.     CX_PRIORITY=<-128 - 129>
  227.                 Priority in "commodities.library"'s queue
  228.  
  229.     CX_POPUP=<YES | NO>
  230.                 When ASwarm is started, the Edit-Window may show
  231.                 up when set to 'YES' or any (!) other String
  232.                 than 'NO'.
  233.  
  234.     CX_POPKEY=<Hot Key>
  235.                 Please see below for the Hotkeys.
  236.                 The hot key opens the Edit-Window of ASwarm.
  237.  
  238.     BLANKKEY=<Hot Key>
  239.                 Please see below for the Hotkeys.
  240.                 The hot key immediatly blanks the screen.
  241.  
  242.     TIMEOUT=<1 - 3600>
  243.                 This is the timeout counter in seconds.
  244.                 During this time NO input from the user must
  245.                 occur in order to start the blanker.
  246.                 Usual time is about 60 secs.
  247.  
  248.     CLIENTTIMEOUT=<1 - 6>
  249.                 After this time, the server disables the screen,
  250.                 it has then remarked that the client can't draw
  251.                 anything due of CPU time.
  252.                 Usual time is about 5 secs.
  253.  
  254.     DISPLAY=<Display Type>
  255.                 Please see below for the Display Types.
  256.                 Here you can change the size of the screen on
  257.                 which ASwarms draws.
  258.  
  259.     CYLCE=<YES | NO>
  260.                 Disable the colorcycling of the Bees.
  261.  
  262.     AIM=<YES | NO>
  263.                 Search-the-nearest-Wasp mode enabeld.
  264.  
  265.     WASPS=<1 - 10>
  266.                 The number of drawn Wasps.
  267.  
  268.     BEES=<1 - 500>
  269.                 The number of Bees.
  270.  
  271.     SPEED=<1 - 4>
  272.                 Slow down ASwarm. 4 is maximum speed.
  273.  
  274.     TIGHTNESS=<1 - 10>
  275.                 Indicates how close the Bees may come to the Waps.
  276.                 The higher, the closer.
  277.  
  278.     MOUSEBLANKMETHOD=<Hardware | FreeSprite>
  279.              Verison V1.3 of ASwarm II always switch of the mouse pointer
  280.              by disabling the sprite dma. This works fine with normal
  281.              graphic modes, but usually fails on one of the new VGA boards.
  282.              When switching to "FreeSprite" ASwarm II uses now a software
  283.              methode which should work with these boards, too. Attention:
  284.              "FreeSprite" damages the mouse pointer on AGA computers, so
  285.              use "Hardware".
  286.  
  287.     NOTE:
  288.      The Tool Type Entries should be written in upper-cases.
  289.  
  290.  
  291.     NOTE: For compatibility reasons, we also support the Tool Type
  292.      'SECONDS' , which is equal to 'TIMEOUT'. If you use the 'Save Config'
  293.      option, 'TIMEOUT' is used.
  294.  
  295. HOT KEYS
  296.     Refer to your AmigaDOS Manual (Section The Extras Programs,
  297.     The Commodities Drawer) to get a valid list of the available hot
  298.     keys, the following may obsolete on a new "commodities.library"
  299.     version.
  300.  
  301.     The Hot Keys can be edited with the String-Gadgets in the 'Edit-Window'
  302.     of ASwarm. The Syntax and Correctness is checked.
  303.  
  304.     SYPNOSIS:  [<qualifier> [<qualifier>...]] <key>
  305.  
  306.         Qualifier keywords (Press and hold one or more qualifier)
  307.  
  308.         alt           either Alt key
  309.         ralt          right Alt key
  310.         lalt          left Alt key
  311.         shift         either Shift key
  312.         rshift        right Shift key
  313.         lshift        left Shift key
  314.         capslock      Caps Lock key
  315.         rcommand      right Amiga key
  316.         lcommand      left Amiga key
  317.         control       Control key
  318.         numericpad    Enables the use of a key on the numeric keypad
  319.         rbutton       Click (and hold) the right mouse button
  320.         midbutton     Click (and hold) the middle mouse button
  321.                       (only avail for mice with a connected third button!)
  322.         leftbutton    Click (and hold) the left mouse button
  323.         newprefs      Preferences changed
  324.         diskremoved   Disk removed
  325.         diskinserted  Disk inserted
  326.  
  327.  
  328.         Keys (to be pressed and released, only ONE Key can be chosen)
  329.  
  330.         a .. z, 0 .. 9, etc.   Normal keys
  331.         f1 .. f10              Function keys
  332.         up, down, left, right  Cursor keys
  333.         help                   Help key
  334.         del                    Delete key
  335.         return                 Return key
  336.         enter                  Enter key
  337.                     (MUST be combined with 'numericpad'!)
  338.         backspace              Backspace key
  339.         esc                    Escape key
  340.         space                  Space key
  341.         comma                  Comma key
  342.         upstroke               Upstroke key
  343.  
  344.  
  345.         Examples
  346.  
  347.         lalt ralt return
  348.         rcommand f10
  349.         alt x
  350.         lalt numericpad enter
  351.  
  352.  
  353.     NOTE: Choose your hotkeys CAREFULLY, because Commodities have a high
  354.      priority in the input events chain (i.e. will override existing
  355.      definitions). Also some hotkeys don't make sense or do collide
  356.      with other tools or functions of the WB.
  357.  
  358.     NOTE: The Workbench screen (ot the default PubScreen, if this one has
  359.      activated the Shanghai--mode) will be moved to front before starting
  360.      the tool via HotKey.
  361.  
  362.     NOTE: When a combination of qualifiers and keys is illegal, ASwarm
  363.      will start, but the Hot Key won't work.
  364.      Example for illegal combinations:
  365.         lalt a b                     # Two keys specified
  366.         control rcommand lcommand    # trivial :-)
  367.         lbutton                      # No key specified
  368.  
  369.      If you edit the Hot Key's in the 'Edit-Window', the Combination will
  370.      be checked. If invalid, the old Hot Key is still used.
  371.  
  372.    NOTE: Due to a bug in the commodities library, it is impossible to
  373.      use a Mousebutton w/o a Qualifier and a Key. (ParseIX() doesn't set
  374.      the ix_QualMask field right)
  375.  
  376.  
  377. EDIT WINDOW
  378.     When the CX_POPUP is set to 'YES' and ASwarm is being started or when
  379.     the hot key was pressed, a window shows up on the Workbench.
  380.     Normally, the workbench is moved to the front.
  381.  
  382.     We've tested ASwarm's Edit Window under many circumstances,
  383.     please give us a short note when you have a problem with it.
  384.  
  385.     You will see some Gadgets and a Scroll-List.
  386.  
  387.     The values inside the Text-Gadgets are via default set to the
  388.     supplied Arguments in the Tool Types or CLI-Parameters.
  389.     On a wrong Enter, the value will be reset to the old value.
  390.  
  391.     You will notice, that some Gadget have names with one character
  392.     underlined. The underlined character refers to the key on the keyboard
  393.     and will alter the entry. Use Shift to alter the entry in the other
  394.     direction.
  395.  
  396.     Keys in "[]" are short-cuts. With them you can access the gadgets
  397.     with the keyboard w/o moving the mouse. In Slider- and Cycle-Gadgets,
  398.     the short-cut key will move the slider to the right, use Shift and
  399.     the key to move the slider to the left.
  400.  
  401.     [T]imeout:
  402.             The specified value for the timeout of the
  403.             blanker. After this time (in seconds) the ASwarm
  404.             shows up. Value may between 1 and 3600.
  405.  
  406.     C[l]ient Timeout:
  407.             The time the server gives to the client for not
  408.             being able to draw anything, then the screen will
  409.             be blanked really to prevent burn-ins.
  410.             Value between 1 and 60.
  411.  
  412.     [S]peed:
  413.             Cycle-Gadget whose modes depend on the used system
  414.             (68000 to 68040).
  415.             Goes from 'Slow Motion' to 'Incredible'.
  416.  
  417.     [W]asps:
  418.             The number of the flying Wasps.
  419.             value between 1 an 10.
  420.  
  421.     B[e]es:
  422.             The number of the Bees.
  423.             Value between 1 and 500.
  424.  
  425.     T[i]ghtness:
  426.             The tightness of te bees referring to the wasps.
  427.             Value between 1 and 10, depends on Speed.
  428.  
  429.     [C]olor Cycling:
  430.             Enable or disable the Color Cycling of the bees.
  431.  
  432.     [A]im Mode:
  433.             Enable or disbale the mode in which the bees are
  434.             looking out for the nearest wasp.
  435.  
  436.     [H]ide:
  437.             Hide the window. All the new entered values will
  438.             be acivated on the next blank.
  439.  
  440.     [B]lank:
  441.             Blank immediately. All the new entered values
  442.             will be activated.
  443.  
  444.     [Q]uit:
  445.             Exit ASwarm. (Use 'Hide' to close the 'Edit-Window')
  446.  
  447.     [M]ouse Blank:
  448.             Switch mouse blanking method (see above).
  449.  
  450.  
  451.     Display Mode:
  452.             (Please refer to the notes below!) Choose a desired
  453.             Mode for the Display during blank-time.
  454.             Use the scroll-bar to show up other available
  455.             modes. This depends on the used system.
  456.             If you only see the System Default Mode, then you have
  457.             wrongly installed your system. Refer to 'Monitors' in
  458.             your AmigaDOS Manual.
  459.  
  460.     MENU ITEMS:
  461.  
  462.      Menu items can also be used via the keyboard, use the shown
  463.      Command Keys.
  464.  
  465.     Project-Menu:
  466.  
  467.      Load Config : Only available on Workbench-Start (either Double-Click
  468.                   or Sys:WBStartup-drawer). Loads the Configuration stored
  469.                   in the Tool Types in the Icon.
  470.  
  471.      Save Config: Only available on Workbench-Start. Saves the actual (!)
  472.                  configuration in the Tool Types of the Icon. This will
  473.                  overwrite all existing Tool Type Entries.
  474.                  It's no longer necessary to edit the Tool Type Entries.
  475.  
  476.      About: Shows up the version and Copyright.
  477.  
  478.      Hide: Hides the Edit-Window.
  479.  
  480.      Quit: Exit Aswarm.
  481.  
  482.     Edit Menu:
  483.  
  484.      Reset To Defaults: Resets all parameters to buildt-in Default Values.
  485.  
  486.  
  487.  
  488. COMMODITIES EXCHANGE
  489.     With the Exchange Tool, you can temporarly stop ASwarm with
  490.     DISABLE, restart it with ENABLE, remove ASwarm with KILL (as would do
  491.     a Quit in the Edit-Window), SHOW up the Edit-Window, and HIDE the
  492.     Edit-Window.
  493.  
  494.     The Exchange Tool is a comfort way to remove or dis/enable
  495.     ASwarm.
  496.  
  497.     Please refer to the AmigaDOS Manual (Section AmigaDOS Reference
  498.     and Workbench Programms) for further docs on Exchange Tool.
  499.  
  500. DISPLAY MODES:
  501.  
  502.                             Attention !
  503.  
  504.     Please, please, please have care here !!!! We are NOT responsible
  505.     for ANY user-error. The given list depends on the used System.
  506.     All newer Amigas, such as A500+, A600, A2000C , A3000 do have the
  507.     ECS Denise for extended Screen Modes (Not all Amiga's with Kick 2.0
  508.     on ROM do have a ECS Denise..). Of course you can start the desired
  509.     Modes, but not all modes are available on all MONITORS !
  510.     Please do refer to your Manual of the Monitor and to the AmigaDOS
  511.     Manual (Section Workbench Programms, AddMonitor) for more
  512.     informations.
  513.     The new Amiga 1200 and 4000 with WB 3.0 and their AGA chips have
  514.     a complete different List as well.
  515.  
  516.     Why ? Simply because you can DESTROY your Monitor!
  517.  
  518.     Here is a list of the (normally given) ECS Display Modes:
  519.     This list may be obsolete when a new workbench is released.
  520.  
  521.         NTSC:Lores
  522.         NTSC:Hires
  523.         NTSC:SuperHires
  524.         NTSC:Lores-Interlaced
  525.         NTSC:Hires-Interlaced
  526.         NTSC:SuperHires-Interlaced
  527.         PAL:Lores
  528.         PAL:Hires
  529.         PAL:SuperHires
  530.         PAL:Lores-Interlaced
  531.         PAL:Hires-Interlaced
  532.         PAL:SuperHires-Interlaced
  533.         VGA-ExtraLores                  # -
  534.         VGA-ExtraLores-Interlaced       #
  535.         VGA-Lores                       #
  536.         VGA-Lores-Interlaced            #   Multiscan Monitor needed
  537.         Productivity                    #
  538.         Productivity-Interlaced         # -
  539.         A2024_10Hz                      #
  540.         A2024_15Hz                      #   A2024 needed.
  541.  
  542.     Other Modes are available from 3rd. Party, but not mentioned.
  543.  
  544.     Overscan is used for all modes, adjust your Overscan-size with
  545.     the ScreenMode Preference Tool.
  546.  
  547.     This list will only be avaible if the icon called "Mode_Names"
  548.     supplied with Workbench 2.0 is in the WBStartup directory of
  549.     your boot drive.
  550.  
  551.     This Mode_Names may also be obsolete in new versions of the workbench.
  552.  
  553.     NOTE:
  554.          DON'T use VGA-Modes on a NON-Multisync or NON-VGA-Monitor
  555.          DON'T even test Modes if you aren't sure about your
  556.          Monitor-capacibilities.
  557.  
  558.     As the original XSwarm runs on a X11-Workstation, and as those
  559.     ones have high graphics resolutions, I prefer SuperHires, as
  560.     this Mode comes near to them. ASwarm II uses 4 colors.
  561.  
  562.     NOTE:
  563.          Again, be careful please. Be warned.
  564.  
  565.     NOTE:
  566.          The above list will be COMPLETLY different if you use WB 3.0
  567.          on one of the new AGA Amigas (A1200/A4000).
  568.  
  569. KNOWN PROBLEMS:
  570.     We do know of some problems and strange behaviours, some of them
  571.     aren't strange anymore, when you read this:
  572.  
  573.     -  Are your running ARQ 1.66 or below ?
  574.        (A replacement Tool for the system requestors).
  575.        Then you may try this:
  576.  
  577.        Change the timeout to a low value, e.g. 5 secs, then type in
  578.        the CLI: wait 10 <RETURN>      (do not wait for the prompt)
  579.                 dir bafasel: <RETURN> (device blafasel: nonexisting)
  580.  
  581.        ASwarm will blank as usual, but then ARQ pops up a requestor
  582.        ON the ASwarm-Screen !! You can't close the Screen until you
  583.        click on 'Abort'. And ASwarm can't blank the screen either
  584.        anymore ! (It's ScreenClose() Command waits for the succesfull
  585.        return...)
  586.  
  587.        This is a BUG in ARQ ! It's dangerous in some cases. It may
  588.        burn in the requestor.
  589.        Get the newest version of ARQ (V1.78) and the problem will vanish.
  590.  
  591.     -  You are running a C-Compiler or a raytracer. ASwarm goes
  592.        blank, but doesn't show any swarm, and during disk-access ASwarm
  593.        comes up for a while.
  594.  
  595.        This is not a Bug, this is THE feature of ASwarm !! This is
  596.        the way ASwarm blanks when high Cpu-use happens on the startup.
  597.        And during disk-access the CPU time is usually less, so ASwarm
  598.        may find time to draw something.
  599.  
  600.     -  Collision with other Blankers. Well, in fact you can run as
  601.        many Blankers as you want. Such as DMouse, Spliner, FracBlanc.
  602.        ASwarm does always try to move it's screen to front, when it
  603.        detects to be behind some other screens.
  604.  
  605.     -  When a disk is inserted, ASwarm closes the screen (dis-blanks).
  606.        This is normal. Disk-replacement is detected as an input
  607.        Event. As all input events shall disable the Blanker this one
  608.        should, too.
  609.  
  610.     -  The window doesn't open if the hotkey is pressed. Perhaps you
  611.        have supplied a wrong hotkey description. Use the Commodities
  612.        Exchange Tool to open the Edit-Window. The hotkey will appear
  613.        in the Gadget 'Pop Key'. You can test the hotkey there. If an
  614.        incorrect hotkey was submitted, the old hotkey will reappear.
  615.  
  616.     -  ASwarm shows up the window though the Tool Type CX_POPUP is
  617.        set to 'NO'. This happens when ASwarm is started twice.
  618.        (Double-click (or call from CLI) = start, another double-click
  619.        (or call from CLI) opens the window)
  620.  
  621.     -  ASwarm is damn slow. Huh .. sorry :-) The Authors have fast
  622.        machines.. Try to reduce the swarm-size (BEES) and the amount
  623.        of swarms. Or use another, less big screen.
  624.  
  625.     -  ASwarm makes noise when it blanks the screen. This may happen
  626.        when a Display Mode is choosen, which is not of the size of
  627.        the upto then active screen. Nothing dangerous.
  628.  
  629.     -  ASwarm makes flickers on the Monitor when it blanks the Screen.
  630.        This happen when ASwarm blanks on a PAL-Screen, but the upto
  631.        then or then active Screen is or was NTSC. (Or vice versa)
  632.        The Monitor needs a bit time to synchronize again. Nothing
  633.        dangerous.
  634.  
  635.     -  There is a 70Hz hack. This hack has problems with the productivity
  636.        Environment. No Bug of ASwarm. WB 3.0 and WB 2.1 offer a "Euro 72"
  637.        monitor which will make ASwarm II work with 70HZ without any problems.
  638.  
  639.     -  There are some guys who don't start the workbench, those may wonder
  640.        that they only can start a Hires-Screen. No magic here, the WB must
  641.        read the Mode_Name in order to get the right resolutions.
  642.        The screenmode-preferences tool seems to have hard-coded resolutions.
  643.        As we want only to use the supported screenmodes, you have to use
  644.        the workbench. Don't tell me about some 30 Kb the Workbench uses!
  645.  
  646.        With WB 2.1 and 3.0 this problem has vanished, too. Just add the
  647.        monitors to your system.
  648.  
  649.     -  The bees don't form nice swarms. This is not a bug, but a
  650.        optimisation error. Has been improved now.
  651.  
  652. CREDITS:
  653.     Jeff Butterworth for his xswarm routine available for X11.
  654.     ASwarm II has improved so much, that we must say it's only loosely
  655.     based upon XSwarm.
  656.  
  657.     Matthew Dillon for DICE. So we could make ASwarm be compilable in
  658.     the most common low-cost C-Compiler for Amiga.(Only registered version)
  659.  
  660.     Greetings to Stefan Becker, german and european distributor
  661.     of DICE, who couldn't be convinced to use ASwarm II ... yet :-) !
  662.  
  663.     SAS/C group for well done work. As yet the SAS version of ASwarm
  664.     is faster and shorter...
  665.  
  666.     Willi 'Amico' Raeckers, always sitting on my nervs, asking for a new
  667.     version :-) (Now with a smily :)
  668.  
  669.     Jörg 'Skull' Bublath, having the idea for the Aim-Mode.
  670.  
  671.     Markus 'Corwin' Stipp, for helping us with DICE and reporting the
  672.     problems with Kickstart 3.0's interleaved bitmaps.
  673.  
  674.     Fred Fish, Mr. Public Domain, hope you like this enough to place
  675.     it onto one of your new 'Fishes'. Permission herebye given.
  676.     (Grmbl.. We're on FF770 and i still have no streamer device :^)
  677.  
  678.     Andrew 'Guardian' Denton for telling us, that Jay Miner likes our
  679.     Blanker, and for having new ideas for future versions of Blankers.
  680.  
  681.     Dr. P. Kittel for allowing us to test ASwarm II under Workbench 2.1
  682.     on the CeBIT '92. It does still work correctly, and even with the new
  683.     features it has. Peter, 'your' Amiga-Ball-Blanker is almost ready :-)
  684.  
  685.     Jake Rose for putting some nice features in ASwarm III which we
  686.     implemented in ASwarm II, too (We didn't take one line of his code ...).
  687.     If he only had suggested those features to us before he created
  688.     a clone ...
  689.  
  690.     Rickard 'Richie' Olsson for telling us, that his cat 'Pixel' likes
  691.     our ASwarm II, and ASwarm convinced him to use a Screenblanker
  692.     at all :-)
  693.  
  694.     Roger 'Budda' Westlund, for the Bug-Report of the 70Hz Hack.
  695.  
  696.     Roland Bless for removing some bugs in the CLI args stuff
  697.  
  698.     Michael 'Massa' Janich for detecting the ugly bug in the blankkey
  699.     routine.
  700.  
  701.     Holger 'Hal' Lubitz for the very good article about ASwarm II in the
  702.     Amiga Plus Magazin 11/92.
  703.  
  704.     Various Net-Freaks for their suggestions and (strange) Bug-Reports.
  705.  
  706.         Markus Illenseer
  707.         Matthias Scheler
  708.          December 1992
  709.