
***************************************************************************************** 
*				BASICLIB FUNCTIONS					*
*			              v1.1						*
*	   	 		by  Alban Gervaise					*
*			       Last update: 3/04/99					*
*****************************************************************************************
 
 
General syntax:

"function[:argument,argument2...][| fonction2...]"->b_l:basiclib()
A (M) signals that the function can precede an another one (a | separates the 
two functions). 
 
Value b_l:

It allows the communication between the basic and the asm. It is necessary to 
stock a string which is the name of 
the function to execute and BasicLib returns in this variable as a list:
0: an error has been found
1: the function has been executed successfuly
The other values that b_l can take are indicated for each function. 
 


*****************************************************************************
				USER functions 
*****************************************************************************


Fonction 000: Version 
Syntax: "Version"
No argument.
Return the version of BasicLib 



Fonction 001: SetFont (M) 
Syntax: "SetFont:value"
Value=0 (small font), 1(medium font), 2(large font)
Select a font. 
Don't return anything



Fonction 002: Off (M) 
Syntax: "Off"
No argument
Turn off the ti89
Don't return anything



Fonction 003: Contrast (M) 
Syntax: "Contrast:option"
option: up or down 
increase (up) or decrease (down) le contrast
Don't return anything



Fonction 004: ST_showHelp (M) 
Syntax: "ST_showHelp:string"
string: string to display 
Display string in the Status Line
Don't return anything



Fonction 005: ST_eraseHelp (M) 
Syntax: "ST_eraseHelp"
No argument.
Clear the Status Line
Don't return anything



Fonction 006: ST_busy (M) 
Syntax: "ST_busy:value"
value: 0 (no indicator), 1 (busy), 2 (pause)
Change the status of the Status Line indicator
Don't return anything



Fonction 007: WriteStr (M) 
Syntax: "WriteStr:x,y,mode,string"
x: value (0<x<159)
y: value (0<y<99)
mode: 0 (white on black), 1 (black on black), 2 (xor mode), 3 (gray on black), 4 
(black on white)
string: string to display
display string at x, y with the chosen mode
Don't return anything



Fonction 008: Idle_loop (M) 
Syntax: "Idle_loop"
No argument.
Same functions as Pause but wait until ENTER or ESC is pressed (and don't 
break!)
Don't return anything



Fonction 009: SetAPD (M) 
Syntax: "SetAPD:value"
value: number of seconds until ti89 turn off automatically (10 seconds<value<600 
seconds)
Change the time of the Auto Power Down timer
Don't return anything



Fonction 010: RstAPD (M) 
Syntax: "RstAPD"
No argument.
Restore the default value of the APD (5min15sec)
Don't return anything


*****************************************************************************
				FILES Functions
*****************************************************************************


 
Function 011: GetFolder 
Syntax: "GetFolder"
No argument
Return the list of the folders of the ti89



Function 011 bis: GetFolder 
Syntax: "GetFolder:variable"
variable: name of a file which is searched
Return the name of the folder which contains variable



Function 012: GetFile 
Syntax: "GetFile:folder"
folder: name of a folder
return the name of the variables which are in folder.
Return "1" if folder exists but countains no variable, 0 if folder doesn't exist



Function 013: GetSize 
Syntax: "GetSize:folder\variable" or "GetSize:variable"
folder: name of a folder where variable must be, if it is unknown , search 
variable in all folders
Return the size of variable in a string



Function 014: Hide 
Syntax: "Hide:folder\variable" or "Hide:variable"
folder: name of a folder where variable must be, if it is unknown, search 
variable in all folders
Hide variable from the TIOS.
Don't return anything



Function 015: unHide 
Syntax: "unHide:folder\variable" or "unHide:variable"
folder: name of a folder where variable must be, if it is unknown, search 
variable in all folders
Cancel the effects of Hide
Don't return anything


*****************************************************************************
				GRAPHIC Functions
*****************************************************************************


Function 016: Clr_scr (M) 
Syntax: "Clr_scr"
No argument
Clear all the screen
Don't return anything



Function 017: Save_scr 
Syntax: "Save_scr"
No argument
Save the current screen
Return the screen as a PIC



Function 018: Rcl_scr (M) 
Syntax: "Rcl_scr:folder\variable" or "Rcl_scr:variable"
folder: name of the folder where variable must be, if it is unknown , search 
variable in all folders
Recall the screen saved as a PIC by Save_scr
Don't return anything



Function 019: Rcl_ST_line (M) 
Syntax: "Rcl_ST_line"
No argument
Redraw the Status Line
Don't return anything



Function 020: Verti (M) 
Syntax: "Verti:x,y1,y2[,mode]
x: horizontal coord of the line (0<x<159) 
y1: vertical coord of the begin of the line (0<y1<99 and y1<y2)
y2: vertical coord of the end of the line (0<y1<99 and y2>y1)
mode: 0 (invert mode), 1 (white), 2 (black)
Draw a vertical line
Don't return anything



Function 021: Horiz (M) 
Syntax: "Horiz:x1,y,x2[,mode]
x1: horizontal coord of the begin of the line (0<x1<159 and x1<x2)
y: vertical coord of the end of the line (0<y<99)
x2: horizontal coord of the end of the line (0<x2<159 and x2>x1)
mode: 0 (invert mode), 1 (white), 2 (black)
draw a horizontal line



Don't return anything
Function 022: Pixel (M) 
Syntax: "Pixel:x,y[,mode]
x: horizontal coord (0<x<159)
y: vertiacal coord (0<y<99)
mode: 0 (invert mode), 1 (white), 2 (black)
Draw a pixel
Don't return anything



Function 023: Fill (M) 
Syntax: "Fill:x1,y1,x2,y2[,mode]
x1: horizontal coord of the left corner (0<x1<159 and x1<x2)
y1: vertical coord of the top corner (0<y1<99 and y1<y2)
x2: horizontal coord of the right corner (0<x2<159 and x2> x1)
y2: vertical coord of the bottom corner (0<y2<99 and y2>y1)
mode: 0 (invert mode), 1 (white), 2 (black)
Fill a rectangle
Don't return anything



Function 024: Sprite (M) *
 
Syntax: "Sprite: variable , x ,y[,mode]"
variable: name of a PIC (without the folder)
x: horizontal coord of the top left corner of the sprite
y: vertical coord of the bottom right corner of the sprite
mode: 0 (none) 1 (invert mode), 2 (recovert mode), 3 (invert and recover mode)
Draw a sprite
Don't return anything


*****************************************************************************
				OTHER functions
*****************************************************************************


 Function 025: Break (M) 
Syntax: "Break: mode"
mode : 0 (Enable mode), 1(diasble mode), 2(clear current break)
Manage the break function
Don't return anything



Function 026: ST_folder (M)  
Syntax: "ST_folder: string"
string: string with a maximum of 12 character
Change the name of the folder of the Status Sine by the string
Don't return anything



Function 027: Error (M) 
Syntax: "Error: value"
value: value coded for a special error (values can be found in ti89 doc...)
Do an error
Don't return anything


-------------------------------------------------------------------------------------
*:  function written by CandyMan

BasicLib functions by Alban Gervaise the 03/04/1999
If you have questions or if you have found errors, contact me at 

Email: GefunS@I-France.com
