Console overview

* 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 | sbs:page/docs-ptc-acls[`ACLS`] | Clears the text console and several other things | | sbs:page/docs-ptc-cls[`CLS`] | Clears the text console, as well as lower screen text. | | sbs:page/docs-ptc-locate[`LOCATE`] | Sets the current text cursor position.| | sbs:page/docs-ptc-color[`COLOR`] | Sets the foreground color palette and background color for text. | | sbs:page/docs-ptc-print[`PRINT`] | Prints text to the screen.| | sbs:page/docs-ptc-input[`INPUT`] | Gets user input and stores the result into one or more variables.| | sbs:page/docs-ptc-linput[`LINPUT`] | Gets user input and stores the result into a variable.| ** Functions {| sbs:page/docs-ptc-chkchr[`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 | | `SPS1U` | 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.