{{newin|[[0.10.0]]|100|type=function}}
Adds additional formatted / colored text to the Text object at the specified position.

The word wrap limit is applied before any scaling, rotation, and other coordinate transformations. Therefore the amount of text per line stays constant given the same wrap limit, even if the scale arguments change.

{{notice|Text may appear blurry if it's rendered at non-integer pixel locations.}}
== Function ==
=== Synopsis ===
<source lang="lua">
index = Text:addf( textstring, wraplimit, alignmode, x, y, angle, sx, sy, ox, oy, kx, ky )
</source>
=== Arguments ===
{{param|string|textstring|The text to add to the object.}}
{{param|number|wraplimit|The maximum width in pixels of the text before it gets automatically wrapped to a new line.}}
{{param|AlignMode|align|The alignment of the text.}}
{{param|number|x|The position of the new text (x-axis).}}
{{param|number|y|The position of the new text (y-axis).}}
{{param|number|angle (0)|Orientation (radians).}}
{{param|number|sx (1)|Scale factor (x-axis).}}
{{param|number|sy (sx)|Scale factor (y-axis).}}
{{param|number|ox (0)|Origin offset (x-axis).}}
{{param|number|oy (0)|Origin offset (y-axis).}}
{{param|number|kx (0)|Shearing / skew factor (x-axis).}}
{{param|number|ky (0)|Shearing / skew factor (y-axis).}}
=== Returns ===
{{param|number|index|An index number that can be used with [[Text:getWidth]] or [[Text:getHeight]].}}

== Function ==
=== Synopsis ===
<source lang="lua">
index = Text:addf( coloredtext, wraplimit, alignmode, x, y, angle, sx, sy, ox, oy, kx, ky )
</source>
=== Arguments ===
{{param|table|coloredtext|A table containing colors and strings to add to the object, in the form of <code>{color1, string1, color2, string2, ...}</code>.}}
{{subparam|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 <code>{red, green, blue, alpha}</code>.}}
{{subparam|string|string1|A string of text which has a color specified by the previous color.}}
{{subparam|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 <code>{red, green, blue, alpha}</code>.}}
{{subparam|string|string2|A string of text which has a color specified by the previous color.}}
{{subparam|tables and strings|...|Additional colors and strings.}}
{{param|number|wraplimit|The maximum width in pixels of the text before it gets automatically wrapped to a new line.}}
{{param|AlignMode|align|The alignment of the text.}}
{{param|number|x|The position of the new text (x-axis).}}
{{param|number|y|The position of the new text (y-axis).}}
{{param|number|angle (0)|Orientation (radians).}}
{{param|number|sx (1)|Scale factor (x-axis).}}
{{param|number|sy (sx)|Scale factor (y-axis).}}
{{param|number|ox (0)|Origin offset (x-axis).}}
{{param|number|oy (0)|Origin offset (y-axis).}}
{{param|number|kx (0)|Shearing / skew factor (x-axis).}}
{{param|number|ky (0)|Shearing / skew factor (y-axis).}}
=== Returns ===
{{param|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 ==
* [[parent::Text]]
* [[Text:add]]
* [[Text:set]]
* [[Text:setf]]
* [[Text:clear]]
[[Category:Functions]]
{{#set:Description=Adds additional formatted / colored text to the Text object at the specified position.}}
== Other Languages ==
{{i18n|Text:addf}}