83Plus:Hooks:9BA0 - Revision history

RobbieMc at 05:30, 19 August 2006

2006-08-19T05:30:22Z

RobbieMc at 14:52, 17 August 2006

2006-08-17T14:52:14Z

Mmartin: /* Using the Hook */ more info about event 08h

2006-06-01T14:19:08Z

‎Using the Hook: more info about event 08h

Mmartin: Some extra info when not in func mode

2006-05-29T15:03:39Z

Some extra info when not in func mode

FloppusMaximus: /* Synopsis */ linkage+call

2005-04-17T03:05:17Z

‎Synopsis: linkage+call

JasonM at 02:40, 17 April 2005

2005-04-17T02:40:10Z

New page

[[Category:83Plus:Hooks:By Address|9BA0 - Regraph Hook]]
[[Category:83Plus:Hooks:By Name|Regraph Hook]]
== Synopsis ==
'''Name:''' Regraph Hook

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

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

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

'''Hook Call BCALL:''' ''(Unknown)''

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

This hook allows one to intercept various events that occur during a regraph, and optionally cancel them. Be aware that this hook is called if a function is being drawn on top of a currently existing graph ("smart graph.")

'''Note:''' This was only extensively researched in function mode.

== Using the Hook ==
In most cases, returning with zero set will allow something to occur, and returning with zero reset will cancel something. Like some hooks, this hook is rather messy.

These events are listed in the order below to match the order they are actually called in.

* '''A = 00h:''' Graphing has started, otherwise nothing has occured. Returning with zero reset will cancel the entire graphing procedure.
* '''A = 01h:''' Graph about to be erased if required, otherwise presented (from plotSScreen) Returning with zero set will cancel the entire graphing process.
* '''A = 02h:''' About to draw axes and grid. Returning with zero reset will cancel this drawing only.
* '''A = 09h:''' Stat plots drawn. About to draw equations. Returning with zero reset will cancel drawing of all equations (or at least the ones being drawn in this graph.)
* '''A = 03h:''' About to evaluate a point. OP1 contains the value of the independant variable. E contains the equation number only if this is the first time this message is sent for this function, otherwise may hold C9h. Return value ignored. Message skipped in Simultaneous mode.
* '''A = 08h:''' About to evaluate a point---this is somewhat a duplicate of event 03h. OP1 contains equation name. Called more than once in the case of Parametric graphs (or quite a few times). Value of E here the same as value of E during the message A = 3, or if in Simultaneous mode then the number of the equation. During the first call per equation (when not in Simultaneous mode), OP4 may contain the name of the independant variable. Return value here affects inputs to the event below.
* '''A = 04h:''' Function evaluated. OP1 is the X coordinate after evaluation. OP2 is the Y coordinate after evaluation, assuming that zero was set as a return value when A = 08h, otherwise contains function name. Canceling this event will cancel drawing of that point, as well as any line connecting to it. This event is skipped if an error occured in parsing.
* '''A = 05h:''' A = 5 - Called after A = 4 regardless of return value or if A = 4 wasn't called due to parse error. Skipped in Simultaneous mode.
* '''A = 06h:''' B contains pixel x-coordinate of the next point to be drawn. Can be modified if desired (but not sure on exact behavior.) Skipped in Simultaneous mode.
* '''A = 07h:''' About to draw axes labels, and done drawing equations. Return values ingored.

== Comments ==
The events 03h, 08h, 04h, 05h, and 06h are called in that order for each point to be evaluated.

As mentioned, this hook's behavior is rather erratic and messy; the best way to learn it is to just mess with it.

@@ Line 30: / Line 30: @@
 * '''A = 08h:''' About to evaluate a point---this is somewhat a duplicate of event 03h. OP1 contains equation name. Called twice in the case of Parametric graphs (one time for X and one time for Y). Value of E here the same as value of E during the message A = 3, or if in Simultaneous mode then the number of the equation. During the first call per equation (when not in Simultaneous mode), OP4 may contain the name of the independant variable. This event can also be called when the next location of the trace cursor has to be calculated. Returning with zero reset will make the os try to use the value in OP1 as result. Returning with zero set will make the os try to execute the equation, resulting in event 04h.  (Changing the name of the equation in OP1 has no effect.)
 * '''A = 04h:''' Function evaluated. OP1 is the X coordinate after evaluation. OP2 is the Y coordinate after evaluation, assuming that zero was set as a return value when A = 08h, otherwise contains function name. Canceling this event will cancel drawing of that point, as well as any line connecting to it. This event is skipped if an error occured in parsing.
-* '''A = 05h:''' A = 5 - Called after A = 4 regardless of return value or if A = 4 wasn't called due to parse error. Skipped in Simultaneous mode.
+* '''A = 05h:''' Called after A = 4 regardless of return value or if A = 4 wasn't called due to parse error. Skipped in Simultaneous mode.
 * '''A = 06h:''' B contains pixel x-coordinate of the next point to be drawn. Can be modified if desired (but not sure on exact behavior.) Skipped in Simultaneous mode.
 * '''A = 07h:''' About to draw axes labels, and done drawing equations. Return values ingored.

@@ Line 24: / Line 24: @@
 * '''A = 00h:''' Graphing has started, otherwise nothing has occured. Returning with zero reset will cancel the entire graphing procedure.
-* '''A = 01h:''' Graph about to be erased if required, otherwise presented (from plotSScreen) Returning with zero set will cancel the entire graphing process.
+* '''A = 01h:''' Graph about to be erased if required, otherwise presented (from plotSScreen) Returning with zero reset will cancel the entire graphing process.
 * '''A = 02h:''' About to draw axes and grid. Returning with zero reset will cancel this drawing only.
 * '''A = 09h:''' Stat plots drawn. About to draw equations. Returning with zero reset will cancel drawing of all equations (or at least the ones being drawn in this graph.)

@@ Line 28: / Line 28: @@
 * '''A = 09h:''' Stat plots drawn. About to draw equations. Returning with zero reset will cancel drawing of all equations (or at least the ones being drawn in this graph.)
 * '''A = 03h:''' About to evaluate a point. OP1 contains the value of the independant variable. E contains the equation number only if this is the first time this message is sent for this function, otherwise may hold C9h. Return value ignored. Message skipped in Simultaneous mode.
-* '''A = 08h:''' About to evaluate a point---this is somewhat a duplicate of event 03h. OP1 contains equation name. Called more than once in the case of Parametric graphs (or quite a few times). Value of E here the same as value of E during the message A = 3, or if in Simultaneous mode then the number of the equation. During the first call per equation (when not in Simultaneous mode), OP4 may contain the name of the independant variable. Return value here affects inputs to the event below.
+* '''A = 08h:''' About to evaluate a point---this is somewhat a duplicate of event 03h. OP1 contains equation name. Called more than once in the case of Parametric graphs (or quite a few times). Value of E here the same as value of E during the message A = 3, or if in Simultaneous mode then the number of the equation. During the first call per equation (when not in Simultaneous mode), OP4 may contain the name of the independant variable. Return value here affects inputs to the event below. This event can also be called when the next location of the trace cursor has to be calculated.
 * '''A = 04h:''' Function evaluated. OP1 is the X coordinate after evaluation. OP2 is the Y coordinate after evaluation, assuming that zero was set as a return value when A = 08h, otherwise contains function name. Canceling this event will cancel drawing of that point, as well as any line connecting to it. This event is skipped if an error occured in parsing.
 * '''A = 05h:''' A = 5 - Called after A = 4 regardless of return value or if A = 4 wasn't called due to parse error. Skipped in Simultaneous mode.
@@ Line 35: / Line 35: @@
 == Comments ==
-The events 03h, 08h, 04h, 05h, and 06h are called in that order for each point to be evaluated.
+Below is a table of the order of events that are called for each point to be evaluated. In parametric mode the event 08h is called twice because it has to evaluate both X and Y (in that order).
 As mentioned, this hook's behavior is rather erratic and messy; the best way to learn it is to just mess with it.

@@ Line 10: / Line 10: @@
 '''Hook Disable BCALL:''' [[83Plus:BCALLs:4FED|4FED]]
-'''Hook Call BCALL:''' ''(Unknown)''
+'''Hook Call BCALL:''' [[83Plus:BCALLs:4FF0|4FF0]]
-'''Hook Active Flag:''' 6, (iy + 35h)
+'''Hook Active Flag:''' [[83Plus:Flags:35#Bit_6|6, (iy + 35h)]]
 This hook allows one to intercept various events that occur during a regraph, and optionally cancel them. Be aware that this hook is called if a function is being drawn on top of a currently existing graph ("smart graph.")