home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / maths / progs / hpcalc / !HPCalc / !Readme < prev    next >
Encoding:
Text File  |  1992-05-07  |  7.3 KB  |  226 lines
  1. ->!ReadMe
  2.  
  3.                             HP Scientific Calculator
  4.                             ========================
  5.  
  6. This disc contains an almost complete emulation of the Hewlett Packard HP15C
  7. Scientific Calculator using Reverse Polish Notation for RISC OS on the
  8. Archimedes.
  9.  
  10. The contents of this disc, are as follows;
  11.  
  12. !ReadMe       This file.
  13. !Boot         HpCalc !Boot file.
  14. !Run          HpCalc !Run file.
  15. !RunImage     HpCalc code.
  16. !RunMe        Display !ReadMe file.
  17. !Help         Help text file
  18. !Sprites      Directory of sprite files for HpCalc application.
  19. Keyboard1     Directory of sprite files for normal keyboard.
  20. Keyboard2     Directory of sprite files for function 'f' keyboard.
  21. Keyboard3     Directory of sprite files for function 'g' keyboard.
  22. stores1       Store of calculator registers and partial state.
  23. Templates     Window templates.
  24. Modules       Module directory containing
  25.   Clib        The Shared C Library module from the RISC OS !System folder.
  26.   FPEmulator  Floating point emulator from the RISC OS !System folder.
  27.  
  28. Memory Requirements
  29. ===================
  30.  
  31. Module Area   Sufficient for Clib and FPEmulator
  32. Program Area  256K
  33.  
  34. Getting Started
  35. ===============
  36.  
  37. To copy this application onto another disc or install it on the hard disc
  38. open a directory viewer on the destination disc within the RISC OS Desktop
  39. and drag the !HpCalc icon to the destination directory.
  40.  
  41. Note that the caculator uses the porterhouse font, therefore the !Font
  42. directory from the system directory must be installed on the hard disc or the
  43. calculator disc and the system variable Font$Prefix must be set.
  44.  
  45. The calculator may be installed on the iconbar by double clicking on the
  46. !HpCalc icon.
  47.  
  48. The calculator is then displayed on selection of the HP icon on the iconbar.
  49.  
  50. The calculator display may be removed from the screen area by selecting the
  51. 'exit' menu option while the mouse pointer is over the calculator. The icon
  52. remains on the iconbar and the calculators state and registers are 
  53. maintained.
  54.  
  55. The calculator may be quited by selecting the 'quit' option of the HP icon
  56. menu. On quiting the current state of the calculator is saved to the file
  57. 'stores1'.
  58.  
  59. Enhanced Operation
  60. ==================
  61.  
  62. The final line of the !Run obey file includes the Run command for the
  63. calculator, i.e.
  64.  
  65.   Run <Obey$Dir>.!RunImage
  66.  
  67. Now !RunImage can take up to two numerical arguments acting as binary
  68. switches. Each argument may take a value 0 or 1, the default is 0.
  69.  
  70. The first argument causes the calculator to be displayed immediately when
  71. the application is run, e.g.
  72.  
  73.   Run <Obey$Dir>.!RunImage 1
  74.  
  75. The second argument causes the sprite files for the keyboard to only be
  76. loaded when the calculator is being displayed. In this case only 96K of
  77. program memory is required when the calculator is loaded on the icon bar but
  78. not displayed. Not that this should only be used if the disc containing the
  79. calculator is left on the computer, e.g.
  80.  
  81.   Run <Obey$Dir>.!RunImage 0 1
  82.  
  83. Functionality
  84. =============
  85.  
  86. The calculator implements all of the functions described within the HP-15C
  87. Owner's Handbook January 1985, with the exception of the following:-
  88.  
  89.   Matrix Functions
  90.   Programmable Functions
  91.   Numerical Integration
  92.   Roots of Equation 
  93.  
  94. The following HP-15C functions have been implemented:-
  95.  
  96.   Arithmetic Functions
  97.   Numerical Functions
  98.   Trigonometric Functions
  99.   Time and Angle Conversions
  100.   Degrees/Radian Conversions
  101.   Coordinate Conversions
  102.   Logarithmic Functions
  103.   Hyperbolic Functions
  104.   Permutations and Combinations
  105.   One and Two Variable Statistic Functions
  106.   Complex Number Calculations
  107.   67 Direct and Indirect Storage Registers
  108.   Register Arithmetic
  109.   Display Control
  110.   
  111. The following additional functions have been implemented:-
  112.  
  113.   Hexadecimal Operation
  114.   Dual Displays
  115.   Simultaneous Display of Real and Imaginary part of Complex Numbers
  116.   Enhanced Number Limits
  117.   
  118. Basic Operation
  119. ===============
  120.  
  121. The calculator can be dragged around the screen on selection of the display
  122. area above the keyboard.
  123.  
  124. As the mouse pointer is moved over a key icon on the keyboard the icon is
  125. highlighted.
  126.  
  127. Clicking the select button on the key icon then causes the operation
  128. indicated by the key to be actioned.
  129.  
  130. Clicking the adjust button on the key icon, when the normal keyboard is being
  131. displayed, causes the corresponding 'g' function key to be actioned.
  132.  
  133. The 'f' and 'g' keys cause the function keyboards to be displayed.
  134.  
  135. The key sequence g hex n, where n is a digit between 1 and 9, causes the
  136. calculator to display all values as a n digit hexadecimal number. In this
  137. mode the function keys A - F cause the corresponding hexadecimal characters
  138. to be displayed. When changing between a hex format and a natural format
  139. translation takes place.
  140.  
  141. The 'on' key has no effect.
  142.  
  143. The Archimedes keyboard can also be used to control the calculator while the
  144. mouse pointer is over the calculator:
  145.  
  146.    The numeric keys 0 to 9 and . allow numbers to be entered into the
  147.    display.
  148.  
  149.    The keys + - / and * cause the corresponding arithmetical operations
  150.    to be actioned.
  151.  
  152.    Enter and Return have the same action as the 'ENTER' key on the
  153.    calculator.
  154.  
  155.    The up and down arrow keys cause the register stack to roll up and down
  156.    respectively.
  157.  
  158. The mouse menu button causes the HpCalc menu to appear while the mouse
  159. pointer is anywhere over the calculator. The following menu options are
  160. available:
  161.  
  162.    Info  details information about the program
  163.  
  164.    Single causes the calculator to display a single value. In Normal Mode
  165.    this corresponds to the X stack register. In Complex Mode this
  166.    corresponds to the real part of the X stack register.
  167.  
  168.    Double causes the calculator to display two values. In Normal Mode the
  169.    top value corresponds to the Y stack register and the bottom to the X
  170.    stack register. In Complex Mode the top value corresponds to the 
  171.    imaginary part of the X stack register and the bottom value to the real
  172.    part of the same register.
  173.  
  174.    Exit causes the calculator windows to be closed and the dynamic memory to
  175.    be freed. 
  176.  
  177. The current value of the X stack register is available as the system
  178. variables HpCalc$Re and HpCalc$Im. The latter is only present when the
  179. calculator is in Complex Mode. 
  180.  
  181. Limits
  182. ======
  183.  
  184. The calculator performs all internal mathematical calculations using double
  185. precision floating point numbers with limits as defined in the float.h
  186. header of ANSI C.
  187.  
  188. Known Bugs
  189. ==========
  190.  
  191. Engineering mode display is the same as scientific mode.
  192.  
  193. Problems may occur when switching between the high resolution modes such as
  194. 24 and the normal modes such as 12.
  195.  
  196. Operation in 256 colour modes is disappointing (needs the ARM3 but not until
  197. it retails for around £200 (I am an ASIC designer)).
  198.  
  199. High resolution numbers with a large (i.e. > 99) exponential may drift off to
  200. the right of the display. This is because a proportionally spaced font is
  201. being used.
  202.  
  203. Operation with multisync monitors has not be checked.
  204.  
  205. =============================================================================
  206.  
  207. Release 1.00 January 1990
  208.  
  209. (c) Copyright Peter Tuson 1990
  210.  
  211. ======
  212.  
  213. If you find this program useful or interesting a donation of £5 sterling,
  214. sent to the address below, would be much appreciated.
  215.  
  216. If you have any comments, suggestions, more bug reports or complaints,
  217. please write to the following address. This does not constitute a committment
  218. to correct reported bugs.
  219.  
  220. Dr. P.R.Tuson
  221. 70, Connaught Road
  222. Fleet
  223. Hants.
  224. GU13 9QY
  225. United Kingdom.
  226.