CALC 1 Key Editor
The Key Editor is similar adding a number in the Contacts app that comes with your iPhone. You need a label and formula instead of a name and phone number.
You can also use the Key Editor to view the formulas of a key to better understand it. It is a good source of documentation.
To edit a key:
- Display the calculator list.
- Select the blue "more info" button to the right of the calculator name to display the calculator editor. The calculator editor looks like the calculator, but there is no display.
- Select the key you want to edit. This will display the key editor. The key without any "modifiers" (shift, STO, RCL) is different from the key when shift, STO or RCL has been pressed first. Some keys (0-9, ENTER, +/-, EE, del, =f, =, ) cannot be edited.
- Optionally, iPhone users can enable the "Key Editing from Calculators" option and then, from any calculator, swipe the key (right swipe gesture).
The top "LABELS AND HINTS" section of the key editor screen contains the following fields:
- Label: This is the key label that you see on the key. It needs to bee short enough to fit on the key.
- Hint: The hint is the text that is displayed when the key is held.
- Insert:
- Enter text to be inserted into a formula when in algebraic (ALG) calculation mode. The x, y, z, t formulas will not be executed if there is text in the insert field when in ALG mode. This includes operators (+ - * / %).
- Leave blank to execute the x, y, z, t formulas in any calculation mode.
- Enter "=" to evaluate the pending ALG or CHAIN mode formula (pressing the = key for you) and then execute the x, y, z, t formulas. The key hint will append [=] to show the user that the "=" key will be pressed before this key is executed.
- Undo: This controls the undo support for this key.
- History: This controls the history support for this key.
The bottom "FORMULAS" section contains the formulas that will be evaluated when the key is pressed.
When you tap a key in CALC 1 up to 5 formulas are evaluated and the results placed in the stack. When you edit or create a key, you can edit or create the formulas that are evaluated.
To edit any of the fields, select the field to display the editor screen.
Formulas are evaluated in this order:
- Last x Formula
- x Formula
- y Formula
- z Formula
- t Formula
The results of the formulas are placed in their respective register. (rgX(), rgY(), rgZ(), rgT())
If there is no formula, the value of the register is unchanged.
Explanation of how the "Insert" field is used for different calculation modes.
For the √ key shown in the screen shot at the top of this page:
In RPN calculation mode, the "Insert" field is ignored and the formulas are evaluated as follows:
- The Last x Formula is evaluated and simply puts the current value of rgX() into lastRgx().
- The "x Formula" is evaluated and the results are entered in the rgX() value.
- Since there are no y, z or t formulas, those values are unchanged.
In ALG calculation mode, the "sqrt(" text is inserted into the current formula and the FORMULAS section are ignored.
In CHN calculation mode, the formulas are executed as in RPN calculation mode.
During a pending formula the currently entered number is the rgX() value. See the "Add a square root (or other unary function)" example in Calculations Using the Chain (CHN) Calculation Mode.
More Examples
CALC 1 has hundreds of keys that you can look at for examples.
Feel free to contact us using the "Contact" link at the top of every documentation page.
The K key
The K key that stores the operator and right hand value for repetitive calculations has a special Insert field, "selKMode".
This is the first special value insert field that is a "selector". A selector tells CALC 1 to run internal computer code. Selectors are used for the "+/-", "EE", del, "." and other keys but cannot be edited. More selectors may be added in the future to add features and allow users more customization options.