Updated December 2013; see History
//TEXTOUT, x, y, text
TEXTOUT outputs a line of text starting at the specified position. Note that any text lines in the printout which are not GDI commands (i.e. don’t start with //) are essentially handled the same as TEXTOUT commands except that the starting position is calculated to be the current position. TEXTOUT, however does not update the internal cursor and thus does not affect the position of subsequent text operations. text does not require quotes, even if it includes commas. Also see SETTEXTALIGN.
|
Parameter |
Description |
|
x |
Starting horizontal position, using the current mapping units. Note that -1 may be used to specify the current position; this can be useful when you don't know the position. |
|
y |
Starting vertical position, using the current mapping units. Note that the position marks the upper right corner of the cell in which the first character is printed. This is usually a few pixels above the tops of the letters. Also note that -1 may be used to specify the current position; this can be useful when you don't know the position. |
|
text |
A string of text to output, up to a maximum of 512 characters (after expansion of any variables). It is not necessary to quote this argument, even if it contains embedded commas. See explanatory note under TEXTINDENT. |
For information on printing special characters and symbols, see Printing Special Symbols.
History
2013 December, A-Shell 1370: An unmatched leading quote is now treated as a literal character. Previously it was stripped.