Text:addf

Available since LÖVE 0.10.0

This function is not supported in earlier versions.

Adds additional formatted / colored text to the Text object at the specified position.

Function

index = Text:addf( textstring, wraplimit, alignmode, x, y, angle, sx, sy, ox, oy, kx, ky )

string textstring: The text to add to the object.
number wraplimit: The maximum width in pixels of the text before it gets automatically wrapped to a new line.
AlignMode align: The alignment of the text.
number x: The position of the new text (x-axis).
number y: The position of the new text (y-axis).
number angle (0): Orientation (radians).
number sx (1): Scale factor (x-axis).
number sy (sx): Scale factor (y-axis).
number ox (0): Origin offset (x-axis).
number oy (0): Origin offset (y-axis).
number kx (0): Shearing / skew factor (x-axis).
number ky (0): Shearing / skew factor (y-axis).

number index: An index number that can be used with Text:getWidth or Text:getHeight.

index = Text:addf( coloredtext, wraplimit, alignmode, x, y, angle, sx, sy, ox, oy, kx, ky )

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.

number wraplimit: The maximum width in pixels of the text before it gets automatically wrapped to a new line.
AlignMode align: The alignment of the text.
number x: The position of the new text (x-axis).
number y: The position of the new text (y-axis).
number angle (0): Orientation (radians).
number sx (1): Scale factor (x-axis).
number sy (sx): Scale factor (y-axis).
number ox (0): Origin offset (x-axis).
number oy (0): Origin offset (y-axis).
number kx (0): Shearing / skew factor (x-axis).
number ky (0): Shearing / skew factor (y-axis).

number index: An index number that can be used with Text:getWidth or Text:getHeight.

The color set by love.graphics.setColor will be combined (multiplied) with the colors of the text, when drawing the Text object.