Difference between revisions of "FontBase:layoutText"
From GiderosMobile
(----) |
m (Text replacement - "</source>" to "</syntaxhighlight>") |
||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 3: | Line 3: | ||
=== Description === | === Description === | ||
| − | + | Computes the layout of the given text according to a given rectangular region size, layout flags and other parameters. | |
| + | <syntaxhighlight lang="lua"> | ||
| + | (table) = FontBase:layoutText(text,width,height,flags,letterSpacing,lineSpacing,tabSpace,breakChar) | ||
| + | </syntaxhighlight> | ||
Refer to [[TextField:setLayout]] for a description of the arguments. | Refer to [[TextField:setLayout]] for a description of the arguments. | ||
The returned table contains the following fields: | The returned table contains the following fields: | ||
| − | * x,y,w,h: | + | * x,y,w,h: computed bounding box of the full text |
| − | * lines: | + | * lines: the number of lines used to display the text |
| − | * parts: | + | * parts: information about individual chunks of texts |
| − | |||
Each table in the part field of the returned table describes the placement of chunks of text. Their fields are: | Each table in the part field of the returned table describes the placement of chunks of text. Their fields are: | ||
| − | * text: | + | * text: the text to display in this chunk |
| − | * x,y,w,h: | + | * x,y,w,h: computed bounding box of this chunk |
| − | * dx,dy: | + | * dx,dy: coordinates to draw this chunk at |
* sep: separator character that came just after this chunk in text block | * sep: separator character that came just after this chunk in text block | ||
* line: line number this chunk belongs to | * line: line number this chunk belongs to | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
=== Parameters === | === Parameters === | ||
| Line 33: | Line 30: | ||
'''lineSpacing''': (number, default = 0) <br/> | '''lineSpacing''': (number, default = 0) <br/> | ||
'''tabSpace''': (number, default = 4) <br/> | '''tabSpace''': (number, default = 4) <br/> | ||
| − | '''breakChar''': (string) '''optional''' <br/> | + | '''breakChar''': (string) '''optional'''<br/> |
=== Return values === | === Return values === | ||
| − | '''Returns''' (table) | + | '''Returns''' (table) a table describing how to draw the given text<br/> |
| − | |||
| − | |||
| − | |||
| − | <br/> | ||
| − | {{ | + | {{FontBase}} |
| − | |||
Latest revision as of 14:29, 13 July 2023
Available since: Gideros 2017.10
Class: FontBase
Description
Computes the layout of the given text according to a given rectangular region size, layout flags and other parameters.
(table) = FontBase:layoutText(text,width,height,flags,letterSpacing,lineSpacing,tabSpace,breakChar)
Refer to TextField:setLayout for a description of the arguments.
The returned table contains the following fields:
- x,y,w,h: computed bounding box of the full text
- lines: the number of lines used to display the text
- parts: information about individual chunks of texts
Each table in the part field of the returned table describes the placement of chunks of text. Their fields are:
- text: the text to display in this chunk
- x,y,w,h: computed bounding box of this chunk
- dx,dy: coordinates to draw this chunk at
- sep: separator character that came just after this chunk in text block
- line: line number this chunk belongs to
Parameters
text: (string)
width: (number)
height: (number)
flags: (number, default=FontBase.TLF_NOWRAP)
letterSpacing: (number, default = 0)
lineSpacing: (number, default = 0)
tabSpace: (number, default = 4)
breakChar: (string) optional
Return values
Returns (table) a table describing how to draw the given text
