83Plus:BCALLs:500B: Difference between revisions
From WikiTI
Jump to navigationJump to search
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 22: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.