Difference between revisions of "83Plus:BCALLs:500B"
From WikiTI
m (→Comments: added link) |
(Added special behavior discovered by me: B register is destroyed sometimes and bit 7,(iy+28h) is set) |
||
| (4 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| + | [[Category:83Plus:BCALLs:By Name:Input|GetKeyRetOff]] [[Category:83Plus:BCALLs:By Name|GetKeyRetOff]] [[Category:83Plus:BCALLs:By Address|500B - GetKeyRetOff]] | ||
== Synopsis == | == Synopsis == | ||
'''Official Name:''' GetKeyRetOff | '''Official Name:''' GetKeyRetOff | ||
| Line 4: | Line 5: | ||
'''BCALL Address:''' 500B | '''BCALL Address:''' 500B | ||
| − | Gets a keypress from the keyboard. Similar to [[83Plus: | + | Gets a keypress from the keyboard. Similar to [[83Plus:BCALLs:4972|GetKey]], the 2nd+off key combination will return kOff to the caller, instead of turning the calculator off. |
=== Inputs === | === Inputs === | ||
| Line 11: | Line 12: | ||
=== Outputs === | === Outputs === | ||
* A: keycode for key pressed. | * A: keycode for key pressed. | ||
| + | * [[83Plus:RAM:8446|(keyExtend)]] = extended keycode | ||
| + | * bit [[83Plus:Flags:09#Bit_4|onInterrupt, (iy+onFlags)]] set (and A=0) if the On key was pressed | ||
| + | * bit [[83Plus:Flags:28#Bit_7|7,(iy+28h)]] set | ||
| + | * [[83Plus:Flags:12|(iy+shiftFlags)]] contains shift settings | ||
=== Registers Destroyed === | === Registers Destroyed === | ||
* DE, HL | * DE, HL | ||
| + | * B, in some cases (mostly when some ''2nd'' key combination is pressed; needs further testing to determine the exact circumstances) | ||
== Comments == | == Comments == | ||
| − | This function will wait until the user presses a key or key combination, and will APD or accept silent link if they are enabled. Functionally it is the same thing as calling regular [[83Plus: | + | This function will wait until the user presses a key or key combination, and will APD or accept silent link if they are enabled. Functionally it is the same thing as calling regular [[83Plus:BCALLs:4972|GetKey]], except with the [[83Plus:Flags:28#Bit_7|7,(iy+28h)]] flag set first. See ti83plus.inc for the list of return keycodes. |
Latest revision as of 14:50, 25 November 2020
Synopsis
Official Name: GetKeyRetOff
BCALL Address: 500B
Gets a keypress from the keyboard. Similar to GetKey, the 2nd+off key combination will return kOff to the caller, instead of turning the calculator off.
Inputs
None
Outputs
- A: keycode for key pressed.
- (keyExtend) = extended keycode
- bit onInterrupt, (iy+onFlags) set (and A=0) if the On key was pressed
- bit 7,(iy+28h) set
- (iy+shiftFlags) contains shift settings
Registers Destroyed
- DE, HL
- B, in some cases (mostly when some 2nd key combination is pressed; needs further testing to determine the exact circumstances)
Comments
This function will wait until the user presses a key or key combination, and will APD or accept silent link if they are enabled. Functionally it is the same thing as calling regular GetKey, except with the 7,(iy+28h) flag set first. See ti83plus.inc for the list of return keycodes.
