Difference between revisions of "83PCE:Hooks:D0260E"

From WikiTI
Jump to: navigation, search
Line 1: Line 1:
 
[[Category:83PCE:Hooks:By_Name|Token Hook]] [[Category:83PCE:Hooks:By_Address|D0260E - Token Hook]]
 
[[Category:83PCE:Hooks:By_Name|Token Hook]] [[Category:83PCE:Hooks:By_Address|D0260E - Token Hook]]
 +
== Synopsis ==
 +
'''Name:''' Token Hook
 +
 +
'''Hook Pointer Block Address:''' D0260E
 +
 +
'''Hook Enable BCALL:''' 0213F8
 +
 +
'''Hook Disable BCALL:''' 0213FC
 +
 +
'''Hook Call BCALL:''' ''(none known)''
 +
 +
'''Hook Active Flag:''' [[83Plus:Flags:35#Bit_0|0, (iy + 35h)]]
 +
 +
This hook allows you to change the strings displayed for TIOS tokens. It is called every time the OS is about to display a one- or 2-byte token. Note: the hook is not called when the OS draws a string which isn't possible to edit, such as "EDIT" in the program section.
 +
 +
== Using the Hook ==
 +
* DE = token number * 3 (DEU = 0)
 +
** 1-byte:    0000 to 02FD
 +
** Matrix:    0300 to 031B
 +
** List:      031E to 032D
 +
** Equation:  0330 to 038A
 +
** Picture:    038D to 03A8
 +
** GDB:        03AB to 03C6
 +
** String:    03C9 to 03E4
 +
** Output Var: 03E7 to 049B
 +
** System Var: 049E to 0546
 +
** Format:    0549 to 057F
 +
** BB:        0 to 0546 (or higher, depending on OS)
 +
* HL = default string
 +
** Change HL to display a different string, which you must copy to RAM

Revision as of 03:23, 16 July 2016

Synopsis

Name: Token Hook

Hook Pointer Block Address: D0260E

Hook Enable BCALL: 0213F8

Hook Disable BCALL: 0213FC

Hook Call BCALL: (none known)

Hook Active Flag: 0, (iy + 35h)

This hook allows you to change the strings displayed for TIOS tokens. It is called every time the OS is about to display a one- or 2-byte token. Note: the hook is not called when the OS draws a string which isn't possible to edit, such as "EDIT" in the program section.

Using the Hook

  • DE = token number * 3 (DEU = 0)
    • 1-byte: 0000 to 02FD
    • Matrix: 0300 to 031B
    • List: 031E to 032D
    • Equation: 0330 to 038A
    • Picture: 038D to 03A8
    • GDB: 03AB to 03C6
    • String: 03C9 to 03E4
    • Output Var: 03E7 to 049B
    • System Var: 049E to 0546
    • Format: 0549 to 057F
    • BB: 0 to 0546 (or higher, depending on OS)
  • HL = default string
    • Change HL to display a different string, which you must copy to RAM