Stack Diagram

Description

The ASNKEY command assigns a custom behavior to any key in the keyboard. It takes 3 arguments:

• Level 3 - Action: Defines what the key will do when pressed. It can be one of the following:
  1. Any RPL object: RPL Objects will be placed on the stack and evaluated with the XEQ command. While in the editor, they will be decompiled and inserted as text. Some RPL objects will be handled as special cases, as detailed in the following items.
  2. « …Program… »: A standard RPL program that will be executed. While in any context it will close the context and return to the regular stack, just as if the program had been typed into the command line and the user pressed EVAL
  3. :: …Program… ;: An RPL program that will be executed transparently, it will not close the context or modify the user interface. The main difference between a normal program and a transparent one is that for example when executed in the text editor context, the program can modify the command line using any of the editor commands to move the cursor, delete or insert text, etc.
  4. { “String” }: A list with a single string will be considered a symbol. Activating the key will insert the string in the editor. It will open the editor if in any other context.
  5. { Command }: A list with a single command will execute the command following the same rules as the soft menu keys for commands. While the user is in the stack, the command will be executed. When the user is in the editor the command will do different things depending on the cursor mode. In direct mode (D) it will close the editor and execute the command, in algebraic input mode A it will insert the command name in the editor, and finally in programming mode (P) it will insert the command with spaces as if writing an RPL program.
• Level 2 - Key name: This is a string that defines the key press that will trigger the action. The string has to follow a very specific format in order to be a valid key press, is composed of one or more sections separated by a period as in “KEY.SHIFT.MODIFIER”. The first section is mandatory, the next two are optional but cannot be empty, so a modifier cannot be added without specifying a shift first. The first part is the ken name, and can be “A thru Z, 0 thru 9, * - + . or UP/DN/LF/RT, BK for backspace, EN for enter. The modifier indicates the shift mode of the key press and can be L,LH, R,RH, A,AH, OH (for example L=left shift, LH=left shift hold, A=Alpha, OH=On-hold, etc.). Finally, the modifier refers to a specific key event, and it can be one of P,R,L (P=key down, R=key released, L=long press). When not specifying the modifier, the standard key press event will activate the action. Whenever a key doesn't have a long press definition, the action is executed when the key is pressed. However, if the key does have a long press definition, then the action will be delayed until the user releases the key in order to decide whether the normal key or the long press action is triggered.
• Level 1 - Context: This is an integer that defines the context in which the key will be active. The lowest 5 bits are a sub-context number (0-31), the upper bits are the context number. The context changes when the user is interacting with the user interface. So far there's 2 different contexts defined in newRPL: Context 0 is the normal user interface, and Context 32 (#20h) is active when the UI is in Forms mode (not yet implemented as of this writing). The sub-context bits define which part of the interface the user in currently interacting, and can be one of the following:
  1. 0 = Match any sub-context
  2. 1 = The user is using the editor
  3. 2 = The user is using the stack
  4. 4 = The user is using the interactive stack
  5. 8 = The user is using the interactive function plot (not yet implemented)
  6. 16 = The using is using the interactive picture mode (not yet implemented)

Whenever a key is assigned with ASNKEY, it is added first to the list of handlers for that key. If there was a previous definition for that key, it will still be present in the list, so a key can have multiple custom defined actions for different or even the same key, shift and modifiers. Whenever the key is pressed, the system will search for a matching key/shift/modifier group and execute the action. The list is traversed in order, so the last assignment done with ASNKEY will be checked first, therefore can override any previous assignments. Removing a key definition with DELKEY will only remove the last definition that was added, and any previously stored definition will be active. Once the system finds a match, it will execute its action and stop the search unless flag-45 is set. The program can set this flag on purpose to make the system continue the search for other custom key handlers (for example, a program might decide to “pass” on handling the key press, letting other handlers process it). In a similar way, a handler might set flag-46 to cause the default action to be executed. Using both flags lets the system know it needs to search for another custom definition, and if there isn't one, the default action will be taken.

Related Commands