Text

ascii
backspace
center
char
cleartext ct
colchar
cursor
cursorchar
cursordown cd
cursorhome
cursorleft cl
cursorright cr
cursorup cu
definetextcolor
flash
hidecursor
inverse
justify
leftjustify
nojustify
normal
overlayscreen os
print pr
randomtextcolor randtc
randomtextshade randts
readtextline
readtextpos
resettext
restoretext
rightjustify
savetext
setcursor
setcursorchar
settextbackground settb
settextcolor settc
settextfont
settextforeground settf
settextshade setts
settextsize setts
settextwindow
setwidth
show
showcolors sc
showcursor
splitscreen ss
textbackground
textcolor
textfont
textforeground
textsize
textshade
textwindow
type
width

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