home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / program / misc / tn_pcalc / tn_pcalc.txt < prev   
Text File  |  1990-12-18  |  9KB  |  205 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.                  "HEX" hexadecimal, or base 16
  45.                  "OCT" octal, or base 8
  46.                  "BIN" binary or base 2
  47.                  "RT"  Running total.  This is available only in the 
  48.                        second display.
  49.  
  50.             There are boxes to the right of all three display areas which 
  51.        control the format of numbers used within.  All three will read 
  52.        "DEC" the first time you use the calculator.  You may cycle 
  53.        through the various formats by clicking on these boxes.
  54.  
  55.  
  56.                               OPERATORS/FUNCTIONS
  57.  
  58.  
  59.             Besides the standard +,-./,*,^ there are operators and 
  60.        functions that programmers often use as described briefly below. 
  61.        These are found to the left of the calculator below the display 
  62.        boxes.
  63.  
  64.             Below are logical operators which act on a pair of numbers 
  65.        bit wise.  
  66.             
  67.             AND - Logical AND.
  68.             NOT - Logical AND NOT.
  69.             OR  - Logical OR.
  70.             XOR - Logical XOR.
  71.  
  72.             Next are the shift and roll functions.  They take a number 
  73.        and shift or roll bits to the left or right.  They can operate 
  74.        using either a "Long" word (32 bits), a "Word" (16 bits) or a 
  75.        "Byte" (8 bits) (see below).  The largest valid argument is 
  76.        32.  Larger numbers are treated as argument MOD 32.  See the next
  77.        entry.
  78.  
  79.             SHR - Shift bits right.
  80.             SHL - Shift bits left.
  81.             ROR - Roll bits right.
  82.             ROL - Roll bits left.
  83.  
  84.  
  85.             LONG -  The button named "Long" does not initiate an
  86.                     operation but controls the number of bits used by
  87.                     the shift and roll functions.  You can change between
  88.                     the three lengths described above by clicking on
  89.                     this box.
  90.  
  91.             There are two functions for changing individual bits (0 to 
  92.        31) of a number.  If you enter an argument greater than 32 the 
  93.        result will reflect the argument MOD 32, e.g., 4 BSET 33 gives the 
  94.        same result as 4 BSET 1.  See "MOD" below.
  95.  
  96.             BSET - Set a bit to ON.
  97.             BCLR - Set a bit to OFF.
  98.  
  99.             The following functions require no argument and operate 
  100.        immediately upon the current number, displaying the result.
  101.  
  102.             SIN  - The sine of a number.
  103.             COS  - The cosine of a number.
  104.             TAN  - The tangent of a number.
  105.             ATAN - The arc tangent of a number.
  106.             ASIN - The arc sine of a number.
  107.             ACOS - The arc cosine of a number.
  108.             DEG  - Converts radians to degrees.
  109.             RAD  - Converts degrees to radians.
  110.             SQR  - The square root of a number.
  111.             LOG  - The logarithm of x base e.
  112.             EXP  - The xth power to the base of a number.
  113.  
  114.             These next functions either round or return a portion of the 
  115.        current number.  They also require no argument.
  116.  
  117.             TRUN - Truncate, returning only the whole portion of a
  118.                    number.  This is not rounding as TRUN(1.51)=1 where
  119.                    ROUN(1.51)=2.
  120.  
  121.             FRAC - Returns only the fractional portion of a number. e.g. 
  122.                    FRAC(1.75)=.75
  123.  
  124.             ROUN - Rounds the current number.
  125.  
  126.             MOD -  The last function was added at the last minute and
  127.                    returns the modulus or remainder of an integer
  128.                    division.  e.g 10 MOD 3=1 or the remainder of 10
  129.                    divided by 3=1.  This function returns only whole
  130.                    numbers and all input will be rounded.
  131.  
  132.  
  133.                                       SEND
  134.  
  135.  
  136.             To the left of the calculator is a button called "SEND". If 
  137.        this is selected when you close the calculator, the number shown 
  138.        in the top display box will be transmitted as a series of 
  139.        keystrokes.  Any application which is monitoring the keyboard 
  140.        should receive it.  This can be handy for sending the results of 
  141.        a calculation to your word processor.  The sent string is padded 
  142.        on both ends with a space.
  143.  
  144.  
  145.                                     PRINTER
  146.  
  147.  
  148.             You may choose to have the calculator print out operations 
  149.        and numbers immediately by clicking on the button that is labeled 
  150.        "Printer".  Normally all output will be to the right side of the 
  151.        paper but if you want to print on narrower paper or are more 
  152.        comfortable with the calculations to the left, select the button 
  153.        named "L. Just.".  This selection will also affect the tape box 
  154.        print-out.
  155.  
  156.  
  157.                                    KEYSTROKES
  158.  
  159.  
  160.             All keys on the numeric keypad and regular keyboard follow 
  161.        their on-screen graphic equivalent.  Additional keystrokes are;
  162.  
  163.             F1       - Cycle through the main display box number formats.
  164.             F2       - Cycle through the translation display formats.
  165.             F3       - Cycle through the tape box formats.
  166.             Undo     - CE (Clear entry).
  167.             Clr/Home - CA (Clear all).
  168.             ")" on the numeric keypad is the equivalent of "^".
  169.  
  170.             "/" on the keyboard is the equivalent of the on-screen "÷".  
  171.             "÷" (Ascii code 246) is also sent to the printer.  This
  172.        character will print as an italic "v" if you're printer is using
  173.        the Epson italic character set but is present in most other
  174.        standard character sets.
  175.  
  176.  
  177.                                    DISCLAIMER
  178.  
  179.             This program has been tested quite a bit but Take Note 
  180.        Software accepts no liability for damage from its' use or misuse 
  181.        and makes no claims as to its suitability for any specific 
  182.        purpose.  If you discover any bugs or have any suggestions to make 
  183.        please feel free to contact us.  Please include this read me file 
  184.        with the program if sharing it with others.
  185.              This program has been released to the public domain 
  186.        and is free.  Of course if you find it useful and want to send us 
  187.        money (maybe 5$? ) we won't argue with you about it.  This is a 
  188.        new concept in software distribution based on guilt called Share-
  189.        your-money-with-us-if-you've-got-it-ware which shouldn't be taken
  190.        too seriously.
  191.  
  192.  
  193.                                                 J.L.Jacobi
  194.                                                 Take Note Software
  195.                                                 285 Divisadero #3
  196.                                                 San Francisco, CA  94117
  197.                                                 (415)431-9495
  198.  
  199.  
  200.             Take Note Software also publishes commercially, "Take Note",
  201.        a musical ear/sight training program for the Atari ST and Amiga
  202.        computers.  For further information write/call us at the above
  203.        address/phone number.
  204.  
  205.