Reference › Text — 55 commands
ascii
Input: character
Output: number
Returns the ASCII (American Standard Code for Information Interchange) index value for the specified character.
print ascii "A
65
backspace
Input: none
Output: none
Moves the cursor one space to the left and deletes its contents.
type "ABCD backspace print "!
center
Input: none
Output: none
Centers any text output using print.
center print "Title
leftjustify
char
Input: ASCII value (number)
Output: character
Returns a character with the specified ASCII value.
show char 84
T
cleartext
Also: ct
Input: none
Output: none
Clears the text area.
cleartext
colchar
Input: color index (number)
Output: 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
Input: none
Output: none
Returns the position of the text cursor. In the console (splitscreen or fullscreen) it always returns [0 0]; use textscreen or overlayscreen to track the cursor.
show cursor
cursorchar
Input: none
Output: character (word)
Returns the current cursor character. See setcursorchar
show cursorchar
cursordown
Also: cd
Input: none
Output: none
Moves the text cursor down one.
type "A cursordown type "B cursordown type "C
print "
cursorhome
Input: none
Output: none
Returns the cursor to the left side of the text area.
type "ABC cursorhome type "X
print "
cursorleft
Also: cl
Input: none
Output: none
Moves the text cursor one to the left.
type "ABC cursorleft type "Z
print "
cursorright
Also: cr
Input: none
Output: none
Moves the text cursor one to the right.
type "A cursorright cursorright type "B
print "
cursorup
Also: cu
Input: none
Output: none
Moves the text cursor up one.
print "top print "bottom
cursorup type "*
print "
definetextcolor
Input: index (number) | list or word
Output: 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
Input: none
Output: none
Causes subsequent text to flash. See inverse, normal.
flash print "Warning!
normal print [back to normal]
hidecursor
Input: none
Output: none
Hides the text cursor.
hidecursor
inverse
Input: none
Output: none
Causes subsequent text to be displayed in inverse (foreground color as background color and vice-versa).
inverse print "Highlighted
normal print "plain
justify
Input: none
Output: word
Returns left, right, center or none, dependent on the current setting.
show justify
left
leftjustify
Input: none
Output: 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
rightjustify print "right
leftjustify print "left
linefeed
Input: none
Output: none
Moves the cursor down to the start of the following line.
type "first linefeed print "second
nojustify
Input: none
Output: none
Disables justify (and word wrapping)
nojustify
normal
Input: none
Output: none
Causes subsequent text to be displayed normally, eg without inverse or flash. See inverse, flash
inverse print "Highlighted
normal print "plain
overlayscreen
Also: os
Input: none
Output: 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
Also: pr
Input: input
Output: 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
Also: randtc
Input: none
Output: none
Sets a random text foreground non-black color
repeat 3 [randomtextcolor print "rainbow]
randomtextshade
Also: randts
Input: none
Output: none
Sets a random text shade.
randomtextshade
readtextline
Input: line (number)
Output: 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
Input: [x y] (list)
Output: 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
Input: none
Output: none
Resets the text layer to 60 columns, white on black, text size 1, default font.
resettext
restoretext
Input: none
Output: 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
Input: none
Output: none
Right-justifies text output using print. See leftjustify
rightjustify print [Score 100]
leftjustify
savetext
Input: none
Output: none
Saves the contents of the text screen to a "stack", see restoretext
savetext
setcursor
Input: [column (number) | row (number)] (list)
Output: none
Moves the text cursor to the specified column (x) and row (y). It has no effect in the console (splitscreen or fullscreen); it only applies in textscreen or overlayscreen.
setcursor [10 10]
setcursorchar
Input: char (word)
Output: none
Sets the text cursor to the provided character.
setcursorchar "X
settextbackground
Also: settb
Input: color (number)
Output: none
Sets the text background color to the provided number.
settextbackground 5
settextbackground yellow
settextcolor
Also: settc
Input: foregroundcolor (number) | backgroundcolor (number)
Output: none
Sets the text color. Requires both foreground and background text colors to be specified. See settextforeground and settextbackground
settextcolor [2 15]
settextfont
Input: font-id
Output: 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
Also: settf
Input: color (number)
Output: none
Sets the text foreground color to the provided number.
settextforeground 2
settextforeground blue
settextshade
Also: setts
Input: number
Output: 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
Input: size (number)
Output: none
Sets the text size, where 0 is the smallest text size. It has no effect in the console (splitscreen or fullscreen), which stays at its normal size; it only applies in textscreen or overlayscreen.
settextsize 1
settextwindow
Input: x1 y1 x2 y2 (list)
Output: 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
Input: columns (number)
Output: none
Sets the width of the text screen in columns. Valid values are 40, 50, 60, 80 and 100.
setwidth 60
show
Input: input
Output: 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
Also: sc
Input: none
Output: 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
Input: none
Output: none
Shows the text cursor.
showcursor
splitscreen
Also: ss
Input: none
Output: 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
Input: none
Output: number
Returns the current text background color. See settextbackground
show textbackground
textcolor
Input: none
Output: list
Returns the current text colors (foreground and background) as a list. See settextcolor
show textcolor
textfont
Input: none
Output: number
Returns the index of the current text font. See settextfont
show textfont
textforeground
Input: none
Output: number
Returns the current text foreground color. See settextforeground
show textforeground
textsize
Input: none
Output: number
Returns the current text size. See settextsize
show textsize
textshade
Input: none
Output: number
Returns the current textshade value.
show textshade
textwindow
Input: none
Output: list
Returns the current dimensions of the text window.
show textwindow
type
Input: word, number or [list]
Output: none
Outputs the specified data to the screen without following it by a carriage return. See print, show
type "frog type "pig
frogpig
width
Input: none
Output: number
Returns the width of the text screen.
show width