Text:addf (Français)

Disponible depuis LÖVE 0.10.0
Ce-tte function n'est pas supporté-e par des versions plus anciennes.

Ajoute du texte formaté / coloré, à la position spécifiée, à l'objet Text (texte).

La limite de largeur de texte est appliquée avant tout changement d'échelle, rotation et autres transformations de coordonnées. La quantité de texte par ligne reste donc constante en fonction de la même limite de largeur, même si l'argument de mise à l'échelle change.

O.png Le texte peut paraître flou si il est rendu à des positions de pixels non entières.  


Fonction

Synopsis

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

Arguments

string (Français) textstring
Texte à ajouter à l'objet.
number (Français) wraplimit
Largeur maximum en pixels du texte avant qu'il ne soit automatiquement déplacé vers une nouvelle ligne.
AlignMode (Français) align
Alignement du texte.
number (Français) x (0)
Position du nouveau texte sur l'axe des x.
number (Français) y (0)
Position du nouveau texte sur l'axe des y.
number (Français) angle (0)
Orientation du nouveau texte en radians.
number (Français) sx (1)
Facteur d'échelle sur l'axe des x.
number (Français) sy (sx)
Facteur d'échelle sur l'axe des y.
number (Français) ox (0)
Déplacement de l'origine sur l'axe des x.
number (Français) oy (0)
Déplacement de l'origine sur l'axe des y.
number (Français) kx (0)
Facteur de transvection sur l'axe des x.
number (Français) ky (0)
Facteur de transvection sur l'axe des y.

Retourne

number (Français) index
Un numéro d'index pouvant être utilisé avec Text:getWidth ou Text:getHeight.

Fonction

Synopsis

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

Arguments

table (Français) coloredtext
Table contenant les couleurs et chaînes de caractère à ajouter à l'objet, sous la forme {coleur1, chaîne1, couleur2, chaîne2, ...}.
table (Français) color1
Table contenant les composantes rouge, vert, bleu, et l'alpha optionnel à utiliser comme couleur pour la prochaine chaîne de caractère de la table, sous la forme {rouge, vert, bleu, alpha}.
string (Français) string1
Chaîne de texte utilisant la couleur spécifiée précédemment.
table (Français) color2
Table contenant les composantes rouge, vert, bleu, et l'alpha optionnel à utiliser comme couleur pour la prochaine chaîne de caractère de la table, sous la forme {rouge, vert, bleu, alpha}.
string (Français) string2
Chaîne de texte utilisant la couleur spécifiée précédemment.
tables and strings (Français) ...
Couleurs et chaînes de caractères additionnelles.
number (Français) wraplimit
Largeur maximum en pixels du texte avant qu'il ne soit automatiquement déplacé vers une nouvelle ligne.
AlignMode (Français) align
Alignement du texte.
number (Français) x (0)
Position du nouveau texte sur l'axe des x.
number (Français) y (0)
Position du nouveau texte sur l'axe des y.
number (Français) angle (0)
Orientation du nouveau texte en radians.
number (Français) sx (1)
Facteur d'échelle sur l'axe des x.
number (Français) sy (sx)
Facteur d'échelle sur l'axe des y.
number (Français) ox (0)
Déplacement de l'origine sur l'axe des x.
number (Français) oy (0)
Déplacement de l'origine sur l'axe des y.
number (Français) kx (0)
Facteur de transvection sur l'axe des x.
number (Français) ky (0)
Facteur de transvection sur l'axe des y.

Retourne

number (Français) index
Un numéro d'index pouvant être utilisé avec Text:getWidth ou Text:getHeight.

Notes

Les couleurs définies à l'aide de love.graphics.setColor seront combinées (multipliées) avec les couleurs du texte, lorsque l'objet texte sera tracé.

Voir également


Autres langues