83Plus:Hooks:9B88 - Revision history

Thepenguin77 at 17:55, 29 July 2011

2011-07-29T17:55:51Z

Thepenguin77 at 03:17, 4 December 2009

2009-12-04T03:17:37Z

RobbieMc: /* Synopsis */

2006-01-22T05:26:08Z

‎Synopsis

RobbieMc: /* Using the Hook */

2006-01-22T05:15:05Z

‎Using the Hook

FloppusMaximus at 05:12, 30 March 2005

2005-03-30T05:12:41Z

FloppusMaximus: categorized

2005-03-28T16:55:59Z

categorized

FloppusMaximus: /* Comments */

2005-03-28T09:16:53Z

‎Comments

FloppusMaximus: /* Synopsis */

2005-03-28T09:13:33Z

‎Synopsis

FloppusMaximus at 05:45, 28 March 2005

2005-03-28T05:45:58Z

FloppusMaximus at 05:37, 28 March 2005

2005-03-28T05:37:50Z

New page

'''Note:''' Do not take the information on this template page as actual documentation!

The Hooks are named by their hook pointer block address (the four bytes consisting of page, address, and an extra byte), in hexadecimal. An example is [[83Plus:Hooks:9B84]].

----

== Synopsis ==
'''Name:''' ImAHook

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

'''Hook Enable BCALL:''' [[83Plus:BCALLs:1234|1234]]

'''Hook Disable BCALL:''' [[83Plus:BCALLs:5678|5678]]

'''Hook Call BCALL:''' [[83Plus:BCALLs:9012|9012]]

'''Hook Active Flag:''' 6, (iy + 23h)

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

== Using the Hook ==
These different values, passed in a, determines what the hook should do.
* 1: The calculator just turned on. There seem to be no other values passed to the hook.
* 2: The calculator is computing 1+1.
** b: 1
** c: 1
** Change b and/or c to affect the output of the problem (which will still look like 1+1 to the user).
* 3: Preparing to turn off due to 2nd+OFF.
** Zero flag: Clear to abort the power off.

== Comments ==
This hook doesn't exist. This is a demonstration only.

== Credits and Contributions ==
* '''/dev/hda1:''' My favorite hard drive partition.

@@ Line 19: / Line 19: @@
 * 1Ah: Before the keypad is scanned
-** Return with Z set and A = keycode 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.
 * 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.
+** 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 ==

@@ Line 27: / Line 27: @@
 == 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 ==

@@ Line 13: / Line 13: @@
 '''Hook Active Flag:''' [[83Plus:Flags:34#Bit_0|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 [[83Plus:BCALLs:4972|GetKey]] routine.)  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 actual 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 ==

@@ Line 19: / Line 19: @@
 * 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.
-* 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.

@@ Line 1: / Line 1: @@
-[[Category:83Plus:Hooks:By_Name|GetCSC Hook]]
+[[Category:83Plus:Hooks:By_Name|GetCSC Hook]] [[Category:83Plus:Hooks:By_Address|9B88 - GetCSC Hook]]
 [[Category:83Plus:Hooks:By_Address|9B88 - GetCSC Hook]]
 == Synopsis ==
 '''Name:''' GetCSC ''(officially GetKey; there is some disagreement as to the appropriateness of both names)''

← Older revision		Revision as of 16:55, 28 March 2005
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; there is some disagreement as to the appropriateness of both names)''		'''Name:''' GetCSC ''(officially GetKey; there is some disagreement as to the appropriateness of both names)''

@@ Line 1: / Line 1: @@
 == Synopsis ==
-'''Name:''' ImAHook
+'''Name:''' GetCSC ''(officially GetKey; this name is discouraged)''
-'''Hook Pointer Block Address:''' [[83Plus:RAM:8562|8562]]
+'''Hook Pointer Block Address:''' [[83Plus:RAM:9B88|9B88]]
-'''Hook Enable BCALL:''' [[83Plus:BCALLs:1234|1234]]
+'''Hook Enable BCALL:''' [[83Plus:BCALLs:4F7B|4F7B]]
-'''Hook Disable BCALL:''' [[83Plus:BCALLs:5678|5678]]
+'''Hook Disable BCALL:''' [[83Plus:BCALLs:4F7E|4F7E]]
-'''Hook Call BCALL:''' [[83Plus:BCALLs:9012|9012]]
+'''Hook Call BCALL:''' [[83Plus:BCALLs:4F78|4F78]]
-'''Hook Active Flag:''' 6, (iy + 23h)
+'''Hook Active Flag:''' [[83Plus:Flags:34#Bit_0|0, (iy + 34h)]]
-This hook allows you to change the values that [[83Plus:BCALLs:4972|GetKey]] returns.
+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.
 == Using the Hook ==
-These different values, passed in a, determines what the hook should do.
+These different values, passed in A, determine what the hook should do.
-* 1: The calculator just turned on. There seem to be no other values passed to the hook.
-* 2: The calculator is computing 1+1.
+* 1Ah: Before the keypad is scanned
-** b: 1
+** Return with Z set and A = scancode to force a key to be "pressed."
-** c: 1
+** Return with NZ set and A = 1Ah to scan the keypad normally.
-** Change b and/or c to affect the output of the problem (which will still look like 1+1 to the user).
+* 1Bh: After the keypad is scanned and a key is found
-* 3: Preparing to turn off due to 2nd+OFF.
+** B = scancode found
-** Zero flag: Clear to abort the power off.
+** Return with NZ set and A = scancode to be returned.
 == Comments ==
-This hook doesn't exist. This is a demonstration only.
+Officially named the "GetKeyHook."  This name is deprecated and confusing.
 == Credits and Contributions ==
-* '''/dev/hda1:''' My favorite hard drive partition.
+* '''Texas Instruments''' (thanks for all the confusing equates)