Difference between revisions of "CompositeFont.new"
From GiderosMobile
| (One intermediate revision by the same user not shown) | |||
| Line 12: | Line 12: | ||
* '''font''': the font object to use for this layer (mandatory) | * '''font''': the font object to use for this layer (mandatory) | ||
* '''color''': the color to use when rendering this layer | * '''color''': the color to use when rendering this layer | ||
| − | * '''alpha''': the alpha value to use with the color (since Gideros 2023.9 if you pass a color you MUST pass its alpha as well) | + | * '''alpha''': the alpha value to use with the color (since Gideros 2023.9 if you pass a color you '''MUST''' pass its alpha as well) |
* '''x''': the X offset to apply (can be a negative value) | * '''x''': the X offset to apply (can be a negative value) | ||
* '''y''': the Y offset to apply (can be a negative value) | * '''y''': the Y offset to apply (can be a negative value) | ||
| − | * name: a name for this layer ('''since 2021.9''') | + | * '''name''': a name for this layer ('''since 2021.9''') |
'''Note''': TTFont without any character list specification aren't supported in composite fonts. | '''Note''': TTFont without any character list specification aren't supported in composite fonts. | ||
Latest revision as of 03:17, 29 November 2024
Available since: Gideros 2019.1
Class: CompositeFont
Description
Creates a new CompositeFont object.
CompositeFont.new(definition)
Each layer of the composited font is defined by a table. The following fields are possible:
- font: the font object to use for this layer (mandatory)
- color: the color to use when rendering this layer
- alpha: the alpha value to use with the color (since Gideros 2023.9 if you pass a color you MUST pass its alpha as well)
- x: the X offset to apply (can be a negative value)
- y: the Y offset to apply (can be a negative value)
- name: a name for this layer (since 2021.9)
Note: TTFont without any character list specification aren't supported in composite fonts.
Parameters
definition: (table) a list of layer definition tables
Example
Drawing a black outline:
local str = "My Composite Font text"
local nf = TTFont.new("fonts/Tahoma.ttf", 32, str, true) --Normal
local of = TTFont.new("fonts/Tahoma.ttf", 32, str, true, 3) --Outlined
local cf= CompositeFont.new{ -- *** PLEASE NOTICE THE CURLY BRACES { } INSTEAD OF ( ) ***
{ font=of, color=0x0, alpha=1, }, -- draw outline in black
{ font=nf, x=1, y=2, }, -- draw normal text with an offset
}
local tf = TextField.new(cf, str)
tf:setTextColor(0xff0000)
tf:setPosition(16, 64)
stage:addChild(tf)
