Difference between revisions of "83Plus:BCALLs:500B"

From WikiTI
Jump to: navigation, search
m (Added categories)
(Added special behavior discovered by me: B register is destroyed sometimes and bit 7,(iy+28h) is set)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Category:83Plus:BCALLs:By Name:Input|GetKeyRetOff]]
+
[[Category:83Plus:BCALLs:By Name:Input|GetKeyRetOff]] [[Category:83Plus:BCALLs:By Name|GetKeyRetOff]] [[Category:83Plus:BCALLs:By Address|500B - GetKeyRetOff]]
[[Category:83Plus:BCALLs:By Name|GetKeyRetOff]]
+
[[Category:83Plus:BCALLs:By Address|500B - GetKeyRetOff]]
+
 
== Synopsis ==
 
== Synopsis ==
 
'''Official Name:''' GetKeyRetOff
 
'''Official Name:''' GetKeyRetOff
Line 7: 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 14: 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 15: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.