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

{{notice|Text may appear blurry if it's rendered at non-integer pixel locations.}}
== Function ==
=== Synopsis ===
<source lang="lua">
index = Text:add( textstring, x, y, angle, sx, sy, ox, oy, kx, ky )
</source>
=== Arguments ===
{{param|string|textstring|The text to add to the object.}}
{{param|number|x (0)|The position of the new text on the x-axis.}}
{{param|number|y (0)|The position of the new text on the y-axis.}}
{{param|number|angle (0)|The orientation of the new text in radians.}}
{{param|number|sx (1)|Scale factor on the x-axis.}}
{{param|number|sy (sx)|Scale factor on the y-axis.}}
{{param|number|ox (0)|Origin offset on the x-axis.}}
{{param|number|oy (0)|Origin offset on the y-axis.}}
{{param|number|kx (0)|Shearing / skew factor on the x-axis.}}
{{param|number|ky (0)|Shearing / skew factor on the 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:add( coloredtext, 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|x (0)|The position of the new text on the x-axis.}}
{{param|number|y (0)|The position of the new text on the y-axis.}}
{{param|number|angle (0)|The orientation of the new text in radians.}}
{{param|number|sx (1)|Scale factor on the x-axis.}}
{{param|number|sy (sx)|Scale factor on the y-axis.}}
{{param|number|ox (0)|Origin offset on the x-axis.}}
{{param|number|oy (0)|Origin offset on the y-axis.}}
{{param|number|kx (0)|Shearing / skew factor on the x-axis.}}
{{param|number|ky (0)|Shearing / skew factor on the 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:addf]]
* [[Text:set]]
* [[Text:setf]]
* [[Text:clear]]
[[Category:Functions]]
{{#set:Description=Adds additional colored text to the Text object at the specified position.}}
== Other Languages ==
{{i18n|Text:add}}