Difference between revisions of "FontBase:getAdvanceX"

From GiderosMobile
Line 1: Line 1:
__NOTOC__
+
'''Available since:''' Gideros 2011.6<br/>
<languages />
+
'''Class:''' [[FontBase]]<br/>
'''<translate>Available since</translate>:''' Gideros 2011.6<br/>
+
 
'''<translate>Class</translate>:''' [[Special:MyLanguage/FontBase|FontBase]]<br/>
+
=== Description ===
=== <translate>Description</translate> ===
+
Returns the width of the first ''size'' characters of ''text''.
<translate><br />
+
 
Returns the width of the first ''size'' characters of ''text''. <br />
+
Note that this value is not equal to the 3rd return value (width) of ''getBounds()''.
Note that this value is not equal to the 3rd return value (width) of ''getBounds()''. <br />
+
 
''getBounds()'' returns a rectangle describing the bounds this string will cover <br />
+
''getBounds()'' returns a rectangle describing the bounds this string will cover<br/>
whereas ''getAdvanceX()'' returns the distance to where the next string should be drawn.<br />
+
whereas ''getAdvanceX()'' returns the distance to where the next string should be drawn.
<br /></translate>
+
 
 
<source lang="lua">
 
<source lang="lua">
 
(number) = FontBase:getAdvanceX(text,letterSpacing,size)
 
(number) = FontBase:getAdvanceX(text,letterSpacing,size)
 
</source>
 
</source>
=== <translate>Parameters</translate> ===
+
 
'''text''': (string) <translate></translate> <br/>
+
=== Parameters ===
'''letterSpacing''': (number, default = 0) <translate></translate> <br/>
+
'''text''': (string) <br/>
'''size''': (number, optional) <translate></translate> <br/>
+
'''letterSpacing''': (number, default = 0) <br/>
=== <translate>Return values</translate> ===
+
'''size''': (number, optional) <br/>
'''<translate>Returns</translate>''' (number) <translate>The width of the first size characters of text.</translate><br/>
+
 
 +
=== Return values ===
 +
'''Returns''' (number) The width of the first size characters of text.<br/>
 +
 
 +
----
 +
{{Special:PrefixIndex/FontBase:}}
 +
<br/>
 +
 
 +
{{Special:PrefixIndex/FontBase.TLF}}
 +
<br/>

Revision as of 22:18, 2 December 2019

Available since: Gideros 2011.6
Class: FontBase

Description

Returns the width of the first size characters of text.

Note that this value is not equal to the 3rd return value (width) of getBounds().

getBounds() returns a rectangle describing the bounds this string will cover
whereas getAdvanceX() returns the distance to where the next string should be drawn.

(number) = FontBase:getAdvanceX(text,letterSpacing,size)

Parameters

text: (string)
letterSpacing: (number, default = 0)
size: (number, optional)

Return values

Returns (number) The width of the first size characters of text.