The TIPwin86 Library
| DrawWindowPlain | DrawWindowRounded | DrawWindowTitlePlain | DrawWindowTitleRounded |
| HelpBox | MessageBox | MessageBoxCenter | WindowMenu |
To use TIPwin86, copy the TIPwin86.inc file to the same directory as your source, and use '#include LibTIPwin86TIPwin86.TIP' right below your inclusion of system.TI6. To include TIPwin83, which is for the 83+ do the same with TIPwin83.inc and #include LibTIPwin83TIPwin83.TIP. To include TIPwin83reg, which is for the 83 do the same with TIPwin83reg.inc and #include LibTIPwin83TIPwin83reg.TIP. The TI-83 and TI-83+ versions of the library both support using an embedded version, which can be accessed by including #include LibTIPwin83TIPwin83embed.TIP in your source, and then using the functions like normal. This will increase your program size by about 1k though.
** Note: All windows support Auto-Centering. Just indicate 255 as the left value, and the window will be centered automatically for you. **
For examples of any of the following functions, see any of the example source scattered throughout these directories.
| DrawWindowPlain |
Argument Storage: ( sysbytearg0 - sysbytearg3 )
Description: Draws a plain, window with square corners in the specified location and dimensions. Does NOT draw straight to the LCD driver on 83x version, and draws to VideoBuff on the 86 version, which has a default of the LCD screen. Use CopyBuffer on 83x versions to show the window.
| DrawWindowRounded |
Argument Storage: ( sysbytearg0 - sysbytearg3 )
Description: Draws an empty window with rounded corners with specified dimensions and location. Does NOT draw straight onto the LCD driver on the 83x versions, so you have to call CopyBuffer to show it.
| DrawWindowTitlePlain |
Argument Storage: ( sysbytearg0 - sysbytearg3, syspointerarg0 )
Description: Draws an empty window with square corners with specified dimensions and location. Draws a nice looking title bar across the top of the window with the specified title in inverse text on it. Does NOT draw straight onto the LCD driver on the 83x versions, so you have to call CopyBuffer to show it.
| DrawWindowTitleRounded |
Argument Storage: ( sysbytearg0 - sysbytearg3, syspointerarg0 )
Description: Draws an empty window with rounded corners with specified dimensions and location. Draws a nice looking title bar across the top of the window with the specified title in inverse text on it. Does NOT draw straight onto the LCD driver on the 83x versions, so you have to call CopyBuffer to show it.
| HelpBox |
Argument Storage: ( syspointerarg0, syspointerarg1 )
Description: Similar to a message box, except, it is automatically full screen, and you can have as many lines as you want. The Box automatically scrolls through the text with the up and down keys, and returns once exit is pressed and released. Useful for making On-Calc readmes, story lines, etc.
| MessageBox |
Argument Storage: ( sysbytearg0 - sysbytearg3, syspointerarg0, syspointerarg1, sysbytearg4 )
Description: Draws a complete message box with specified title. Message strings should be the name of data declared like so:
Data(messagename)
DataStart(messagename)
.db "string1", 0
.db "string2", 0, 0
EndData
The strings are drawn line by line down the message box, and stop when the routine encounters the two zeros at the end. Once the message box is drawn, it acts according to type, which can be any of the following values:
MB_NONE - the message box is drawn and NOT copied to buffer, and returns to the program
MB_OK - the message box is drawn, shown, and waits for A (2nd) to be pressed and released
MB_YESNO - same as above, except waits, for A or B, and returns IDYES or IDNO accordingly
MB_YESNOCANCEL - same as above, except waits for A,B,or EXIT, and returns IDYES, IDNO, and IDCANCEL accordingly
| MessageBoxCenter |
Argument Storage: ( sysbytearg2, sysbytearg3, syspointerarg0, syspointerarg1, sysbytearg4 )
Description: Same as MessageBox except it centers the window according to the width and height given.
| WindowMenu |
Argument Storage: ( sysbytearg0, sysbytearg1, syspointerarg0, syspointerarg1 )
Description: Creates a multioption menu according to the data in menudata. Menu data is a Data variable declared in the following format: (Brackets indicate what is optional)
[.db 255
.dw PREINITFUNCTIONNAME ]
.db numoptions
.db "option string1", 0
.db "option string2", 0
....
[ .db 255
.dw POSTINITFUNCTIONNAMES ]
.dw FUNCTION1, FUNCTION2, ...
All function names in the data must be in ALL CAPS. These are the functions (which have no parameters) that are called when the user selects the option indicated in the respective option string. The PREINITFUNCTIONNAME and POSTINITFUNCTIONNAME are any valid function that can be called with no parameters (again, in all caps) and are called at specific instances. In order for the routine to know you are specifying a pre or post initialization function, you must add '.db 255' on the line beforehand. A PREINIT function is called before the message box is drawn to VideoBuff at all, so that you can clean up the filth behind the window, etc. A POSTINIT function is called once the window has been drawn, but the menu selection hasn't been started and the buffer hasn't been copied over (so you can draw special gfx or conditional text on the window before it is shown). **Note: You CANNOT have nested WindowMenu functions (a WindowMenu function can't be called from within another WindowMenu's scope. Try it and see the sparks fly!