home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / program / ampcalc / !AmpCalc / !Help next >
Encoding:
Text File  |  1994-06-25  |  12.0 KB  |  282 lines
  1.  
  2.                                        AmpCalc
  3.                                       -=======-
  4. v1.79 Wed 01st June 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
  10. register. (Within 30 days of first using it)
  11.  
  12. *** REGISTRATION IS FREE (for this version of AmpCalc) ***
  13.  
  14. Registration is merely so that I know who's using AmpCalc, I'm not
  15. expecting vast amounts of dosh for it.
  16.  
  17. To register send a stamped addressed envelope to me (or send a disc to
  18. cover postage if you're not in the UK).
  19.  
  20. Advantages of registration:
  21.   • You'll make me happy!
  22.   • You will be entitled to discounts off later versions which may not
  23.     be free.
  24.   • You won't be breaking the law.
  25.  
  26. If you think that this program is really useful, and that you would
  27. really feel guilty about not paying anything for it then give some money
  28. to Comic Relief. To do this, I'm sure Tim Browse won't mind passing on
  29. any cheques made payable to Comic Relief (sorry, but I don't know the
  30. address myself, and anyway I'm far too forgetful).
  31.  
  32. Tim Browse (author of the excellent Glazier template editor (also
  33. careware)) is at:
  34.  
  35.   1, Arkle House
  36.   6, Chiltern View Road
  37.   Uxbridge
  38.   Middlesex
  39.   UB8 2PA
  40.  
  41. Copying
  42. -------
  43.   Feel free to distribute as much as you like.
  44.   Exceptions:
  45.  
  46.   • PD Libraries: Before including this in your catalogue, you must send
  47.     me your latest catalogue disc.
  48.  
  49.   • Bulletin Boards: I will upload this to Arcade and Digital Databank,
  50.     so that I get the download credits. No one else is allowed to U/L to
  51.     these two BBs. Other BBs please eMail me at my fido point to ask if
  52.     you can distribute it.
  53.  
  54.      My fido point 2:250/219.5
  55.  
  56. Wonderful features summary
  57. --------------------------
  58.   + Calculations with decimal places (rounded if not in decimal mode)
  59.   + Follows Style Guide
  60.   + SWI number<>name conversion.
  61.   + Correctly copes with OS_WriteI+num and OS_WriteI+"A"
  62.     (OS_SWINumberFromString doesn't...)
  63.   + ASCII code<>character conversion.
  64.   + Bytes<>Kbytes quick conversion.
  65.   + Sprite multipliers for raw sprite data.
  66.   + Plenty of key short cuts.
  67.   + Totals up file sizes from BBS filelists.
  68.   + Rounds to nearest when converting from decimal.
  69.   + As it's got one of those windows that usually gets lost underneath
  70.     all the others, clicking on the iconbar icon or in the calculator
  71.     window workarea will bring it to the front.
  72.   + Itsy-bitsy WimpSlot.
  73.   + You can have hours of fun dragging the windows around without using
  74.     the title bars :-)
  75.   + Has !ampcalc² sprite to support Ting Kuei's DeskPatch.
  76.   + Can convert all SYS/SWI calls in a Basic program from names to
  77.     numbers
  78.   + Can convert all SYS/SWI calls in a Basic program from numbers to
  79.     names (but see below)
  80.   + Now has Config file in case you don't like some of the wonderful
  81.     bits :-)
  82.   + Can total filelists created by Febbs (used by some PC boards), to do
  83.     this
  84.     simply put the first line of the file as FEBBS, see section on using
  85.     Febbs below.
  86.   + Has no less than nine general purpose memories, which can store
  87.     numbers or strings.
  88.   + You can close the window with Ctrl-Q
  89.   + Undo facility
  90.   + Supports StrongHelp
  91.  
  92. Using -----
  93.   Just type into the icon.
  94.   The icons should all be self explanatory.
  95.   NOTE: The base only affects the output - this is to allow quick conversions.
  96.   (eg. If you are in binary mode then typing 7 [Return] will give %111) This
  97.   means that you *must* put the relevant base thingy before numbers, i.e. & for
  98.   hex, % for binary, (nothing) for decimal when typing calculations. (eg. In
  99.   binary mode just typing 11010101010 [Dec] won't work!)
  100.   Buttons:
  101.     To ASCII code - gives ASCII code of character in display (eg A -> 65)
  102.     From ASCII code - shows ASCII character (eg. &41 -> A)
  103.     To SWI Number - Changes SWI string to number (eg. DragASprite_Stop-> &42401)
  104.     From SWI Number - Changes SWI number to string (eg. 262343 -> Wimp_Poll)
  105.     To Kilobytes - Changes amount shown to Kb (eg. 40960 (bytes) -> 40 (k))
  106.     From Kilobytes - Changes amount shown to bytes (eg. 1 (k) -> 1024 (bytes))
  107.     Sprite Multipliers - Works out memory required for a sprite of size shown
  108.                        in display (eg. 16*16 [Sprite 16] = 128). Does not allow
  109.                        for Acorn sprite format heading as this is for people who
  110.                        write demos, games & stuff.
  111.     Evaluate - Same as pressing Return (or = on a calculator)
  112.     = - If an expression is in the display, then this is the same as pressing
  113.         Return, otherwise it enters '=' so that you can use the ASCII
  114.         conversions on it.
  115.   Keys:
  116.     Return  - Evaluate/Swi name -> number (depends what's in the icon)
  117.     Ctrl-S  - Swi change
  118.     Ctrl-B  - Binary
  119.     Ctrl-D  - Decimal
  120.     Ctrl-X  - heX     (Wimp treats Ctrl-H as delete...)
  121.     Ctrl-Y  - Converts from K to bytes    eg. 2 ^Y = 2048
  122.     Ctrl-K  - Converts from bytes to K    eg. 4096 ^K = 4
  123.     Ctrl-Q  - Closes the window
  124.     f1      - Get help from StrongHelp. You can specify the helpsystem to
  125.               search in too, in case you have some which clash. eg.
  126.               SWI.Wimp_Poll specifies the SWI, whereas Wimp_Poll might give the
  127.               C Function of the same name.
  128.     f2 - f9 - Recall memory (f2 recalls bank 1, f3 recalls bank 2, you can work
  129.               out the rest...)
  130.     Shift with f2 - f9 - Set memory to whatever is currently being displayed
  131.               (Shift-f2 sets bank 1, Shift-f3 sets bank 2, etc...)
  132.     f10     - Undo last operation
  133.  
  134.   If you are a comms freak then this feature will be useful for you:
  135.   1) Get a file list from your favourite BBS.
  136.   2) Load it up into StrongEd or whatever you use.
  137.   3) Copy the lines with the files you want to download.
  138.   4) Save the text file and then drag it onto the AmpCalc window.
  139.   5) Say "wow!" as the display is set to the total of all the filesizes.
  140.   6) Click on the To KBytes icon to get an approximation of the number of
  141.      seconds it will take to download the lot (if you've got a 9600bps modem
  142.      using Y or Z modem that is.)
  143.  
  144.   AmpCalc only takes notice of lines starting with # or 0, so you can
  145.   copy the file area lines aswell if you want, and add comment lines. eg.
  146.  
  147.                     Digital Databank d/l list
  148.                     -------------------------
  149.                           (0707) 329306
  150.  
  151. Area: Demos (ARC) (79)
  152. File # Name                 Length Short description
  153. ------ -------------------- ------ ----------------------------------------
  154. 001825 ampdemo1              89234 Ampy's first ever demo
  155. 001411 Krunkdemo            231305 An excellent demo from Krunk of ARMFUL fame!
  156.  
  157. Area: ARMFul (139)
  158. File # Name                 Length Short description
  159. ------ -------------------- ------ ----------------------------------------
  160. 001753 armcoder4             14252 ARMcoder - File security by encrypting/d
  161.                                    ecrypting files
  162. 001752 Hunter                 6127 An OS_UpdateMEMC remover
  163. 001743 discblank             14447 DiskBlank (1.01) - Hides sensitive files
  164.                                     on disc(s)
  165.  
  166. Then you can keep this file in a window beside your comms package, to
  167. remind you what you wanted to d/l (or print it if you can't cope with
  168. large hi-res modes ;-). Amazing or what?!
  169.  
  170. Using Febbs
  171. -----------
  172. Some PC boards (eg. GABBS, my exbossnode) use a program called FEBBS to
  173. compile their filelists, these lists are in a different format, so to
  174. total a Febbs list (or section thereof), put FEBBS (case sensitive) as
  175. the first line, eg:
  176.  
  177. FEBBS
  178. INTHEAIR.ZIP   28629 21/05/93  [0001] "In The Air Tonight" in MOD format
  179. JUSTALL.ZIP   110028 13/08/93  [0001] Metallica's "And Justice For All" - in
  180.  
  181. Lines starting with a space are ignored, so if the description splits
  182. over more than one line, it's OK, but you should be careful not to copy
  183. the title of the file area if it starts at the left. (This should be OK
  184. too, so long as it doesn't have a number in it)
  185.  
  186. SYS Conversion
  187. --------------
  188.  
  189.   To change the SYS calls in a Basic program, drag the Basic file onto
  190. the AmpCalc icon, set your options and click on OK.
  191.   WARNING! If I were you I'd keep a backup of the original Basic file
  192. before changing. I cannot be held responsible if it messes up the file.
  193.   When changing from numbers to names, it is very possible that the new
  194. linelength will be greater than that allowed by Basic (since the names
  195. are usually longer than the numbers). If this happens, you will get an
  196. "Expanded line too long" error, and the operation will be aborted
  197. (leaving the original file intact).
  198.  
  199.   The options you have available are:
  200.   To numbers/To names - What you want it changed to.
  201.   Hexadecimal         - If you're changing to numbers, then this selects
  202.                         whether they should be in hex or not (the alternative
  203.                         is decimal, and no, I'm not putting binary in, OK?)
  204.   Space               - This determines whether a space should be put between
  205.                         the SYS and the parameter. It works with either To
  206.                         numbers or To names.
  207.  
  208.   Note that the SYS will only be altered if it's not in the form you
  209. want it, as far as numerical/string goes. ie. If you're changing from
  210. names to decimal numbers, and a SYS &400C7 is encountered, it will
  211. remain SYS &400C7 and not get changed to decimal. (If you're really that
  212. fussy, then change everything to names first, then to decimal).
  213.  
  214.   Only SYS calls that are currently known about can be converted. ie. If
  215. the program uses a nonstandard SYS call, then make sure the module that
  216. provides it is loaded.
  217.  
  218.   Conversion of SWIs (ie SYSs called from bits inside [], by assembler
  219. routines) is also supported now, but there's a drawback. SYS is
  220. tokenised by BASIC, so is easy to pick out from the rest of the mess,
  221. SWI however is not tokenised, and can be upper or lower case.
  222. Consequently, if you're converting a program that has a variable with
  223. swi in it, (basswi% for example), then you'll get some strange errors,
  224. such as Unknown or missing variable. To prevent this from happening, you
  225. can turn SWI conversion off altogether, by altering a line in the Config
  226. file. This means that SYS calls only get converted.
  227.  
  228.   I hope that only a few programs will be awkward in this way.
  229.  
  230. The Config file
  231. ---------------
  232.   Within the !AmpCalc directory there is a config file. This was put in
  233. so because a user didn't like the way you can drag windows around, and
  234. found the arrows to convert to and from ASCII/SWI/Kilobytes confusing.
  235. (The arrows point toward what your changing to, btw)
  236.  
  237.   Anyway, now you can decide how AmpCalc is, and here's how:
  238.   Any line starting with a | is a comment.
  239.   The whole thing is case insensitive.
  240.   The other lines in the config file are options, in the following format:
  241.  
  242. Option      :Parameter
  243.  
  244. There must be a colon immediately before the parameter, but the number
  245. of spaces *before* the colon doesn't matter.
  246.  
  247. The options supported are:
  248.  
  249. Conversions     - can either be Text or Arrows
  250. DragWindows     - can either be Yes or No
  251. SwiConversions  - can either be Yes or No (see "SYS Conversion" above)
  252. OpenOnStartup   - can either be Yes or No
  253.  
  254. These should be fairly self explanatory, but if not, experiment!
  255.  
  256. Coming soon (maybe)
  257. -------------------
  258.   Bugfix for: Sometimes the Expanded line too long error is reported as
  259. unknown or missing variable (mumble mumble, mutter mutter)
  260.  
  261. Merry calculations!
  262.   /\      _
  263.  (--)/\/\|_)
  264.    /     |
  265.  
  266. Contacts:
  267.  Amp                 Internet: insley@nowster.demon.co.uk
  268.  Al Sirat            Netmail: 2:250/219.5 @ fidonet.org or 2:251/25.5 @ fidonet
  269.  Chapel Road         Or private mail on Digital Databank, or Arcade,
  270.  Swanmore                       (though don't expect a fast response on these
  271.  Hants SO32 2QA                   boards)
  272.  
  273. Note that in previous releases my fidonet address was given as
  274. 2:251/16.50, this was my point off GABBS, a bulletin board which has now
  275. left fidonet, unfortunately. My new local address is 2:251/25.5 which is
  276. my point off Fareham BBS, but you can still send mail to 2:250/219.5 (my
  277. point off the Plasma Sphere), if you like.
  278.  
  279. *** MAIL TO 2:251/16.50 WILL NOT REACH ME ANYMORE ***
  280.  
  281. 'Armful-1994--------------------------------------------------------------------
  282.