BASICLIB FUNCTIONS

 

 

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


 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


BasicLib functions by Alban Gervaise the 10/04/1999

*: functions written by CanyMan

If you have questions or if you have found errors, contact me at

Email: GefunS@I-France.com