home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / acc / calcs / tn_pcalc.txt < prev   
Text File  |  1992-10-01  |  14KB  |  324 lines
  1.               TAKE NOTE PRINTING/PROGRAMMERS' CALCULATOR v1.0
  2.                      Copyright 1990, Take Note Software 
  3.  
  4.  
  5.           If you are at all familiar with calculators you should have 
  6.      no trouble with this program.  The program may be used as an 
  7.      accessory or as a Gem program (with the extender renamed from 
  8.      ".ACC" to ".PRG").  It has the ability to output to a printer after 
  9.      each entry/calculation or store these and print them out as a 
  10.      group.
  11.           The calculator uses its own window and as such may be dragged 
  12.      around the screen to get it out of the way.  It is closed or 
  13.      removed from operation the same manner as any Gem window.  The 
  14.      program is rather memory hungry (using about 100k) because of the 
  15.      tape function.
  16.  
  17.  
  18.                                   TAPE BOX
  19.  
  20.  
  21.           The box to the right of the calculator is the tape box
  22.      which can display a history of 18 operations at a time and hold 
  23.      999 total.  As you exceed the number of displayable operations you 
  24.      will see the scroll bar at the right of the window reconfigure.  
  25.      You may use the scroll bar to display any portion of the "tape".
  26.           There are five different buttons which affect the tape box.  
  27.  
  28.                TAPE OFF - Turn the tape box off.
  29.                DEC      - See below.
  30.                PRINT    - Print the entire tape.
  31.                CLEAR    - Clear the entire tape
  32.                SPACE    - Insert a blank line in the tape box.
  33.  
  34.  
  35.                                NUMBER FORMATS
  36.  
  37.  
  38.           There are 6 possible formats that you can display numbers in.  
  39.  
  40.                "DEC" decimal, or base 10
  41.                "$"   decimal, base 10 but in dollars and cents format
  42.                      which includes truncating to the second decimal 
  43.                      place.
  44.                Pound Sterling Sign
  45.                      same as the above but...
  46.                "OCT" octal, or base 8
  47.                "BIN" binary or base 2
  48.                "RT"  Running total.  This is available only in the 
  49.                      second display.
  50.  
  51.           There are boxes to the right of all three display areas which 
  52.      control the format of numbers used within.  All three will read 
  53.      "DEC" the first time you use the calculator.  You may cycle 
  54.      through the various formats by clicking on these boxes.
  55.  
  56.  
  57.                             OPERATORS/FUNCTIONS
  58.  
  59.  
  60.           Besides the standard +,-./,*,^ there are operators and 
  61.      functions that programmers often use as described briefly below. 
  62.      These are found to the left of the calculator below the display 
  63.      boxes.
  64.  
  65.           Below are logical operators which act on a pair of numbers 
  66.      bit wise.  
  67.           
  68.           AND - Logical AND.
  69.           NOT - Logical AND NOT.
  70.           OR  - Logical OR.
  71.           XOR - Logical XOR.
  72.  
  73.           Next are the shift and roll functions.  They take a number 
  74.      and shift or roll bits to the left or right.  They can operate 
  75.      using either a "Long" word (32 bits), a "Word" (16 bits) or a 
  76.      "Byte" (8 bits) (see below).  The largest valid argument is 
  77.      32.  Larger numbers are treated as argument MOD 32.  See the next
  78.      entry.
  79.  
  80.           SHR - Shift bits right.
  81.           SHL - Shift bits left.
  82.           ROR - Roll bits right.
  83.           ROL - Roll bits left.
  84.  
  85.  
  86.           LONG -  The button named "Long" does not initiate an
  87.                   operation but controls the number of bits used by
  88.                   the shift and roll functions.  You can change between
  89.                   the three lengths described above by clicking on
  90.                   this box.
  91.  
  92.           There are two functions for changing individual bits (0 to 
  93.      31) of a number.  If you enter an argument greater than 32 the 
  94.      result will reflect the argument MOD 32, e.g., 4 BSET 33 gives the 
  95.      same result as 4 BSET 1.  See "MOD" below.
  96.  
  97.           BSET - Set a bit to ON.
  98.           BCLR - Set a bit to OFF.
  99.  
  100.           The following functions require no argument and operate 
  101.      immediately upon the current number, displaying the result.
  102.  
  103.           SIN  - The sine of a number.
  104.           COS  - The cosine of a number.
  105.           TAN  - The tangent of a number.
  106.           ATAN - The arc tangent of a number.
  107.           ASIN - The arc sine of a number.
  108.           ACOS - The arc cosine of a number.
  109.           DEG  - Converts radians to degrees.
  110.           RAD  - Converts degrees to radians.
  111.           SQR  - The square root of a number.
  112.           LOG  - The logarithm of x base e.
  113.           EXP  - The xth power to the base of a number.
  114.  
  115.           These next functions either round or return a portion of the 
  116.      current number.  They also require no argument.
  117.  
  118.           TRUN - Truncate, returning only the whole portion of a
  119.                  number.  This is not rounding as TRUN(1.51)=1 where
  120.                  ROUN(1.51)=2.
  121.  
  122.           FRAC - Returns only the fractional portion of a number. e.g. 
  123.                  FRAC(1.75)=.75
  124.  
  125.           ROUN - Rounds the current number.
  126.  
  127.           MOD -  The last function was added at the last minute and
  128.                  returns the modulus or remainder of an integer
  129.                  division.  e.g 10 MOD 3=1 or the remainder of 10
  130.                  divided by 3=1.  This function returns only whole
  131.                  numbers and all input will be rounded.
  132.  
  133.  
  134.                                     SEND
  135.  
  136.  
  137.           To the left of the calculator is a button called "SEND". If 
  138.      this is selected when you close the calculator, the number shown 
  139.      in the top display box will be transmitted as a series of 
  140.      keystrokes.  Any application which is monitoring the keyboard 
  141.      should receive it.  This can be handy for sending the results of 
  142.      a calculation to your word processor.  The sent string is padded 
  143.      on both ends with a space.
  144.  
  145.  
  146.                                   PRINTER
  147.  
  148.  
  149.           You may choose to have the calculator print out operations 
  150.      and numbers immediately by clicking on the button that is labeled 
  151.      "Printer".  Normally all output will be to the right side of the 
  152.      paper but if you want to print on narrower paper or are more 
  153.      comfortable with the calculations to the left, select the button 
  154.      named "L. Just.".  This selection will also affect the tape box 
  155.      print-out.
  156.  
  157.  
  158.                                  KEYSTROKES
  159.  
  160.  
  161.           All keys on the numeric keypad and regular keyboard follow 
  162.      their on-screen graphic equivalent.  Additional keystrokes are;
  163.  
  164.           F1       - Cycle through the main display box number formats.
  165.           F2       - Cycle through the translation display formats.
  166.           F3       - Cycle through the tape box formats.
  167.           Undo     - CE (Clear entry).
  168.           Clr/Home - CA (Clear all).
  169.           ")" on the numeric keypad is the equivalent of "^".
  170.  
  171.           "/" on the keyboard is the equivalent of the on-screen "÷".  
  172.           "÷" (Ascii code 246) is also sent to the printer.  This
  173.      character will print as an italic "v" if you're printer is using
  174.      the Epson italic character set but is present in most other
  175.      standard character sets.
  176.  
  177.  
  178.                                  DISCLAIMER
  179.  
  180.           This program has been tested quite a bit but Take Note 
  181.      Software accepts no liability for damage from its' use or misuse 
  182.      and makes no claims as to its suitability for any specific 
  183.      purpose.  If you discover any bugs or have any suggestions to make 
  184.      please feel free to contact us.  Please include this read me file 
  185.      with the program if sharing it with others.
  186.            This program has been released to the public domain 
  187.      and is free.  Of course if you find it useful and want to send us 
  188.      money (maybe 5$? ) we won't argue with you about it.  This is a 
  189.      new concept in software distribution based on guilt called Share-
  190.      your-money-with-us-if-you've-got-it-ware which shouldn't be taken
  191.      too seriously.
  192.  
  193.  
  194.                                               J.L.Jacobi
  195.                                               Take Note Software
  196.                                               285 Divisadero #3
  197.                                               San Francisco, CA  94117
  198.                                               (415)431-9495
  199.  
  200.  
  201.           Take Note Software also publishes commercially, "Take Note",
  202.      a musical ear/sight training program for the Atari ST and Amiga
  203.      computers.  For further information write/call us at the above
  204.      address/phone number.
  205.  
  206.                                 REVISION LOG
  207.  
  208.      V1.1 - 01/06/91
  209.  
  210.      -    Large numbers (outside the range -2,147,483,648 to
  211.      2,147,483,647) entered or translated to hex/octal/binary formats
  212.      no longer crash the system however these numbers will be
  213.      automatically displayed in decimal or floating point no matter
  214.      what type translation is selected.
  215.  
  216.      -    There is now a choice to print to disk as well as the printer.
  217.      The file saved is "TAPE####.ASC" where #### represents the number
  218.      of the tape file.  The program checks to see if previous tape
  219.      files are present and takes the first available number,  i.e., if
  220.      "TAPE1.ASC" is found the file will be saved as "TAPE2.ASC".  The
  221.      files are saved to the default directory (the directory booted to
  222.      or that the program was run from).
  223.  
  224.      V1.11 - 02/01/91
  225.  
  226.           MOD bug fixed.
  227.  
  228.      V1.20 - 03/10/91
  229.  
  230.      -    The Hex number routine has been redone so that it will
  231.      display larger numbers.  A memory function has now been added with
  232.      four options:
  233.  
  234.                     MR - Recall a number from memory.
  235.                     M+ - Add the current number to memory.
  236.                     M- - Subtract the current number from memory.
  237.                     MC - Clear memory.
  238.  
  239.      The corresponding keystrokes are;
  240.  
  241.                     ^CR/^ENTER/^=     MR
  242.                     ^Clr/Home         MC
  243.                     ^+                M+
  244.                     ^-                M- (For some reason this does
  245.                                          not work on a MEGA STe keypad)
  246.  
  247.           These functions occupy the buttons that used to contain the
  248.      tape functions.  All print and tape functions have been moved to a
  249.      dialog box which will appear whenever you click on either "Print"
  250.      or "Tape".
  251.  
  252.      -    There is now a separate "Save" tape option which writes the
  253.      current tape to disk instead of the program prompting you to "Print
  254.      Where?" after you select the "Print" tape button.
  255.  
  256.      -    The bug that would cause the program to bomb if you hit more
  257.      than 31 consecutive zeros after the decimal point has been fixed.
  258.  
  259.      -    Dollar format numbers now are displayed correctly when
  260.      negative.
  261.  
  262.      -    There are now commas (well sort of) for decimal and dollar
  263.      format numbers in the main and translation displays.
  264.  
  265.      -    The tape counter would reset even when you answered no to the
  266.      alert asking if you wanted to clear the tape.  This really screwed
  267.      things up.  It has been fixed.
  268.  
  269.      V1.25  04/17/91
  270.  
  271.      -    Attempting to perform bit operations on floating point
  272.      numbers no longer crashes the system but generates a message
  273.      instead.
  274.  
  275.      -    The "=" sign was being lightened instead of the decimal point
  276.      in version 1.2 when switching to number formats other than decimal
  277.      or $.  It's been fixed.
  278.  
  279.      -    The window now shrinks when the tape function is turned off and
  280.      then expands again when turned on.  It boots with the tape
  281.      function off to save memory and screen space.
  282.  
  283.      -    The calculator remembers its current screen position and
  284.      is placed there the next time it is opened.
  285.  
  286.      -    The program now works in low rez although there is no tape
  287.      function.  Formerly it would try to end itself (A GEM No-No! for
  288.      accessories) and cause a mysterious hang-up (Mysterious because it
  289.      wouldn't register itself in the menu) whenever you tried to run
  290.      another program or switch resolutions.
  291.  
  292.      -    Although I don't have a TT to check out the new graphics
  293.      modes the program should now behave properly with them.  If they
  294.      don't please let me know.
  295.  
  296.      - C-Ops.  For programmers in C you may now have the SHR, SHL, AND,
  297.      OR and XOR buttons appear as the C operators >>, <<, &, | and ^
  298.      by selecting this option which appears in the TAPE/PRINT dialog.
  299.  
  300.  
  301.      V1.26  06/02/92
  302.  
  303.      -  The pounds sterling symbol was added for users of that
  304.      currency as per a request from Paul E. Banbury.  Thanks for the
  305.      suggestion.
  306.  
  307.                                  USERS POLL
  308.  
  309.      PROPOSED Additions:
  310.  
  311.      -    The ability to change numbers on the tape and recalculate any
  312.      affected results (this will probably slow things down a wee bit as
  313.      items will have to be translated on the fly but should save quite a
  314.      bit of space and add a lot of flexibility).
  315.  
  316.      -    The ability to load previously saved tapes.
  317.  
  318.      -    Time format (base 60).
  319.  
  320.           Please let me know what you think of these proposed changes
  321.      or make your wish list known by Genie E-MAIL (address J.JACOBI)
  322.      or writing to me at the address listed somewhere above.
  323.  
  324.