home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / a / ampcalc / !AmpCalc / !Help next >
Text File  |  1994-02-13  |  12KB  |  213 lines

  1.  
  2.                                        AmpCalc
  3.                                       -=======-
  4. v1.77 Sun 13th February 94
  5.  
  6. An 'Armful Production.
  7. Written by and copyright © 1993,1994 Ainsley M. Pereira
  8.  
  9. This application is shareware. If you find it useful you are required to register. (Within 30 days of first using it)
  10. *** REGISTRATION IS FREE (for this version of AmpCalc) ***
  11. Registration is merely so that I know who's using AmpCalc, I'm not expecting vast amounts of dosh for it.
  12.  
  13. To register send a stamped addressed envelope to me (or send a disc to cover postage if you're not in the UK).
  14.  
  15. Advantages of registration:
  16.   • You'll make me happy!
  17.   • You will be entitled to discounts off later versions which may not be free.
  18.   • You won't be breaking the law.
  19.  
  20. If you think that this program is really useful, and that you would really feel guilty about not paying anything for it then give some money to Comic Relief.
  21. To do this, I'm sure Tim Browse won't mind passing on any cheques made payable to Comic Relief (sorry, but I don't know the address myself, and anyway I'm far too forgetful).
  22. Tim Browse (author of the excellent Glazier template editor (also careware)) is at:
  23.   1, Arkle House
  24.   6, Chiltern View Road
  25.   Uxbridge
  26.   Middlesex
  27.   UB8 2PA
  28.  
  29. Copying
  30. -------
  31.   Feel free to distribute as much as you like.
  32.   Exceptions:
  33.   • PD Libraries: Before including this in your catalogue, you must send me
  34.     your latest catalogue disc.
  35.   • Bulletin Boards: I will upload this to Arcade and Digital Databank, so that
  36.     I get the download credits. No one else is allowed to U/L to these two BBs.
  37.     Other BBs please eMail me at my fido point to ask if you can distribute it.     My fido point 2:251/16.50
  38.  
  39. Wonderful features summary
  40. --------------------------
  41.   + Calculations with decimal places (rounded if not in decimal mode)
  42.   + Follows Style Guide
  43.   + SWI number<>name conversion.
  44.   + Correctly copes with OS_WriteI+num and OS_WriteI+"A" (OS_SWINumberFromString
  45.     doesn't...)
  46.   + ASCII code<>character conversion.
  47.   + Bytes<>Kbytes quick conversion.
  48.   + Sprite multipliers for raw sprite data.
  49.   + Plenty of key short cuts.
  50.   + Totals up file sizes from BBS filelists.
  51.   + Rounds to nearest when converting from decimal.
  52.   + As it's got one of those windows that usually gets lost underneath all the
  53.     others, clicking on the iconbar icon or in the calculator window workarea
  54.     will bring it to the front.
  55.   + Itsy-bitsy WimpSlot.
  56.   + You can have hours of fun dragging the windows around without using the
  57.     title bars :-)
  58.   + Has !ampcalc² sprite to support Ting Kuei's DeskPatch.
  59.   + Can convert all SYS/SWI calls in a Basic program from names to numbers
  60.   + Can convert all SYS/SWI calls in a Basic program from numbers to names (but
  61.     see below)
  62.   + Now has Config file in case you don't like some of the wonderful bits :-)
  63.   + Can total filelists created by Febbs (used by some PC boards), to do this
  64.     simply put the first line of the file as FEBBS, see section on using Febbs
  65.     below.
  66.   + Has no less than nine general purpose memories, which can store numbers or
  67.     strings.
  68.   + You can close the window with Ctrl-Q
  69.   + Undo facility
  70.  
  71. Using
  72. -----
  73.   Just type into the icon.
  74.   The icons should all be self explanatory.
  75.   NOTE: The base only affects the output - this is to allow quick conversions.
  76.   (eg. If you are in binary mode then typing 7 [Return] will give %111) This
  77.   means that you *must* put the relevant base thingy before numbers, i.e. & for
  78.   hex, % for binary, (nothing) for decimal when typing calculations. (eg. In
  79.   binary mode just typing 11010101010 [Dec] won't work!)
  80.   Buttons:
  81.     To ASCII code - gives ASCII code of character in display (eg A -> 65)
  82.     From ASCII code - shows ASCII character (eg. &41 -> A)
  83.     To SWI Number - Changes SWI string to number (eg. DragASprite_Stop-> &42401)
  84.     From SWI Number - Changes SWI number to string (eg. 262343 -> Wimp_Poll)
  85.     To Kilobytes - Changes amount shown to Kb (eg. 40960 (bytes) -> 40 (k))
  86.     From Kilobytes - Changes amount shown to bytes (eg. 1 (k) -> 1024 (bytes))
  87.     Sprite Multipliers - Works out memory required for a sprite of size shown
  88.                        in display (eg. 16*16 [Sprite 16] = 128). Does not allow
  89.                        for Acorn sprite format heading as this is for people who
  90.                        write demos, games & stuff.
  91.     Evaluate - Same as pressing Return (or = on a calculator)
  92.     = - If an expression is in the display, then this is the same as pressing
  93.         Return, otherwise it enters '=' so that you can use the ASCII
  94.         conversions on it.
  95.   Keys:
  96.     Return  - Evaluate/Swi name -> number (depends what's in the icon)
  97.     Ctrl-S  - Swi change
  98.     Ctrl-B  - Binary
  99.     Ctrl-D  - Decimal
  100.     Ctrl-X  - heX     (Wimp treats Ctrl-H as delete...)
  101.     Ctrl-Y  - Converts from K to bytes    eg. 2 ^Y = 2048
  102.     Ctrl-K  - Converts from bytes to K    eg. 4096 ^K = 4
  103.     Ctrl-Q  - Closes the window
  104.     f1 - f9 - Recall memory (f1 recalls bank 1, f2 recalls bank 2, you can work
  105.               out the rest...)
  106.     Shift with f1 - f9 - Set memory to whatever is currently being displayed
  107.               (Shift-f1 sets bank 1, Shift-f2 sets bank 2, etc...)
  108.     f10     - Undo last operation
  109.  
  110.   If you are a comms freak then this feature will be useful for you:
  111.   1) Get a file list from your favourite BBS.
  112.   2) Load it up into StrongEd or whatever you use.
  113.   3) Copy the lines with the files you want to download.
  114.   4) Save the text file and then drag it onto the AmpCalc window.
  115.   5) Say "wow!" as the display is set to the total of all the filesizes.
  116.   6) Click on the To KBytes icon to get an approximation of the number of
  117.      seconds it will take to download the lot (if you've got a 9600bps modem
  118.      using Y or Z modem that is.)
  119.  
  120.   AmpCalc only takes notice of lines starting with # or 0, so you can copy the file area lines aswell if you want, and add comment lines.
  121.   eg.
  122.                     Digital Databank d/l list
  123.                     -------------------------
  124.                           (0707) 329306
  125.  
  126. Area: Demos (ARC) (79)
  127. File # Name                 Length Short description
  128. ------ -------------------- ------ ----------------------------------------
  129. 001825 ampdemo1              89234 Ampy's first ever demo
  130. 001411 Krunkdemo            231305 An excellent demo from Krunk of ARMFUL fame!
  131.  
  132. Area: ARMFul (139)
  133. File # Name                 Length Short description
  134. ------ -------------------- ------ ----------------------------------------
  135. 001753 armcoder4             14252 ARMcoder - File security by encrypting/d
  136.                                    ecrypting files
  137. 001752 Hunter                 6127 An OS_UpdateMEMC remover
  138. 001743 discblank             14447 DiskBlank (1.01) - Hides sensitive files
  139.                                     on disc(s)
  140.  
  141. Then you can keep this file in a window beside your comms package, to remind you what you wanted to d/l (or print it if you can't cope with large hi-res modes ;-). Amazing or what?!
  142.  
  143. Using Febbs
  144. -----------
  145. Some PC boards (eg. GABBS, my bossnode) use a program called FEBBS to compile their filelists, these lists are in a different format, so to total a Febbs list (or section thereof), put FEBBS (case sensitive) as the first line, eg:
  146.  
  147. FEBBS
  148. INTHEAIR.ZIP   28629 21/05/93  [0001] "In The Air Tonight" in MOD format
  149. JUSTALL.ZIP   110028 13/08/93  [0001] Metallica's "And Justice For All" - in
  150.  
  151. Lines starting with a space are ignored, so if the description splits over more than one line, it's OK, but you should be careful not to copy the title of the file area if it starts at the left. (This should be OK too, so long as it doesn't have a number in it)
  152.  
  153. SYS Conversion
  154. --------------
  155.  
  156.   To change the SYS calls in a Basic program, drag the Basic file onto the AmpCalc icon, set your options and click on OK.
  157.   WARNING! If I were you I'd keep a backup of the original Basic file before changing. I cannot be held responsible if it messes up the file.
  158.   When changing from numbers to names, it is very possible that the new linelength will be greater than that allowed by Basic (since the names are usually longer than the numbers). If this happens, you will