83Plus:BCALLs:500B: Difference between revisions

From WikiTI
Jump to navigationJump to search
m →Comments: added link
FZs (talk | contribs)
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:BCALLS:4972|GetKey]], the 2nd+off key combination will return kOff to the caller, instead of turning the calculator off.
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: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.
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

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.