Difference between revisions of "83Plus:Hooks:9B88"

From WikiTI
Jump to: navigation, search
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
[[Category:83Plus:Hooks:By_Name|GetCSC Hook]] [[Category:83Plus:Hooks:By_Address|9B88 - GetCSC Hook]]
 
== Synopsis ==
 
== Synopsis ==
'''Name:''' GetCSC ''(officially GetKey; this name is discouraged)''
+
'''Name:''' GetCSC ''(officially GetKey; there is some disagreement as to the appropriateness of both names)''
  
 
'''Hook Pointer Block Address:''' [[83Plus:RAM:9B88|9B88]]
 
'''Hook Pointer Block Address:''' [[83Plus:RAM:9B88|9B88]]
Line 12: Line 13:
 
'''Hook Active Flag:''' [[83Plus:Flags:34#Bit_0|0, (iy + 34h)]]
 
'''Hook Active Flag:''' [[83Plus:Flags:34#Bit_0|0, (iy + 34h)]]
  
This hook is called when the OS scans for keypad activity.  It is called once before the key scan begins, and a second time if the scan finds a key pressed.  It thus operates at a lower level than the [[83Plus:Hooks:9B84|Raw Key hook]], which operates on GetKey values.
+
This hook is called when the OS scans for keypad activity. (Note, however, that it is only called when the OS is idle in the [[83Plus:BCALLs:4972|GetKey]] routine.) It is called once before the key scan begins, and a second time after the keypad has been scanned.  It thus operates at a lower level than the [[83Plus:Hooks:9B84|Raw Key hook]], which operates on actual GetKey values.
  
 
== Using the Hook ==
 
== Using the Hook ==
Line 18: Line 19:
  
 
* 1Ah: Before the keypad is scanned
 
* 1Ah: Before the keypad is scanned
** Return with Z set and A = scancode to force a key to be "pressed."
+
** Return with Z set and A = '''keycode''' to force a key to be "pressed."
 
** Return with NZ set and A = 1Ah to scan the keypad normally.
 
** Return with NZ set and A = 1Ah to scan the keypad normally.
* 1Bh: After the keypad is scanned and a key is found
+
* 1Bh: After the keypad is scanned
** B = scancode found
+
** B = scancode found (or 0 if no key pressed)
** Return with NZ set and A = scancode to be returned.
+
** Return with NZ set and A = '''scancode''' to be returned.
  
 
== Comments ==
 
== Comments ==
Officially named the "GetKeyHook.This name is deprecated and confusing.
+
Officially named the "GetKeyHook" by ti83plus.inc. Although it has been pointed out that it is only called during GetKey, referring to it as the "GetKeyHook" is rather misleading, because it deals only with raw scan codes ("GetCSC values") as opposed to the full keypresses returned by GetKey (which depend, for example, on whether 2nd or Alpha are active.)
  
 
== Example ==
 
== Example ==

Latest revision as of 10:55, 29 July 2011

Synopsis

Name: GetCSC (officially GetKey; there is some disagreement as to the appropriateness of both names)

Hook Pointer Block Address: 9B88

Hook Enable BCALL: 4F7B

Hook Disable BCALL: 4F7E

Hook Call BCALL: 4F78

Hook Active Flag: 0, (iy + 34h)

This hook is called when the OS scans for keypad activity. (Note, however, that it is only called when the OS is idle in the GetKey routine.) It is called once before the key scan begins, and a second time after the keypad has been scanned. It thus operates at a lower level than the Raw Key hook, which operates on actual GetKey values.

Using the Hook

These different values, passed in A, determine what the hook should do.

  • 1Ah: Before the keypad is scanned
    • Return with Z set and A = keycode to force a key to be "pressed."
    • Return with NZ set and A = 1Ah to scan the keypad normally.
  • 1Bh: After the keypad is scanned
    • B = scancode found (or 0 if no key pressed)
    • Return with NZ set and A = scancode to be returned.

Comments

Officially named the "GetKeyHook" by ti83plus.inc. Although it has been pointed out that it is only called during GetKey, referring to it as the "GetKeyHook" is rather misleading, because it deals only with raw scan codes ("GetCSC values") as opposed to the full keypresses returned by GetKey (which depend, for example, on whether 2nd or Alpha are active.)

Example

The following code will swap the 2nd and Alpha keys:

GetKeyHook:
        .db 83h             ; Required for all hooks
        cp 1Bh              ; which condition?
        ret nz
        ld a,b              ; which key was pressed?
        cp skAlpha          ; was it Alpha?
        jr z,AlphaKey
        cp sk2nd            ; was it 2nd?
        ret nz
        ld a,skAlpha-1      ; change to Alpha
        inc a               ; set NZ
        ret
AlphaKey:
        ld a,sk2nd-1        ; change to 2nd
        inc a               ; set NZ
        ret

Credits and Contributions

  • Texas Instruments (thanks for all the confusing equates)