83Plus:Hooks:9BB8 - Revision history

AndyJ: /* Using the Hook */ your -> you're

2007-08-14T20:00:42Z

‎Using the Hook: your -> you're

JasonM: Replaced with my (more detailed) docs. Don't worry...your docs were fine....

2005-04-02T02:34:43Z

Replaced with my (more detailed) docs. Don't worry...your docs were fine....

FloppusMaximus at 05:14, 30 March 2005

2005-03-30T05:14:23Z

FloppusMaximus: categorized

2005-03-28T17:00:44Z

categorized

FloppusMaximus at 08:11, 28 March 2005

2005-03-28T08:11:01Z

FloppusMaximus at 08:05, 28 March 2005

2005-03-28T08:05:53Z

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 18: / Line 18: @@
 A tells us where in the OS the key was pressed, and B contains the keycode. You can't cancel the keypress through the flags you return (or at least in some situations), but I think returning with B being zero should be safe.
-* '''A = 00h:''' The key was pressed in the catalog. '''Note:''' The catalog enables Alpha lock by default, so if your looking for up / down, you might also need to check for kalphaup / kalphadown.
+* '''A = 00h:''' The key was pressed in the catalog. '''Note:''' The catalog enables Alpha lock by default, so if you're looking for up / down, you might also need to check for kalphaup / kalphadown.
 * '''A = 01h:''' The key in B was pressed when a menu is visible. For some odd reason, this event isn't fired if the key will simply display another menu; for example, if you're viewing the MATH menu, and you press the VARS key, you're not notified of that keypress at all. C contains the number of menu choices visible; this value cannot be higher than 7.
 * '''A = 02h:''' This event is fired in response to several events (listed below) related to the link menu. '''Note:''' The Var Send / Recieve menus pass events with A = 1 (they act as normal menu, despite the fact it's a context). So if you press down to go to All-, that's passed with A = 1.

@@ Line 1: / Line 1: @@
 [[Category:83Plus:Hooks:By_Name|Help Hook]] [[Category:83Plus:Hooks:By_Address|9BB8 - Help Hook]]
 == Synopsis ==
-'''Name:''' Help Hook
+'''Name:''' Help Hook ''(has been incorrectly called the Mode hook)''
 '''Hook Pointer Block Address:''' [[83Plus:RAM:9BB8|9BB8]]
@@ Line 9: / Line 9: @@
 '''Hook Disable BCALL:''' [[83Plus:BCALLs:504D|504D]]
-'''Hook Call BCALL:''' ''(none known)''
+'''Hook Call BCALL:''' ''(Unknown)''
 '''Hook Active Flag:''' [[83Plus:Flags:36#Bit_4|4, (iy + 36h)]]
-This hook is called when a key is pressed at the Mode screen or in a system menu, as well as at Mode screen startup.
+This hook is primarily a Raw Key hook that is triggered in only some parts of the operating system. There seems to be no pattern or logic behind what is and isn't passed to this hook; if you find any pattern, please describe it to us!
 == Using the Hook ==
-These different values, passed in A, determine what the hook should do.
+A tells us where in the OS the key was pressed, and B contains the keycode. You can't cancel the keypress through the flags you return (or at least in some situations), but I think returning with B being zero should be safe.
-* 1: A key was pressed in a menu
-** B = keycode
+* '''A = 00h:''' The key was pressed in the catalog. '''Note:''' The catalog enables Alpha lock by default, so if your looking for up / down, you might also need to check for kalphaup / kalphadown.
-* 3: At the mode screen
+* '''A = 01h:''' The key in B was pressed when a menu is visible. For some odd reason, this event isn't fired if the key will simply display another menu; for example, if you're viewing the MATH menu, and you press the VARS key, you're not notified of that keypress at all. C contains the number of menu choices visible; this value cannot be higher than 7.
-** B = kMode at startup
+* '''A = 02h:''' This event is fired in response to several events (listed below) related to the link menu. '''Note:''' The Var Send / Recieve menus pass events with A = 1 (they act as normal menu, despite the fact it's a context). So if you press down to go to All-, that's passed with A = 1.
-** B = kApp when the Mode key is pressed
+** It's fired after the user presses 2nd+Link, and the menu is drawn. B = 41h (klinkio, cxlinkio)
-** B = keycode for other keys
+** It's fired after the user has pressed enter to go to the variable selection menu (note: the enter is passed with A = 1) but before it's actually displayed. B represents what was selected:
 == Comments ==
 This hook has been referred to as the Mode hook, but the only app to use it (Catalog Help) has nothing to do with the Mode screen.

@@ Line 1: / Line 1: @@
-[[Category:83Plus:Hooks:By_Name|Help Hook]]
+[[Category:83Plus:Hooks:By_Name|Help Hook]] [[Category:83Plus:Hooks:By_Address|9BB8 - Help Hook]]
 [[Category:83Plus:Hooks:By_Address|9BB8 - Help Hook]]
 == Synopsis ==
 '''Name:''' Help Hook

← Older revision		Revision as of 17:00, 28 March 2005
Line 1:		Line 1:
		+	[[Category:83Plus:Hooks:By_Name\|Help Hook]]
		+	[[Category:83Plus:Hooks:By_Address\|9BB8 - Help Hook]]
	== Synopsis ==		== Synopsis ==
	'''Name:''' Help Hook		'''Name:''' Help Hook