home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d07xx / d0797.lha / BigMec / BIGMec.doc < prev    next >
Text File  |  1993-01-10  |  9KB  |  199 lines
  1.  
  2.    /|||||||||||||||||||||||||||||||||||||||||||||||||||||||||\
  3.    |                                                         |
  4.    |        /////   /////   /////                            |
  5.    |       /    /    /    /                                  |
  6.    |      /    /    /    /          // //   ////    ////     |
  7.     |    /////     /    /  ///    /  /  / /    /  /         |
  8.    |    /    /    /    /     /   /     / /////   /           |
  9.    |   /    /    /    /     /   /     / /       /            |
  10.    |  /////   /////   /////    /     /  ////    ////   v1.0  |
  11.    |                            (BeerIsGood memory-control)  |
  12.    \|||||||||||||||||||||||||||||||||||||||||||||||||||||||||/
  13.  
  14. ^ General futures :
  15.  
  16.     BIGMec is another nutricious SHAREWARE utility for your Amiga, which can
  17.   be used in a wide spectre of applications. Let me emphasize some of them:
  18.  
  19.  -   did you ever want to know how hungry the product of your whole-night
  20.    seanse (ok, ok, it could be a whole-day seanse too) was ? Well, this
  21.    should present no problem to you any more (if you'll ever understand
  22.    what i'm trying to explain here) since BIGMec displays the current
  23.    available space (in the upper part), the space available when you started
  24.    BIGMec (the frozen part in the middle) and the difference between those in
  25.    the lower part of BIGMec. Equalizing the frozen and the available
  26.    space is also a great opportunity to experince some, yet unknown abilities
  27.    of the man's best friend (who said anything about dogs ?) - the mouse.
  28.    Here's what you have to do:
  29.      1) drive your mouse to BIGMec.
  30.      2) tell your mouse to eat the difference.
  31.        IMPORTANT NOTICE:
  32.         you MUST talk into its RIGHT EAR (scientists all over the world
  33.         are still researching this curious phenomena ... (actually a comment
  34.         should follow here, but by the time you read this, the comment shrunk
  35.         into 3 dots in shame and disgrace))
  36.  
  37.  -   Another useful future of BIGMec is the memory spending routine (opposed
  38.    to the usual memory saving routines). Just double-click the left mouse
  39.    button on one of the values under the CHIP, FAST or PUBLIC inscription
  40.    and enter an new value (or press <RETURN> to cancel) in the string
  41.    gadget. You can now edit the value with the cursor keys, delete it
  42.    by pressing the RightAmiga+x keys and undo the changes by pressing the
  43.    RightAmiga+q keys. Instead of double-clicking one of the values, you can
  44.    also press the 'c' key for CHIP, 'f' for FAST or 'p' for PUBLIC.
  45.      This means that you can actually define, how much memory you want to
  46.    have at the time (rounded down to 8 bytes). BIGMec does not restrict
  47.    the access to the memory to other tasks, so the value will change if
  48.    another tasks frees its memory or if you resize a window, ...
  49.      To get your memory back again, select the 'FlushMem' item from the
  50.    'Project' menu.
  51.  
  52.  
  53. ^ To use BIGMec you need :
  54.  
  55.  -   a standard Amiga with at least KICK 1.2.
  56.  
  57.  
  58. ^ Installing BIGMec :
  59.  
  60.  -   all you have to do is to copy it to your c: directory (maybe it should
  61.   be in the System/ dir - choose whatever you prefer).
  62.  
  63.  
  64. ^ Using BIGMec :
  65.  
  66.  -   it can be used from CLI as well as from the WorkBench.
  67.  
  68.  -   starting BIGMec from CLI:
  69.  
  70.        BIGMec OPTIONS (the OPTIONS are listed below)
  71.  
  72.  -   starting BIGMec from WorkBench:
  73.  
  74.          Double-click the BIGMec icon.
  75.  
  76.          If you want to change the options, click the BIGMec icon
  77.        once and select the 'Info' item from the 'Workbench' menu
  78.        (in WB 2.0 the 'Information...' item from the 'Icons'menu).
  79.        Now add a Tool Type (click ADD) and type:
  80.  
  81.          WB_ARGS=OPTIONS (the OPTIONS are the same as the CLI OPTIONS !)
  82.  
  83.          You can just edit the WB_ARGS Tool Type if it is already present.
  84.  
  85.          BIGMec also supports Project Icons, which means you can use more
  86.        icons with different settings with only one copy of BIGMec. Just
  87.        copy a project icon (i.e. the 'Shell') icon to the directory you
  88.        want to start BIGMec from, select the 'Info' menu-item ,change the
  89.        Default Tool to the actual BIGMec's directory (usually 'c:BIGMec')
  90.        and add the new Tool Types (see above).
  91.  
  92.  
  93. ^ the BIGMec CLI OPTIONS are:
  94.  
  95.     - HEX|DEC            use the option HEX for hexadecimal display
  96.                        or DEC for decimal display of the BIGMec
  97.                          The default value is DEC.
  98.  
  99.     - BYTE|KILO|MEGA     the option BYTE displays the BIGMec in bytes
  100.                        while KILO(MEGA) displays them in kilo(mega)-bytes
  101.                          The default value is BYTE.
  102.  
  103.     - FLUSHLIBS          if you need to know the precise memory loss of a
  104.                        a program, use this option, which frees the memory,
  105.                        allocated by unused libraries.
  106.                          BIGMec doesn't flush the libraries out of the
  107.                        memory by default.
  108.  
  109.     - DELAY              determine the window refreshing time of the
  110.                        display in 1/50 sec (DELAY 50 will refresh the
  111.                        display approx. every second). If you think that
  112.                        the display is reacting too slow, just use a smaller
  113.                        value than 25. (Since i use the VBLANK unit of the
  114.                        timer device you can also set the DELAY to 0 - the
  115.                        KICK 1.2/1.3 MICROHZ device can cause a crash for
  116.                        delays smaller than 2 micros). Only the values, that
  117.                        actually differ from the last printed ones are being
  118.                        printed.
  119.                          The default value is DELAY 25.
  120.  
  121.     - MSGS               the nr. of intuition messages to be allocated
  122.                        at the start of the program (the maximum is 100).
  123.                        (since intuition allocates memory for its messages
  124.                        dinamically, it is possible, that it allocates a
  125.                        message for the BIGMec-window while it is
  126.                        delaying between the window refreshes. This would of
  127.                        course affect the final result of the measurement.
  128.                        To prevent this, BIGMec allows you to allocate
  129.                        sufficient memory for the communication with
  130.                        intuition before it actually starts to communicate
  131.                        with you).
  132.                          The default value is MSGS 5
  133.  
  134.     - FROZ|NOFROZ        use the NOFROZ option to hide the Frozen-
  135.                        memory values.
  136.                          The default value is FROZ.
  137.  
  138.     - DIFF|NODIFF        use the NODIFF option to hide the Difference-
  139.                        memory values.
  140.                          The default value is DIFF.
  141.  
  142.     - HELP               A short overview of the commands.
  143.  
  144.  
  145.  - Note:
  146.      You can also use abbrevations (type 'BIGmec ?' from CLI for a complete
  147.    list) instead of the long versions of the options, but be careful -
  148.    while a space is expected between long options, you must set a '-'
  149.    before each short option  (see also the examples !!).
  150.  
  151.  - Examples:
  152.  
  153.      BIGMec HEX KILO DELAY 5 MSGS 3 NOFROZ
  154.  
  155.    will display KiloByte HEX values approx. every 1/10 sec. without
  156.    displaying the FROZN values. Before displaying the values it will also
  157.    allocate memory for 3 intuition messages, which should be enough for a
  158.    medium occupied system.
  159.      The next command lines (using abbrevations) have the same effect :
  160.  
  161.      BIGMec -hkD5M3n
  162.  
  163.      or BIGMec -h -k -D5 -M3 -n,
  164.      or BIGMec HEX -kD5n -M3,
  165.      or BIGMec -kn DELAY 5 -h,
  166.      or BIGMec -D5 -M3h NOFROZ -k,
  167.      or Do i really have to read all this ??
  168.  
  169.    Invalid:
  170.      BIGMec -d 5
  171.      or BIGMec DELAY5
  172.  
  173.  
  174. ^ The BIGMec menus are:
  175.  
  176.      - FlushMem        flush the memory BIGMec allocated after
  177.                      double-clicking one of the "available" values
  178.  
  179.      - Window To Front
  180.                        bring the BIGMec window to front on
  181.                      activation
  182.  
  183.   - All other menu-items are identical to the CLI-options.
  184.  
  185.  
  186. ^ Distributing BIGMec:
  187.  
  188.   BIGMec can be freely distributed without profit - otherwise you need my
  189. permission. In case you find it useful please send me a contribution of
  190. 10 US$ or 15DM (send only cash) to:
  191.  
  192.                         Sandi Tomsic
  193.                         Thumova 21
  194.                         61211 Smartno
  195.                         SLOVENIA
  196.  
  197.   Also send your comments (on the program, the docs, the weather, ...)
  198. your suggestions, bug reports, anything (stolen software excluded).
  199.