text


ascii

text

character

number

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

print ascii "A
65


backspace

text

none

none

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

backspace


center

text

none

none

Centers any text output using print.

center


char

text

ASCII value (number)

character

Returns a character with the specified ASCII value.

show char 84
T


cleartext ct

text

none

none

Clears the text area.

cleartext


colchar

text

color index (number)

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

text

none

none

Returns the position of the text cursor.

show cursor


cursorchar

text

none

character (word)

Returns the current cursor character. See setcursorchar

show cursorchar


cursordown cd

text

none

none

Moves the text cursor down one.

cursordown


cursorhome

text

none

none

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

cursorhone


cursorleft cl

text

none

none

Moves the text cursor one to the left.

cursorleft


cursorright cr

text

none

none

Moves the text cursor one to the right.

cursorright


cursorup cu

text

none

none

Moves the text cursor up one.

cursorup


definetextcolor

text

index (number) | list or word

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

text

none

none

Causes subsequent text to flash. See inverse, normal.

flash


hidecursor

text

none

none

Hides the text cursor.

hidecursor


inverse

text

none

none

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

inverse


justify

text

none

word

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

show justify
left


leftjustify

text

none

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

text

none

none

Disables justify (and word wrapping)

nojustify


normal

text

none

none

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

normal


overlayscreen os

text

none

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

text

input

none

Prints the input (word, number, list, expression) to the screen. If leftjustify, rightjustify or center is enabled, then print automatically wraps its output. See nojustify to disable wrap.

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


randomtextcolor randtc

text

none

none

Sets a random text foreground non-black color

randomtextcolor


randomtextshade randts

text

none

none

Sets a random text shade.

randomtextshade


readtextline

text

line (number)

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

text

[x y] (list)

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

text

none

none

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

resettext


restoretext

text

none

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

text

none

none

Right-justifies text output using print. See leftjustify

rightjustify


savetext

text

none

none

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

savetext


setcursor

text

column (number) | row (number)

none

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

setcursor 10 10


setcursorchar

text

char (word)

none

Sets the text cursor to the provided character.

setcursorchar "X


settextbackground settb

text

color (number)

none

Sets the text background color to the provided number.

settextbackground 5
settextbackground yellow


settextcolor settc

text

foregroundcolor (number) | backgroundcolor (number)

none

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

settextcolor [2 15]


settextfont

text

font-id

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

text

color (number)

none

Sets the text foreground color to the provided number.

settextforeground 2
settextforeground blue


settextshade setts

text

number

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

text

size (number)

none

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

settextsize 1


settextwindow

text

x1 y1 x2 y2 (list)

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

text

columns (number)

none

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

setwidth 60


show

text

input

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

text

none

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

text

none

none

Shows the text cursor.

showcursor


splitscreen ss

text

none

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

text

none

number

Returns the current text background color. See settextbackground

show textbackground


textcolor

text

none

list

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

show textcolor


textfont

text

none

number

Returns the index of the current text font. See settextfont

show textfont


textforeground

text

none

number

Returns the current text foreground color. See settextforeground

show textforeground


textsize

text

none

number

Returns the current text size. See settextsize

show textsize


textshade

text

none

number

Returns the current textshade value.

show textshade


textwindow

text

none

list

Returns the current dimensions of the text window.

show textwindow


type

text

word, number or [list]

none

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

type "frog type "pig
frogpig


width

text

none

number

Returns the width of the text screen.

show width