83Plus:Hooks:9BA4 - Revision history

Mmartin: Added a space between two words

2005-04-02T12:28:12Z

Added a space between two words

FloppusMaximus at 03:26, 2 April 2005

2005-04-02T03:26:51Z

FloppusMaximus: /* Synopsis */ flag linkage

2005-04-02T03:05:43Z

‎Synopsis: flag linkage

JasonM at 02:52, 2 April 2005

2005-04-02T02:52:49Z

New page

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

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

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

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

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

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

The graphics hook allows one to intercept calls to IPoint, ILine, and various drawing functions for the graph. You can change behavior, and if you want to, disable drawing altogether.

== Using the Hook ==
The accumulator contains what graphics B_CALL was called.

* '''A = 00h:''' Called in response to the B_CALL [[83Plus:BCALLs:47E0|IPoint]]. B, C, and D are the same inputs as the B_CALL. You can mess with them to change action, position, although there's a caveat, as the IPoint is not expected to change registers (which could have disasterous effects!)
** It would appear that [[83Plus:BCALLs:47E0|ILine]] (which calls IPoint, which is evident from this hook), is aware of this behavior. Changing D, for example (which specifies the action of IPoint), will result in the new style being applied to the rest of the pixels (unless you change this again with subsequent calls to the hook.)
** Returning with the zero flag reset will cancel the operation.
* ''' A = 01h:''' Called in response to [[83Plus:BCALLs:47E0|IPoint]]. B through H same as inputs to B_CALL. As before, returning w/ the zero flag reset will cancel the drawing. I would assume save caveat as above. You can figure out some of the things that are being passed:
** Horizontal (HorizCmd): OP1 = Y Coordinate
** Vertical (VertCmd): OP1 = X Coordinate
** Line (LineCmd / UnLineCmd): FPST = Y2, FPS1 = X2, FPS2 = Y1, FPS3 = X1
** Circle (CircCmd?): FPSB1 = X, FPSB2 = Y, FPSB3 = Radius

I'm using the notation FPSBn asthe entry from the bottom of the floating point stack stack, starting at 1. (there's no notation I've seen for this such of a thing before) You'll have to read these values with your own code (there aren't any predefined B_CALLs), but that's trivial.

== Comments ==
This hook is useless.

== Credits and Contributions ==
* '''Dan Englender:''' He gave me extensive documentation in #tcpa. To quote him:
<Dan_E> Just that 0 = IPoint, 1 = ILine, and 2 = CLine

@@ Line 27: / Line 27: @@
 ** Circle (CircCmd?): FPSB1 = X, FPSB2 = Y, FPSB3 = Radius
-I'm using the notation FPSBn asthe entry from the bottom of the floating point stack stack, starting at 1. (there's no notation I've seen for this such of a thing before) You'll have to read these values with your own code (there aren't any predefined B_CALLs), but that's trivial.
+I'm using the notation FPSBn as the entry from the bottom of the floating point stack stack, starting at 1. (there's no notation I've seen for this such of a thing before) You'll have to read these values with your own code (there aren't any predefined B_CALLs), but that's trivial.
 == Comments ==

@@ Line 1: / Line 1: @@
-[[Category:83Plus:Hooks:By Address|9BA4 - Graphics Hook]]
+[[Category:83Plus:Hooks:By Address|9BA4 - Graphics Hook]] [[Category:83Plus:Hooks:By Name|Graphics Hook]]
 [[Category:83Plus:Hooks:By Name|Graphics Hook]]
 == Synopsis ==
 '''Name:''' Graphics Hook

@@ Line 12: / Line 12: @@
 '''Hook Call BCALL:''' ''(Unknown)''
-'''Hook Active Flag:''' 7, (iy + 35h)
+'''Hook Active Flag:''' [[83Plus:Flags:35#Bit_7|7, (iy + 35h)]]
 The graphics hook allows one to intercept calls to IPoint, ILine, and various drawing functions for the graph. You can change behavior, and if you want to, disable drawing altogether.