WikiTI - User contributions [en]

3D engines

2007-10-11T19:59:15Z

Mmartin: Source code IS available

== Matthew Roberts' ==
by Matthew Roberts

Info

[http://www.ticalc.org/archives/files/fileinfo/126/12690.html GlassCars]
[http://www.ticalc.org/archives/files/fileinfo/166/16646.html Coaster]

Source code not available.

== Juha3D ==
by Jean Carot

Source code available at http://tift.tuxfamily.org/projects/juha3d
Public domain.

== qarnos' ==

[http://kvince83.tengun.net/maxboard/viewtopic.php?t=1350&start=0]

Source code available

== Nostromo 3D Engine ==

by benryves

[http://kvince83.tengun.net/maxboard/viewforum.php?f=30]

== Mach3D ==
by Kevin Harness

Used in [http://www.ticalc.org/archives/files/fileinfo/272/27287.html Maze 3D]

Source code available

{{stub}}

83Plus:Software:Diffequ

2007-02-15T15:49:05Z

Mmartin: Release information

Diffequ is a differential equation grapher for the TI-83/84 Plus developed by Martin Warmer, originally through the [http://code.google.com/soc/ 2006 Google Summer of Code].

Source code is available at the [http://sf.net/projects/graph3 sourceforge project] via its [https://svn.sourceforge.net/svnroot/graph3/diffequ/trunk/ SVN repository]. The first official release of diffequ was integrated in [http://graph3.sf.net graph3 2.0] and can be downloaded at [http://www.ticalc.org/archives/files/fileinfo/247/24741.html ticalc].

http://wikiti.denglend.net/stuff/diffeq.gif

[[Category:83Plus:Software|Diffequ]]

83Plus:BCALLs:42A3

2006-12-26T19:20:23Z

Mmartin: Added tVarPict as 2byte token

[[Category:83Plus:BCALLs:By Name:Utility|IsA2ByteTok]] [[Category:83Plus:BCALLs:By Name|IsA2ByteTok]] [[Category:83Plus:BCALLs:By Address|42A3 - IsA2ByteOk]]
== Synopsis ==
'''Official Name:''' IsA2ByteTok

'''BCALL Address:''' 42A3

Determines if the token in register A is a two-byte token.

=== Inputs ===
* A: First byte of potential two-byte token

=== Outputs ===
* Z: set if A is the first byte of a two-byte token.

=== Registers Destroyed ===
''None''

== Comments ==
The current two-byte token identifiers are t2ByteTok, tVarStrng, tGFormat, tVarSys, tVarOut, tVarGBD, tVarEqu, tVarLst, tVarPict, and tVarMat, and on the TI84s, $EF.

TI has updated the OS for the TI84s to return true for $EF, the identifer for the [[83Plus:Basic:New_Tokens_on_the_84_Plus|TI84s new tokens]]. It would be nice if someone would run [http://cablespeed.com/~tehblueblur/ti83p/CHECKEF2.8XP this program] to check to see how OS 1.19 reacts to $EF. ([http://cablespeed.com/~tehblueblur/ti83p/checkEF2.z80 Source] (jr z, w00itztru1111 should be w00tiztru1111))

83Plus:BCALLs:42A3

2006-12-26T19:15:11Z

Mmartin: corrected spelling error

[[Category:83Plus:BCALLs:By Name:Utility|IsA2ByteTok]] [[Category:83Plus:BCALLs:By Name|IsA2ByteTok]] [[Category:83Plus:BCALLs:By Address|42A3 - IsA2ByteOk]]
== Synopsis ==
'''Official Name:''' IsA2ByteTok

'''BCALL Address:''' 42A3

Determines if the token in register A is a two-byte token.

=== Inputs ===
* A: First byte of potential two-byte token

=== Outputs ===
* Z: set if A is the first byte of a two-byte token.

=== Registers Destroyed ===
''None''

== Comments ==
The current two-byte token identifiers are t2ByteTok, tVarStrng, tGFormat, tVarSys, tVarOut, tVarGBD, tVarEqu, tVarLst, and tVarMat, and on the TI84s, $EF.

TI has updated the OS for the TI84s to return true for $EF, the identifer for the [[83Plus:Basic:New_Tokens_on_the_84_Plus|TI84s new tokens]]. It would be nice if someone would run [http://cablespeed.com/~tehblueblur/ti83p/CHECKEF2.8XP this program] to check to see how OS 1.19 reacts to $EF. ([http://cablespeed.com/~tehblueblur/ti83p/checkEF2.z80 Source] (jr z, w00itztru1111 should be w00tiztru1111))

83Plus:Software:Diffequ

2006-10-21T18:29:11Z

Mmartin: added link to a build of the code

Diffequ is a differential equation grapher for the TI-83/84 Plus developed by Martin Warmer, originally through the [http://code.google.com/soc/ 2006 Google Summer of Code].

Source code is available at the [http://graph3.sf.net sourceforge project] via its [https://svn.sourceforge.net/svnroot/graph3/diffequ/trunk/ SVN repository]. A build of the code at the end of the Summer of Code is available [http://graph3.sourceforge.net/diffequ_nightly_061021.8xk here]. To enable diffequ mode run the application once, to disable it run the application another time. '''Warning:''' this build is not tested very well and can crash your calculator!

http://wikiti.denglend.net/stuff/diffeq.gif

[[Category:83Plus:Software|Diffequ]]

83Plus:Software:Diffequ

2006-10-21T17:43:11Z

Mmartin: Changed repository location to sourceforge

83Plus:RAM:980C

2006-08-07T13:19:41Z

Mmartin:

[[Category:83Plus:RAM:By Address|980C - EQS]]
[[Category:83Plus:RAM:By Name|EQS]]
----

== Synopsis ==
'''Unofficial Name:''' EQS

'''Memory Address:''' 980Ch

'''Length:''' 12 bytes.

This area contains status information for the YEqu app.

== Comments ==
* 980Eh (offset 2) contains the current item in the list that will be plotted (starts at 1)
* 9812h (offset 6) This sets the maximum value for the equations. All equations of which the lower 4 bits are less than the maximum value are displayed. For example in function mode this value is 0Ah=10 to display the ten equations.
* 9813h (offset 7) This variable store the equations that is currently (in the process of) being displayed or edited by the yEqu app. (These are token values, thus X6T is 2Bh)

This value is mainly of use when used in conjunction with the [[83Plus:Hooks:9B98|YEqu hook]].

'''NB:'''This might also be used outside the YEqu app, this hasn't been researched. Nor have the bytes which are not mentioned here been researched.

83Plus:Hooks:9BB0

2006-07-21T13:51:33Z

Mmartin: /* Using the Hook */

[[Category:83Plus:Hooks:By_Name|App Change Hook]] [[Category:83Plus:Hooks:By_Address|9BB0 - App Change Hook]]
== Synopsis ==
'''Name:''' App Change Hook ''(also called the Context Switch hook)''

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

'''Hook Enable BCALL:''' [[83Plus:BCALLs:502C|502C]]

'''Hook Disable BCALL:''' [[83Plus:BCALLs:502F|502F]]

'''Hook Call BCALL:''' ''(none known)''

'''Hook Active Flag:''' [[83Plus:Flags:36#Bit_2|2, (iy + 36h)]]

This hook is called at any time that TIOS changes from one app to another. Also called when the calculator is turned off.

== Using the Hook ==

* B = current app
** Switching from one app to another: A = new app
** Turning the calculator off from most apps: A = 2
** Exiting an external app: A = 0
** Turning the calculator off from the graph screen (possibly others): A = 0
* HL = Address the OS is going to jump to in order to switch to new app (this is a page 0 call)

== Comments ==
TIOS completely ignores the output of this hook. You can force TIOS to go certain apps by using the JForce... B_JUMPs. (These B_JUMPs are probably not intended to be used inside this hook, so this may or may not be safe, depending on the apps involved.)

83Plus:Hooks:9B98

2006-07-21T12:50:53Z

Mmartin: /* Comments */ Changed to EQS instead of CurrentEqu

[[Category:83Plus:Hooks:By_Name|Y= Hook]] [[Category:83Plus:Hooks:By_Address|9B98 - Y= Hook]]
== Synopsis ==
'''Name:''' Y Equ Hook

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

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

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

'''Hook Call BCALL:''' ''(none known)''

'''Hook Active Flag:''' [[83Plus:Flags:35#Bit_4|4, (iy + 35h)]]

This hook allows you to change the way the Y Equ app functions.

== Using the Hook ==
These different values, passed in a, determines what the hook should do.
* 0: The calculator is switching to the Y= app.
* 1: The cursor is moving left to the graph style icon. This isn't called when moving up and down through these icons.
* 2: Preparing to draw the graph style icon in front of y1..y0. If you want your own icon there, just use PutC and abort the drawing of the sign by the OS.
** Zero flag: Clear to abort the drawing of the icon.
* 3: Preparing to draw plot1..3
** Zero flag: Clear to abort the drawing of the plot1..3 texts.
* 4: Preparing to switch to the plot1..3 line.
** Zero flag: Clear to abort the action of switching to the plot1..3 line.
* 5: Preparing to en/disable the function (inverting the = sign)
** c: Contains the appropriate that will be executed. It can be changed to do the opposite action.
*** c=0 Preparing to disable the function
*** c=1 Preparing to enable the function
** Zero flag: Clear to abort the change
* 6: A key has been pressed
** b: Contains the GetKey equivalent of the key being pressed. This can be changed to simulate another keypress.
** Zero flag: Clear to ignore the keypress
* 7: This is called after a=5 when it's turning on of off the = sign.
** L: Contains the function being edited.
* 8: Preparing to draw the = sign. If you want your own sign there, just use PutC and abort the drawing of the sign by the OS.
** Zero flag: Clear to abort the drawing of the = sign.
* 9: Preparing to switch the cursor to another function

== Comments ==
The above information is based on research in func mode only.

The YEqu app updates the values at [[83Plus:RAM:980C|EQS]] whenever it's displaying or updating a function. This can be used to change the hook and YEqu behaviour.

83Plus:RAM:980C

2006-07-21T12:10:05Z

Mmartin:

[[Category:83Plus:RAM:By Address|980C - EQS]]
[[Category:83Plus:RAM:By Name|EQS]]
----

== Synopsis ==
'''Unofficial Name:''' EQS

'''Memory Address:''' 980Ch

'''Length:''' 12 bytes.

This area contains status information for the YEqu app.

== Comments ==
* 9812h (offset 6) This sets the maximum value for the equations. All equations of which the lower 4 bits are less than the maximum value are displayed. For example in function mode this value is 0Ah=10 to display the ten equations.
* 9813h (offset 7) This variable store the equations that is currently (in the process of) being displayed or edited by the yEqu app. (These are token values, thus X6T is 2Bh)

This value is mainly of use when used in conjunction with the [[83Plus:Hooks:9B98|YEqu hook]].

'''NB:'''This might also be used outside the YEqu app, this hasn't been researched. Nor have the bytes which are not mentioned here been researched.

83Plus:RAM:9813

2006-07-21T12:04:18Z

Mmartin: 83Plus:RAM:9813 moved to 83Plus:RAM:980C: Move to EQS equate

#redirect [[83Plus:RAM:980C]]

83Plus:RAM:980C

2006-07-21T12:04:17Z

Mmartin: 83Plus:RAM:9813 moved to 83Plus:RAM:980C

[[Category:83Plus:RAM:By Address|9813 - CurrentEqu]]
[[Category:83Plus:RAM:By Name|CurrentEqu]]
----

== Synopsis ==
'''Unofficial Name:''' CurrentEqu

'''Memory Address:''' 9813h

'''Length:''' 1 byte.

This variable store the equations that is currently (in the process of) being displayed or edited by the yEqu app.

== Comments ==
This value is mainly of use when used in conjunction with the [[83Plus:Hooks:9B98|YEqu hook]].

83Plus:RAM:980C

2006-07-21T09:34:09Z

Mmartin:

83Plus:Hooks:9B98

2006-07-21T09:31:33Z

Mmartin: /* Comments */

[[Category:83Plus:Hooks:By_Name|Y= Hook]] [[Category:83Plus:Hooks:By_Address|9B98 - Y= Hook]]
== Synopsis ==
'''Name:''' Y Equ Hook

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

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

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

'''Hook Call BCALL:''' ''(none known)''

'''Hook Active Flag:''' [[83Plus:Flags:35#Bit_4|4, (iy + 35h)]]

This hook allows you to change the way the Y Equ app functions.

== Using the Hook ==
These different values, passed in a, determines what the hook should do.
* 0: The calculator is switching to the Y= app.
* 1: The cursor is moving left to the graph style icon. This isn't called when moving up and down through these icons.
* 2: Preparing to draw the graph style icon in front of y1..y0. If you want your own icon there, just use PutC and abort the drawing of the sign by the OS.
** Zero flag: Clear to abort the drawing of the icon.
* 3: Preparing to draw plot1..3
** Zero flag: Clear to abort the drawing of the plot1..3 texts.
* 4: Preparing to switch to the plot1..3 line.
** Zero flag: Clear to abort the action of switching to the plot1..3 line.
* 5: Preparing to en/disable the function (inverting the = sign)
** c: Contains the appropriate that will be executed. It can be changed to do the opposite action.
*** c=0 Preparing to disable the function
*** c=1 Preparing to enable the function
** Zero flag: Clear to abort the change
* 6: A key has been pressed
** b: Contains the GetKey equivalent of the key being pressed. This can be changed to simulate another keypress.
** Zero flag: Clear to ignore the keypress
* 7: This is called after a=5 when it's turning on of off the = sign.
** L: Contains the function being edited.
* 8: Preparing to draw the = sign. If you want your own sign there, just use PutC and abort the drawing of the sign by the OS.
** Zero flag: Clear to abort the drawing of the = sign.
* 9: Preparing to switch the cursor to another function

== Comments ==
The above information is based on research in func mode only.

The YEqu app updates the value [[83Plus:RAM:9813|CurrentEqu]] whenever it's displaying or updating a function. This can be used to only do certain actions when a specific function is being handled.

Talk:Z80 Routines:Other:IonCompress

2006-07-20T12:08:53Z

Mmartin:

Just a small note of no importance to programming. Metaphysics hasn't got anything to do with physics, it's a branch of philosophy. It happens to be called metaphysics because the it is about the writings of Aristotle that come after (meta) his writings about physics. [[User:Mmartin|Mmartin]] 05:08, 20 July 2006 (PDT)

83Plus:BCALLs:4A8F

2006-07-20T12:00:14Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|DisplayEquSmall]]
[[Category:83Plus:BCALLs:By Name:Display|DisplayEquSmall]]
[[Category:83Plus:BCALLs:By Address|4A8F - DisplayEquSmall]]

----

== Synopsis ==
'''Unofficial Name:''' DisplayEquSmall

'''BCALL Address:''' 4A8F

Displays an equation in small font, in the same way as equations are shown during tracing.

=== Inputs ===
* BC: Length of the equation
* HL: Address of first token in equation
* bit 3, (iy + 11): Set to stop at middle of screen (can be used to display two equations)

=== Outputs ===
* The equation is displayed

=== Destroys ===
* AF,BC,DE,HL

83Plus:BCALLs:4A8F

2006-07-20T11:59:35Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|DisplayEquSmall]]
[[Category:83Plus:BCALLs:By Name:Utility|DisplayEquSmall]]
[[Category:83Plus:BCALLs:By Address|4A8F - DisplayEquSmall]]

----

== Synopsis ==
'''Unofficial Name:''' DisplayEquSmall

'''BCALL Address:''' 4A8F

Displays an equation in small font, in the same way as equations are shown during tracing.

=== Inputs ===
* BC: Length of the equation
* HL: Address of first token in equation
* bit 3, (iy + 11): Set to stop at middle of screen (can be used to display two equations)

=== Outputs ===
* The equation is displayed

=== Destroys ===
* AF,BC,DE,HL

83Plus:RAM:8D1B

2006-07-20T10:07:22Z

Mmartin:

[[Category:83Plus:RAM:By Address|8D1B - curGX2]]
[[Category:83Plus:RAM:By Name|curGX2]]

----

== Synopsis ==
'''Official Name:''' curGX2

'''Memory Address:''' 8D1Bh

'''Length:''' 1 byte.

This address contains the currently selected equation during graphing. 0 means that no equation is selected and the free moving cursor is used. Otherwise the number is the equation selected, thus 2 for Y2, 10 for Y0 and 5 for X5T/Y5T.

83Plus:Flags:18

2006-07-20T08:46:32Z

Mmartin:

[[Category:83Plus:Flags:By Address|18]]
[[Category:83Plus:Flags:By Name|-]]

----

== Synopsis ==
'''Flag Byte:''' 18h

'''Known Names:''' -

== Bit Overview ==

=== Bit 0 ===
'''Unofficial Name:''' grfExpr

This bit controls whether the expression is shown while tracing. Set to hide expression, reset to show expression.

=== Bit 1 ===
{{Unknown-flag}}

=== Bit 2 ===
{{Unknown-flag}}

=== Bit 3 ===
{{Unknown-flag}}

=== Bit 4 ===
{{Unknown-flag}}

=== Bit 5 ===
{{Unknown-flag}}

=== Bit 6 ===
{{Unknown-flag}}

=== Bit 7 ===
{{Unknown-flag}}

83Plus:RAM:9B7C

2006-07-12T06:46:46Z

Mmartin: removed the redirect to the B_CALL originally here

83Plus:Hooks:9B90

2006-07-11T18:58:59Z

Mmartin: Added some extra information

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

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

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

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

'''Hook Call BCALL:''' ''Unknown''

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

This hook is triggered when various events occur on the Window screen (where you adjust the Xmin, Xmax, etc. values). It is also called for the finance solver and TblSet interfaces.

This hook is based around a special table which is documented in the comments section below. It might help to read that section first. It should be noted that returning with zero set will let the normal flow of code happen.

== Using the Hook ==
Events are determined by the accumulator, as usual.
* '''A = 04h:''' The WINDOW title is about to be displayed. Returning with zero reset will cancel this drawing; you can draw your own title.
* '''A = 00h:''' The OS wants to know the value at IX. This is done because your table might be on another page than the os code that wants to read. Thus if you haven't changed the table(IX) or if you use your own table that is stored in ram, return with zero set. If you use your own table stored in flash, you have to return the value at IX in A and return with zero reset. You can use the following code to do that:
<nowiki>or 1 \ ld a, (ix+0) \ ret</nowiki>
* '''A = 01h:''' The same as above only the OS wants the value at IX+3. This would give the following code when using your own table in flash:
<nowiki>or 1 \ ld a, (ix + 3) \ ret</nowiki>
* '''A = 02h:''' The same as above only the OS wants the value at IX-3. This would give the following code when using your own table in flash:
<nowiki>or 1 \ ld a, (ix - 3) \ ret</nowiki>
* '''A = 03h:''' Draw the table item pointed by IX. curRow and curCol are already setup for outputting the prompt (the Xmin=-style thing.) After showing this prompt, B_CALL [[83Plus:BCALLs:452B|SetNumWindow]]. Then, output the number (see message 9 below.) and return with zero reset. If you don't use your own flash stored table, don't do any of the above and just return with zero set.
* '''A = 05h:''' We are about to edit an entry. HL is a pointer to the table entry corresponding to the entry to edit. You need to set OP1 to the value in the editing field and return with zero reset. (So say you type something into Xmin, you must set OP1 to the value of Xmin here.) If you return with zero set, the os will try to read the value at HL and use it to recall the system token specified by it. (This will only work correctly if you use a table stored in ram or the default os table.)
* '''A = 06h:''' We are done editing an entry. HL points to the table entry that we are done editing, and the value is in OP1. You probably want to save this value.
* '''A = 07h:''' The hook needs the address of the first real entry in the table returned in HL (''not'' one of the start/end entries.) See the comments section for details.
* '''A = 09h:''' We are going to display one of the numbers. HL is pointing to the appropriate table entry. You probably want to copy the number into OP1 and execute the following code (see the docs for [[83Plus:BCALLs:4990:FormEReal]] and [[83Plus:BCALLs:4522|WPutSEOL]] for more info):
<nowiki>ld a, 15h
B_CALL FormEReal
ld hl, OP3
B_CALL WPutSEOL</nowiki>
* '''A = 0Ah:''' A key was pressed, the keycode is in B. You can modify this as needed.

== Comments ==
The table is the most important part of the hook, which tells what you want the table to look like. Each record in the table is three bytes. The first byte is simply a value which you can use to identify the entry. It can be a memory offset (one byte only), token identifier, keypress equate, or any other one byte value. If you use a table stored in ram and let the os handle events 05h,06h and 09h (by returning with zero set), it will interpret it as a token identifier to be displayed or stored. However, it has one special value, 0FFh, which means this record indicates either the start or end of the table. The second and third bytes are simply the pointer to the string to be displayed, null terminated as usual.

Here's an example table:

<nowiki> db 0FFh ; Dummy Entry signifying start of table
dw 0 ; Doesn't matter on string pointer
TableStart:
db 0 ; Identifier
dw EntryString1 ; Pointer to string
; Simply using this assemble trick is perfect
db 1 ; Same as above
dw EntryString2 ; Same as above

db 0FFh ; Dummy Entry signifying end of table
; No need for string pointer, the OS never checks

EntryString1: db "Var=", 0
EntryString2: db "Var2=", 0</nowiki>

When you pass the table pointer in message 7, pass "TableStart" as indicated above, as that is the first entry to be displayed.

'''NOTE:''' If you read the documentation above precisely you will see that the os never directly reads the table. Thus if you're feeling adventurous, you don't have to use this table at all.

== Credits and Contributions ==
* '''Kirk Meyer:''' For Graph<sup>3</sup>, which uses this hook and provided a working example of the hook.

83Plus:BCALLs:4FCF

2006-07-11T15:16:15Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableYEquHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableYEquHook]]
[[Category:83Plus:BCALLs:By Address|4FCF - EnableYEquHook]]
== Synopsis ==
'''Official Name:''' EnableYEquHook

'''BCALL Address:''' 4FCF

Sets and enables the [[83Plus:Hooks:9B98|YEqu Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:528A

2006-07-11T15:15:26Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableUSBActivityHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableUSBActivityHook]]
[[Category:83Plus:BCALLs:By Address|528A - EnableUSBActivityHook]]
== Synopsis ==
'''Official Name:''' EnableUSBActivityHook

'''BCALL Address:''' 528A

Sets and enables the [[83Plus:Hooks:9BD4|USB Activity Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:4FF3

2006-07-11T15:14:46Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableTraceHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableTraceHook]]
[[Category:83Plus:BCALLs:By Address|4FF3 - EnableTraceHook]]
== Synopsis ==
'''Official Name:''' EnableTraceHook

'''BCALL Address:''' 4FF3

Sets and enables the [[83Plus:Hooks:9BA8|Trace Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:4F99

2006-07-11T15:14:13Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableTokenHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableTokenHook]]
[[Category:83Plus:BCALLs:By Address|4F99 - EnableTokenHook]]
== Synopsis ==
'''Official Name:''' EnableTokenHook

'''BCALL Address:''' 4F99

Sets and enables the [[83Plus:Hooks:9BC8|Token Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:50CE

2006-07-11T15:13:12Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableSilentLinkHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableSilentLinkHook]]
[[Category:83Plus:BCALLs:By Address|50CE - EnableSilentLinkHook]]
== Synopsis ==
'''Official Name:''' EnableSilentLinkHook

'''BCALL Address:''' 50CE

Sets and enables the [[83Plus:Hooks:9BD0|Silent Link Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:4FEA

2006-07-11T15:12:24Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableRegraphHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableRegraphHook]]
[[Category:83Plus:BCALLs:By Address|4FEA - EnableRegraphHook]]
== Synopsis ==
'''Official Name:''' EnableRegraphHook

'''BCALL Address:''' 4FEA

Sets and enables the [[83Plus:Hooks:9BA0|Regraph Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:4F66

2006-07-11T15:11:32Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableRawKeyHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableRawKeyHook]]
[[Category:83Plus:BCALLs:By Address|4F66 - EnableRawKeyHook]]
== Synopsis ==
'''Official Name:''' EnableRawKeyHook

'''BCALL Address:''' 4F66

Sets and enables the [[83Plus:Hooks:9B84|Raw Key Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:5026

2006-07-11T15:10:36Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableParserHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableParserHook]]
[[Category:83Plus:BCALLs:By Address|5026 - EnableParserHook]]
== Synopsis ==
'''Official Name:''' EnableParserHook

'''BCALL Address:''' 5026

Sets and enables the [[83Plus:Hooks:9BAC|Parser Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:5083

2006-07-11T15:09:32Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableMenuHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableMenuHook]]
[[Category:83Plus:BCALLs:By Address|5083 - EnableMenuHook]]
== Synopsis ==
'''Official Name:''' EnableMenuHook

'''BCALL Address:''' 5083

Sets and enables the [[83Plus:Hooks:9BC0|Menu Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:4F93

2006-07-11T15:08:28Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableLocalizeHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableLocalizeHook]]
[[Category:83Plus:BCALLs:By Address|4F93 - EnableLocalizeHook]]
== Synopsis ==
'''Official Name:''' EnableLocalizeHook

'''BCALL Address:''' 4F93

Sets and enables the [[83Plus:Hooks:9BCC|Localize Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:4F84

2006-07-11T15:07:44Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableLinkActivityHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableLinkActivityHook]]
[[Category:83Plus:BCALLs:By Address|4F84 - EnableLinkActivityHook]]
== Synopsis ==
'''Official Name:''' EnableLinkActivityHook

'''BCALL Address:''' 4F84

Sets and enables the [[83Plus:Hooks:9B78|Link Activity Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:4F63

2006-07-11T15:06:53Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableLibraryHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableLibraryHook]]
[[Category:83Plus:BCALLs:By Address|4F63 - EnableLibraryHook]]
== Synopsis ==
'''Official Name:''' EnableLibraryHook

'''BCALL Address:''' 4F63

Sets and enables the [[83Plus:Hooks:9B80|Library Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:4FAB

2006-07-11T15:06:01Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableHomescreenHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableHomescreenHook]]
[[Category:83Plus:BCALLs:By Address|4FAB - EnableHomescreenHook]]
== Synopsis ==
'''Official Name:''' EnableHomescreenHook

'''BCALL Address:''' 4FAB

Sets and enables the [[83Plus:Hooks:9B8C|Homescreen Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:4FAB

2006-07-11T15:05:30Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableHomescreenHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableHomescreenHook]]
[[Category:83Plus:BCALLs:By Address|4FAB - EnableHomescreenHook]]
== Synopsis ==
'''Official Name:''' EnableHomescreenHook

'''BCALL Address:''' 4FAB

Sets and enables the [[83Plus:Hooks:ADD|Homescreen Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:504A

2006-07-11T15:04:43Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableHelpHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableHelpHook]]
[[Category:83Plus:BCALLs:By Address|504A - EnableHelpHook]]
== Synopsis ==
'''Official Name:''' EnableHelpHook

'''BCALL Address:''' 504A

Sets and enables the [[83Plus:Hooks:9BB8|Help Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:5032

2006-07-11T15:03:39Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableGraphicsHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableGraphicsHook]]
[[Category:83Plus:BCALLs:By Address|5032 - EnableGraphicsHook]]
== Synopsis ==
'''Official Name:''' EnableGraphicsHook

'''BCALL Address:''' 5032

Sets and enables the [[83Plus:Hooks:9BA4|Graphics Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:4FB7

2006-07-11T15:02:57Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableGraphHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableGraphHook]]
[[Category:83Plus:BCALLs:By Address|4FB7 - EnableGraphHook]]
== Synopsis ==
'''Official Name:''' EnableGraphHook

'''BCALL Address:''' 4FB7

Sets and enables the [[83Plus:Hooks:9B94|Graph Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:4F7B

2006-07-11T15:01:24Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableGetCSCHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableGetCSCHook]]
[[Category:83Plus:BCALLs:By Address|4F7B - EnableGetCSCHook]]
== Synopsis ==
'''Official Name:''' EnableGetCSCHook

'''BCALL Address:''' 4F7B

Sets and enables the [[83Plus:Hooks:9B88|GetCSC Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:4FE4

2006-07-11T15:00:24Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableFontHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableFontHook]]
[[Category:83Plus:BCALLs:By Address|4FE4 - EnableFontHook]]
== Synopsis ==
'''Official Name:''' EnableFontHook

'''BCALL Address:''' 4FE4

Sets and enables the [[83Plus:Hooks:9B9C|Font Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:506B

2006-07-11T14:59:18Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnablecxRedispHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnablecxRedispHook]]
[[Category:83Plus:BCALLs:By Address|506B - EnablecxRedispHook]]
== Synopsis ==
'''Official Name:''' EnablecxRedispHook

'''BCALL Address:''' 506B

Sets and enables the [[83Plus:Hooks:9BBC|cxRedisp Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:4F60

2006-07-11T14:58:30Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableCursorHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableCursorHook]]
[[Category:83Plus:BCALLs:By Address|4F60 - EnableCursorHook]]
== Synopsis ==
'''Official Name:''' EnableCursorHook

'''BCALL Address:''' 4F60

Sets and enables the [[83Plus:Hooks:9B7C|Cursor Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:4F8D

2006-07-11T14:57:16Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableCatalog2Hook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableCatalog2Hook]]
[[Category:83Plus:BCALLs:By Address|4F8D - EnableCatalog2Hook]]
== Synopsis ==
'''Official Name:''' EnableCatalog2Hook

'''BCALL Address:''' 4F8D

Sets and enables the [[83Plus:Hooks:9BC4|Catalog2 Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:5044

2006-07-11T14:56:17Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableCatalog1Hook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableCatalog1Hook]]
[[Category:83Plus:BCALLs:By Address|5044 - EnableCatalog1Hook]]
== Synopsis ==
'''Official Name:''' EnableCatalog1Hook

'''BCALL Address:''' 5044

Sets and enables the [[83Plus:Hooks:9BB4|Catalog1 Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:502C

2006-07-11T14:55:13Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableAppChangeHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableAppChangeHook]]
[[Category:83Plus:BCALLs:By Address|502C - EnableAppChangeHook]]
== Synopsis ==
'''Official Name:''' EnableAppChangeHook

'''BCALL Address:''' 502C

Sets and enables the [[83Plus:Hooks:9BB0|App Change Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:BCALLs:4FB1

2006-07-11T14:53:31Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|EnableWindowHook]]
[[Category:83Plus:BCALLs:By Name:Hook|EnableWindowHook]]
[[Category:83Plus:BCALLs:By Address|4FB1 - EnableWindowHook]]
== Synopsis ==
'''Official Name:''' EnableWindowHook

'''BCALL Address:''' 4FB1

Sets and enables the [[83Plus:Hooks:4FB1|Window Hook]].

=== Inputs ===
* A: page of the hook
* HL: Adress of the hook

=== Outputs ===
* None

=== Destroys ===
* None

83Plus:Hooks:9BC0

2006-07-11T07:39:18Z

Mmartin: added menu table example

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

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

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

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

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

'''Hook Active Flag:''' [[83Plus:Flags:36#Bit_6|6, (iy + 36h)]]

The menu hook allows for modification of any of the system menus that are presented through the system monitor.

== Using the Hook ==
This hook, like most, is called for several events, each identified by A. In general, it appears that returning with the zero flag set will cause the OS to execute its normal behavior.

I've ordered the events in the order that they are called by the OS.

* '''A = 04h:''' This is the first event called. B contains the value of the menu about to be displayed. When this event is triggered, [[83Plus:RAM:85DE|MenuCurrent]] currently contains the ID referring to the menu that was previously displayed (if you went from one menu directly to another), or 0 if previously there was no menu displayed (you were seeing the context itself.)
* '''A = 00h:''' This is the second event, called after event 04h. This event allows you to provide your own menu table. B contains the menu ID. If you want to provide your own table, copy it to RAM, point HL to it, and return with the zero flag reset. It's called a second time, but with B being zero. The outputs appear to be the same, so handle it the same way.
* '''A = 02h:''' This event is called before the OS draws the menu header. C is the index of the header (zero based.) Returning with zero set will draw the header, returning with zero reset will cause it to not draw the header. It's also called after it's done drawing the headers, with C is the number of headers (basically, last index plus one). Return flag seems to be ignored.
* '''A = 01h:''' The OS is about to draw the text corresponding to a menu item. The number prefix has already been drawn. C contains the index of the item (zero indexed.) Returning with zero set will cause the OS to draw the string, returning with zero reset will cause it just to draw a blank line (but it does draw something!)
* '''A = 03h:''' The user selected an item from the menu that is about to cause a context switch. B contains the ID of the context the calculator might switch to. You can return with zero set to execute the app, or zero reset to cancel the execution. If you're switching to a flash app (B is cxextapps), then DE also points to the end of the name of the flash app in RAM. You can cancel the execution of a flash app (this could prove useful for a security app.)

== Example ==
This is an example of a menu table taken from graph3.
<nowiki>ZoomMenu:
db 1 ;how many headers?
db 3 ;how many choices under 1st header?
db 5Eh ;string table entry for "ZOOM"
db 0,kZIn
db 0,kZOut ;these are 2-byte keypresses of each entry
db 0,kStd</nowiki>

== Credits and Contributions ==
* '''Kirk Meyer:''' For providing an example of this hook in graph3

83Plus:Hooks:9B94

2006-07-10T19:23:50Z

Mmartin: /* Using the Hook */

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

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

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

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

'''Hook Call BCALL:''' ''Unknown''

'''Hook Active Flag:''' [[83Plus:Flags:35#Bit_3|3, (iy + 35h)]]

This hook allows you to recieve notifications about events related to the graph context, allowing you to change some events.

== Using the Hook ==
Like most hooks, the value in A determines what you are being notified of.

* '''A = 00h:''' We are switching to the graph context. Return flags are ignored.
* '''A = 02h:''' The OS is about to draw the X/Y coordinates of both the free-moving cursor and also the trace cursor. Returning with zero reset will prevent drawing of the X/Y coordinates and the movement of the cursor. '''Side Note:''' You can draw the coordinates with the undocumented B_CALL [[83Plus:BCALLs:489D|PutXY]].
* '''A = 04h:''' The OS is about to accept user input again (it is done doing whatever processing it was doing.) Here you could draw any extra UI elements you want to appear atop the graph. Return flags seem to be ignored.
* '''A = 05h:''' The OS is about to blink the free-moving cursor (not the trace cursor, if you want to change that, use the trace hook.) Returning with zero reset will cancel the blink (it'll stay at whatever state it's currently in.)
* '''A = 06h:''' A key was pressed, passed in B. You can cancel the keypress if you return with the zero flag reset, otherwise return the keypress you want to occur in B.
* '''A = 07h:''' The OS is about to draw the graph. This could just include presenting what's in plotSScreen, or actually doing the graphing procedure. Returning with zero reset will cause the OS not to draw the graph / present the graph buffer: you can then draw whatever you want. If you want to control what is actually drawn during a graphing procedure, check out the [[83Plus:Hooks:9BA0|regraph hook]].

== Comments ==
Note: When you press graph to start the context, the OS fires this event after event 00h, with B being kGraph. I'm not sure why they do this, but if you cancel the keypress event 07h won't be fired.

83Plus:BCALLs:4C96

2006-07-10T18:57:13Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|Get_NumKey]]
[[Category:83Plus:BCALLs:By Name:Input|Get_NumKey]]
[[Category:83Plus:BCALLs:By Address|4C96 - Get_NumKey]]

{{missinfo|Destroys}}

== Synopsis ==
'''Official Name:''' Get_NumKey

'''BCALL Address:''' 4C96

Waits for a number key to be pressed (Except for zero) Doesn't return when a non number key is pressed.

=== Inputs ===
* None

=== Outputs ===
* A: the GetCSC code of the key pressed

=== Destroys ===
* Unknown

== Credits and Contributions ==
* '''Michael Vincent:''' For documenting this B_CALL

83Plus:BCALLs:4A02

2006-07-10T18:47:49Z

Mmartin:

[[Category:83Plus:BCALLs:By Name|ConvKeyToTok]]
[[Category:83Plus:BCALLs:By Name:Edit|ConvKeyToTok]]
[[Category:83Plus:BCALLs:By Address|4A02 - ConvKeyToTok]]
----

== Synopsis ==
'''Official Name:''' ConvKeyToTok

'''BCALL Address:''' 4A02

Converts a key into it's corresponding token.

=== Inputs ===
* A: The key code
* [[83Plus:RAM:8446|keyExtend]]: The second byte of the key code if it's an extended key code

=== Outputs ===
* DE: Contains the token, D will be zero for a one byte token.

=== Destroys ===
* All

== Example ==
The code below will display â€˜1â€™ at the cursor location.
<nowiki>LD A,k1 ;Convert â€˜1â€™ into token.
B_CALL ConvKeyToTok
B_CALL PutTokString ;Takes DE as input</nowiki>

== Credits and Contributions ==
* '''Michael Vincent:''' For documenting this B_CALL