Available since LÖVE 0.10.0
|
This function is not supported in earlier versions.
|
Adds additional colored text to the Text object at the specified position.
|
Text may appear blurry if it's rendered at non-integer pixel locations.
|
|
Function
Synopsis
index = Text:add( textstring, x, y, angle, sx, sy, ox, oy, kx, ky )
Arguments
string textstring
- The text to add to the object.
number x (0)
- The position of the new text on the x-axis.
number y (0)
- The position of the new text on the y-axis.
number angle (0)
- The orientation of the new text in radians.
number sx (1)
- Scale factor on the x-axis.
number sy (sx)
- Scale factor on the y-axis.
number ox (0)
- Origin offset on the x-axis.
number oy (0)
- Origin offset on the y-axis.
number kx (0)
- Shearing / skew factor on the x-axis.
number ky (0)
- Shearing / skew factor on the y-axis.
Returns
number index
- An index number that can be used with Text:getWidth or Text:getHeight.
Function
Synopsis
index = Text:add( coloredtext, x, y, angle, sx, sy, ox, oy, kx, ky )
Arguments
table coloredtext
- A table containing colors and strings to add to the object, in the form of
{color1, string1, color2, string2, ...}
.
table color1
- A table containing red, green, blue, and optional alpha components to use as a color for the next string in the table, in the form of
{red, green, blue, alpha}
.
string string1
- A string of text which has a color specified by the previous color.
table color2
- A table containing red, green, blue, and optional alpha components to use as a color for the next string in the table, in the form of
{red, green, blue, alpha}
.
string string2
- A string of text which has a color specified by the previous color.
tables and strings ...
- Additional colors and strings.
number x (0)
- The position of the new text on the x-axis.
number y (0)
- The position of the new text on the y-axis.
number angle (0)
- The orientation of the new text in radians.
number sx (1)
- Scale factor on the x-axis.
number sy (sx)
- Scale factor on the y-axis.
number ox (0)
- Origin offset on the x-axis.
number oy (0)
- Origin offset on the y-axis.
number kx (0)
- Shearing / skew factor on the x-axis.
number ky (0)
- Shearing / skew factor on the y-axis.
Returns
number index
- An index number that can be used with Text:getWidth or Text:getHeight.
Notes
The color set by love.graphics.setColor will be combined (multiplied) with the colors of the text, when drawing the Text object.
See Also