83Plus:Hooks:9B84

2005-03-28T16:53:20Z

130.215.232.102:

[[Category:83Plus:Hooks:By_Name|Raw Key Hook]]
[[Category:83Plus:Hooks:By_Address|9B84 - Raw Key Hook]]
== Synopsis ==
'''Name:''' Raw Key ''(has had other names proposed, which are discouraged -- see notes below.)''

'''Hook Pointer Block Address:''' [[83Plus:RAM:9B84|9B84]]

'''Hook Enable BCALL:''' [[83Plus:BCALLs:4F66|4F66]]

'''Hook Disable BCALL:''' [[83Plus:BCALLs:4F6F|4F6F]]

'''Hook Call BCALL:''' [[83Plus:BCALLs:4F5D|4F5D]]

'''Hook Active Flag:''' 5, (iy + 34h)

This hook allows you to change the values that [[83Plus:BCALLs:4972|GetKey]] returns.

== Using the Hook ==

This hook is called any time a key is accepted by [[83Plus:BCALLs:4972|GetKey]]. It is called for kOff only if bit [[83Plus:Flags:28#Bit_7|7,(iy+28h)]] is set.

* A = keycode; ([[83Plus:RAM:8446|keyExtend]]) = extended keycode
** You can modify these values to change the key that is "pressed."
* Return with Z set if the keypress should be ignored.

== Comments ==
This hook is one of the four "official" hooks defined in ti83plus.inc. However, it appears that someone at TI made a mistake in adding its address, because it does not in fact have anything to do with "raw" keys. It has been suggested that this was intended to be called the "GetKey" hook. To avoid possible confusion with [[83Plus:Hooks:9B88|another hook]], the name "Raw Key" should be used nevertheless.

== Example ==
The following code will swap the Apps and Prgm keys:
<nowiki>RawKeyHook:
.db 83h ; Required for all hooks
cp kAppsMenu ; was Apps pressed?
jr z,AppsKey
cp kPrgm ; was Prgm pressed?
ret nz
ld a,kAppsMenu ; change key to kAppsMenu
or a ; set NZ condition
ret
AppsKey:
ld a,kPrgm ; change key to kPrgm
or a ; set NZ condition
ret</nowiki>

== Credits and Contributions ==
* Texas Instruments

83Plus:Hooks:9B80

2005-03-28T16:51:12Z

130.215.232.102: categorized

[[Category:83Plus:Hooks:By_Name|Library Hook]]
[[Category:83Plus:Hooks:By_Address|9B80 - Library Hook]]
== Synopsis ==
'''Name:''' Library Hook

'''Hook Pointer Block Address:''' [[83Plus:RAM:9B80|9B80]]

'''Hook Enable BCALL:''' [[83Plus:BCALLs:4F63|4F63]]

'''Hook Disable BCALL:''' [[83Plus:BCALLs:4F6C|4F6C]]

'''Hook Call BCALL:''' [[83Plus:BCALLs:94F5A|4F5A]]

'''Hook Active Flag:''' [[83Plus:Flags:34#Bit_1|1, (iy + 34h)]]

This hook is available for apps' internal use and to interface with BASIC programs using the OpenLib and ExecLib functions.

== Using the Hook ==

This hook is never used by the 83+ OS. On the 84+, it is used to implement the OpenLib( / ExecLib functions.

== Comments ==

If you place the following at 4087:

<nowiki> .db 96h, 0E2h
.dw 100h, LibHookInfo</nowiki>

and the following anywhere on the first page of your app:

<nowiki>LibHookInfo:
.dw 1
.db 2, 0
.dw LibraryHook</nowiki>

a BASIC program (on the 84+) can then call your hook.

* First, the BASIC program calls the OpenLib( function with the name of your app as argument.
* Your app's hook is enabled and bit [[83Plus:Flags:3E#Bit_4|4, (iy+3Eh)]] is set to indicate that ExecLib is enabled.
* When the BASIC program calls ExecLib, your app's hook is called.

Note that OpenLib and ExecLib are only valid in programs, and not in the homescreen entry or in equations.

== Credits and Contributions ==
* '''Michael Vincent:''' Analyzing the OpenLib/ExecLib interface on OS 2.21 and above.

WikiTI - User contributions [en]

83Plus:Hooks:9B84

83Plus:Hooks:9B80