text


ascii

Takes:   character

Returns:   number

Returns the ASCII (American Standard Code for Information Interchange) index value for the specified character.

print ascii "A
65


backspace

Takes:   none

Returns:   none

Moves the cursor one space to the left and deletes its contents.

backspace


center

Takes:   none

Returns:   none

Centers any text output using print.

center


char

Takes:   ASCII value (number)

Returns:   character

Returns a character with the specified ASCII value.

show char 84
T


cleartext ct

Takes:   none

Returns:   none

Clears the text area.

cleartext


colchar

Takes:   color index (number)

Returns:   none

Inserts a ‘color character’ into a word, which when printed changes the foreground color of the subsequent text in the word to that color. A color character cannot be a list item unto itself (it will return an error).

print word colchar 4 "duck


cursor

Takes:   none

Returns:   none

Returns the position of the text cursor.

show cursor


cursorchar

Takes:   none

Returns:   character (word)

Returns the current cursor character. See setcursorchar

show cursorchar


cursordown cd

Takes:   none

Returns:   none

Moves the text cursor down one.

cursordown


cursorhome

Takes:   none

Returns:   none

Returns the cursor to the left side of the text area.

cursorhone


cursorleft cl

Takes:   none

Returns:   none

Moves the text cursor one to the left.

cursorleft


cursorright cr

Takes:   none

Returns:   none

Moves the text cursor one to the right.

cursorright


cursorup cu

Takes:   none

Returns:   none

Moves the text cursor up one.

cursorup


definetextcolor

Takes:   index (number) | list or word

Returns:   none

definetextcolor takes an index number from 0 to 63 and either a list of three values (representing red, green, and blue) with a value from 0 to 100, or a 6-character word representing a color’s RGB values in hexadecimal format, for example ab1274

definetextcolor 20 [50 20 90]
definetextcolor 21 "ab1274


flash

Takes:   none

Returns:   none

Causes subsequent text to flash. See inverse, normal.

flash


hidecursor

Takes:   none

Returns:   none

Hides the text cursor.

hidecursor


inverse

Takes:   none

Returns:   none

Causes subsequent text to be displayed in inverse (foreground color as background color and vice-versa).

inverse


justify

Takes:   none

Returns:   word

Returns left, right, center or none, dependent on the current setting.

show justify
left


leftjustify

Takes:   none

Returns:   none

Left justifies any text output using print. This is the default behavior. If you want to use multiple spaces in print output, you need to disable justify with nojustify

leftjustify


nojustify

Takes:   none

Returns:   none

Disables justify (and word wrapping)

nojustify


normal

Takes:   none

Returns:   none

Causes subsequent text to be displayed normally, eg without inverse or flash. See inverse, flash

normal


overlayscreen os

Takes:   none

Returns:   none

Overlays the full text screen over the graphics output, basically a transparent textscreen. Not to be confused with camera overlays. See textscreen, splitscreen, fullscreen

overlayscreen


print pr

Takes:   input

Returns:   none

Prints the input (word, number, list, expression) to the screen. If leftjustify, rightjustify or center is enabled, then print automatically wraps its output. However, if any of these are enabled, print cannot output more than one consecutive space. See nojustify to disable wrap.

print "Hello!
print |How are you?|
print [I am fine]
print 5 * 3
print myrtle:position


randomtextcolor randtc

Takes:   none

Returns:   none

Sets a random text foreground non-black color

randomtextcolor


randomtextshade randts

Takes:   none

Returns:   none

Sets a random text shade.

randomtextshade


readtextline

Takes:   line (number)

Returns:   word

Returns the text on the given line. Note that the specified line is based on a 48 vertical line screen (counting from 0), so in 24 line mode (for example) you need to multiply the required line by 2.

show readtextline 0


readtextpos

Takes:   [x y] (list)

Returns:   char

Returns the character at the given text co-ordinates, based on a screen 100 characters wide and 48 characters high, starting at [0 0]. This is regardless of the current text size or screen width, so factor accordingly.

show readtextpos [20 20]


resettext

Takes:   none

Returns:   none

Resets the text layer to 60 columns, white on black, text size 1, default font.

resettext


restoretext

Takes:   none

Returns:   none

Restores the last text screen saved to the “stack”. If there are multiple savetexts, they can be progressively restored by using multiple restoretexts. See savetext

restoretext


rightjustify

Takes:   none

Returns:   none

Right-justifies text output using print. See leftjustify

rightjustify


savetext

Takes:   none

Returns:   none

Saves the contents of the text screen to a “stack”, see restoretext

savetext


setcursor

Takes:   [column (number) | row (number)] (list)

Returns:   none

Moves the text cursor to the specified column (x) and row (y).

setcursor [10 10]


setcursorchar

Takes:   char (word)

Returns:   none

Sets the text cursor to the provided character.

setcursorchar "X


settextbackground settb

Takes:   color (number)

Returns:   none

Sets the text background color to the provided number.

settextbackground 5
settextbackground yellow


settextcolor settc

Takes:   foregroundcolor (number) | backgroundcolor (number)

Returns:   none

Sets the text color. Requires both foreground and background text colors to be specified. See settextforeground and settextbackground

settextcolor [2 15]


settextfont

Takes:   font-id

Returns:   none

Sets the text font, based on a font-id number. 0 is the default high-resolution font. 1 is the Apple II system font. 2 – 5 are stylised low-resolution fonts (fantasy, computer, sci-fi)

settextfont 1


settextforeground settf

Takes:   color (number)

Returns:   none

Sets the text foreground color to the provided number.

settextforeground 2
settextforeground blue


settextshade setts

Takes:   number

Returns:   none

Sets the ‘shade’ or brightness of the text color. settextshade can take a value from 0 (normal) to 15 (darkest). Negative values are not valid for settextshade. Affects both foreground _and_ background. Note that the prompt resets the text shade and so its effect will not be obvious if you simply enter it at the prompt!

settextshade 10


settextsize setts

Takes:   size (number)

Returns:   none

Sets the text size, where 0 is the smallest text size.

settextsize 1


settextwindow

Takes:   x1 y1 x2 y2 (list)

Returns:   none

Sets the area of the text screen to write in. Note that the parameters are based on a 100 by 48 column screen, regardless of current text size.

settextwindow [10 10 70 30]


setwidth

Takes:   columns (number)

Returns:   none

Sets the width of the text screen in columns. Valid values are 40, 50, 60, 80 and 100.

setwidth 60


show

Takes:   input

Returns:   none

Prints the supplied input to the screen (or file if setwrite is enabled), with brackets around lists, if appropriate, followed by a carriage return. Compare with print, type

show [duck pig]
[duck pig]


showcolors sc

Takes:   none

Returns:   none

Shows a colored list of built-in colors. The following colors have named primitives that return their numerical value (eg black returns 0):

black
red
blue
magenta
green
grey
mediumblue
lightblue
brown
orange
lightgrey
pink
lightgreen
yellow
cyan
white

setfillcolor red
setpencolor blue


showcursor

Takes:   none

Returns:   none

Shows the text cursor.

showcursor


splitscreen ss

Takes:   none

Returns:   none

Displays the bottom 4 (in 24 line mode, 8 in 48 line mode, 2 in 12 line mode) lines of the text screen superimposed on the full graphics camera image. This is the default when turtleSpaces starts up. See fullscreen (no text), textscreen (only text), overlayscreen (full text overlaid on graphics)

splitscreen


textbackground

Takes:   none

Returns:   number

Returns the current text background color. See settextbackground

show textbackground


textcolor

Takes:   none

Returns:   list

Returns the current text colors (foreground and background) as a list. See settextcolor

show textcolor


textfont

Takes:   none

Returns:   number

Returns the index of the current text font. See settextfont

show textfont


textforeground

Takes:   none

Returns:   number

Returns the current text foreground color. See settextforeground

show textforeground


textsize

Takes:   none

Returns:   number

Returns the current text size. See settextsize

show textsize


textshade

Takes:   none

Returns:   number

Returns the current textshade value.

show textshade


textwindow

Takes:   none

Returns:   list

Returns the current dimensions of the text window.

show textwindow


type

Takes:   word, number or [list]

Returns:   none

Outputs the specified data to the screen without following it by a carriage return. See print, show

type "frog type "pig
frogpig


width

Takes:   none

Returns:   number

Returns the width of the text screen.

show width