Difference between revisions of "gc:drawString"

From Inspired-Lua Wiki
Jump to navigation Jump to search
Line 24: Line 24:
 
| <u><center>position</center></u> || string || the string’s anchor point. It can either be "baseline", “bottom”, “middle”, or “top”.
 
| <u><center>position</center></u> || string || the string’s anchor point. It can either be "baseline", “bottom”, “middle”, or “top”.
 
|}
 
|}
== Example ==
+
== Example ==
 
<syntaxhighlight>function on.paint(gc)
 
<syntaxhighlight>function on.paint(gc)
 
     gc:drawString("Hello World", 0, 0, "top")
 
     gc:drawString("Hello World", 0, 0, "top")
 
end</syntaxhighlight>
 
end</syntaxhighlight>
 
will display&nbsp;&nbsp;&nbsp; Hello World &nbsp;&nbsp;&nbsp; at the top-left part of the screen.
 
will display&nbsp;&nbsp;&nbsp; Hello World &nbsp;&nbsp;&nbsp; at the top-left part of the screen.
 +
 +
== Good to know ==
 +
In order to clear up what 'position' does, here's an animated image with the 4 possibilities, showing a text that is drawn at the same 60;60 coordinates, but with different "position" attributes.
 +
[[File:drawString_text_position.gif]]
  
 
<br /><br />
 
<br /><br />
 
[[Category:gc]]
 
[[Category:gc]]

Revision as of 12:26, 18 June 2012

drawString is a function that is part of gc (Graphics Context).

This function is used to display text, numbers etc. on the screen at specified coordinates.


Returns an integer corresponding to the width of the displayed string.


This has been introduced in TI-Nspire OS 3.0 (Changes).


Syntax

gc:drawString(string, x, y [,position])

Parameter Type Description
string
string The text to display
x
number the x coordinate of the beginning of the string. Relative to position.
y
number the y coordinate of the beginning of the string. Relative to position.
position
string the string’s anchor point. It can either be "baseline", “bottom”, “middle”, or “top”.

Example

function on.paint(gc)
     gc:drawString("Hello World", 0, 0, "top")
end

will display    Hello World     at the top-left part of the screen.

Good to know

In order to clear up what 'position' does, here's an animated image with the 4 possibilities, showing a text that is drawn at the same 60;60 coordinates, but with different "position" attributes. drawString text position.gif