Summary[]
The text console provides a simple method for input and output via text, using INPUT/LINPUT and PRINT. The console also provides basic formatting options such as changing the location of printed text and setting colors/backgrounds for each character. The console also automatically scrolls if too much text is printed.
Interface[]
Commands[]
ACLS
|
Clears the text console and several other things |
CLS
|
Clears the text console, as well as lower screen text. |
LOCATE
|
Sets the current text cursor position. |
COLOR
|
Sets the foreground color palette and background color for text. |
PRINT
|
Prints text to the screen. |
INPUT
|
Gets user input and stores the result into one or more variables. |
LINPUT
|
Gets user input and stores the result into a variable. |
Functions[]
CHKCHR
|
Read a character from the console. |
System Variables[]
CSRX
|
The current X location of the cursor |
CSRY
|
The current Y location of the cursor |
TABSTEP
|
The current number of spaces in one tab |
Resources[]
BGF0U
|
This is the font resource used. |
BGD0U
|
This is used for COLOR backgrounds
|
SPS0U
|
This contains the text cursors used for INPUT and LINPUT
|
Additional Information[]
The text console itself is rendered in the same way as the background layers are, as two 64x64 tilemaps with 4-bit color 8x8 pixel tiles. The foreground layer is used for the text characters, and the background layer is used for the COLOR background setting. Unlike the background layers, the text console cannot be moved, so only the upper-left 32x24 tile region visible is used.
The text layer uses BGF resources; the background layer uses BGD resources. It is possible to print characters not in BGF0 by loading a MEM containing those characters, which allows you to access a sort of "BGF1" containing the editor line-number characters and some other extras. The text background layer uses either BGD0U tile 0 (transparent, used for background color 0) or tile 15 (solid tile of color 15 of background palette). It is possible to redefine these tiles using LOAD or CHRSET to change the background tile used.
While it is possible to read the normal set of CHR$(0) to CHR$(255) characters using CHKCHR, it is not possible to distinguish the "extra" characters such as the line-number characters - the codes returned will still be in the 0-255 range. It is not possible to read the foreground or background colors from the console, or the currently set foreground or background color.