love.graphics.print (Français)

Trace du texte à l'écran. Si aucune Font n'est définie, une sera crée et définie (une seule fois) si nécessaire.

Depuis LOVE 0.7.1, lorsque les fonctions de déplacement et de changement d'échelle sont utilisées lors du tracé du texte, cette fonction assume que la mise à l'échelle est appliquée en premier. Si vous n'avez pas cela à l'esprit lorsque vous scriptez, le texte ne sera pas à la bonne position, voir en dehors de l'écran.

love.graphics.print et love.graphics.printf supportent toutes les deux l'encodage UTF-8. Vous avez également besoin d'une Font (fonte) appropriée pour les caractères spéciaux.

Dans les versions antérieures à LÖVE 11.0, les valeurs des composantes couleurs et octets étaient dans une étendue comprise entre 0 et 255 au lieu de 0 à 1.

Le texte pourrait apparaître flou si il est rendu à une position de pixels non-entière, c'est à dire, à une position utilisant des décimales.

Fonction

Synopsis

love.graphics.print( text, x, y, r, sx, sy, ox, oy, kx, ky )

Arguments

string (Français) text

Texte à tracer.

number (Français) x (0)

Position à laquelle tracer l'objet (axe des x).

number (Français) y (0)

Position à laquelle tracer l'objet (axe des y).

number (Français) r (0)

Orientation (radians).

number (Français) sx (1)

Facteur d'échelle (axe des x).

number (Français) sy (sx)

Facteur d'échelle (axe des y).

number (Français) ox (0)

Déplacement de l'origine (axe des x).

number (Français) oy (0)

Déplacement de l'origine (axe des y).

Disponible depuis LÖVE 0.8.0

number (Français) kx (0)

Facteur de déformation (axe des x).

number (Français) ky (0)

Facteur de déformation (axe des y).

Retourne

Rien.

Fonction

Disponible depuis LÖVE 11.0

Ce-tte variant n'est pas supporté-e par des versions plus anciennes.

Synopsis

love.graphics.print( text, font, x, y, r, sx, sy, ox, oy, kx, ky )

Arguments

string (Français) text

Texte à tracer.

Font (Français) font

Objet Font à utiliser.

number (Français) x (0)

Position à laquelle tracer l'objet sur l'axe des x.

number (Français) y (0)

Position à laquelle tracer l'objet sur l'axe des y.

number (Français) angle (0)

Orientation 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 déformation/étirement sur l'axe des x.

number (Français) ky (0)

Facteur de déformation/étirement sur l'axe des y.

Retourne

Rien.

Fonction

Disponible depuis LÖVE 0.10.0

Ce-tte variant n'est pas supporté-e par des versions plus anciennes.

Synopsis

love.graphics.print( coloredtext, x, y, angle, sx, sy, ox, oy, kx, ky )

Arguments

table (Français) coloredtext

Table contenant les couleurs et chaînes de caractères à ajouter à l'objet, sous le forme de {couleur1, chaîne1, couleur2, chaîne2, ... ...}.

table (Français) color1

Table contenant les composantes rouge, vert, bleu et l'optionnel alpha à utiliser comme couleur pour la prochaine chaîne de la table, sous la forme {rouge, vert, bleu, alpha}.

string (Français) string1

Chaîne de texte qui a une couleur spécifiée par la couleur précédente.

table (Français) color2

Table contenant les composantes rouge, vert, bleu et l'optionnel alpha à utiliser comme couleur pour la prochaine chaîne de la table, sous la forme {rouge, vert, bleu, alpha}.

string (Français) string2

Chaîne de texte qui a une couleur spécifiée par la couleur précédente.

tables and strings (Français) ...

Couleurs et chaînes supplémentaires.

number (Français) x (0)

Position à laquelle tracer l'objet sur l'axe des x.

number (Français) y (0)

Position à laquelle tracer l'objet sur l'axe des y.

number (Français) angle (0)

Orientation 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 déformation/étirement sur l'axe des x.

number (Français) ky (0)

Facteur de déformation/étirement sur l'axe des y.

Retourne

Rien.

Notes

Les couleurs définies par love.graphics.setColor seront combinées (multipliées) avec les couleurs du texte.

Fonction

Disponible depuis LÖVE 11.0

Ce-tte variant n'est pas supporté-e par des versions plus anciennes.

Synopsis

love.graphics.print( coloredtext, font, x, y, angle, sx, sy, ox, oy, kx, ky )

Arguments

table (Français) coloredtext

Table contenant les couleurs et chaînes de caractères à ajouter à l'objet, sous le forme de {couleur1, chaîne1, couleur2, chaîne2, ...}.

table (Français) color1

Table contenant les composantes rouge, vert, bleu et l'optionnel alpha à utiliser comme couleur pour la prochaine chaîne de la table, sous la forme {rouge, vert, bleu, alpha}.

string (Français) string1

Chaîne de texte qui a une couleur spécifiée par la couleur précédente.

table (Français) color2

Table contenant les composantes rouge, vert, bleu et l'optionnel alpha à utiliser comme couleur pour la prochaine chaîne de la table, sous la forme {rouge, vert, bleu, alpha}.

string (Français) string2

Chaîne de texte qui a une couleur spécifiée par la couleur précédente.

tables and strings (Français) ...

Couleurs et chaînes supplémentaires.

Font (Français) font

Objet Font (fonte) à utiliser.

number (Français) x (0)

Position à laquelle tracer l'objet sur l'axe des x.

number (Français) y (0)

Position à laquelle tracer l'objet sur l'axe des y.

number (Français) angle (0)

Orientation 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 déformation/étirement sur l'axe des x.

number (Français) ky (0)

Facteur de déformation/étirement sur l'axe des y.

Retourne

Rien.

Notes

Les couleurs définies par love.graphics.setColor seront combinées (multipliées) avec les couleurs du texte.

Fonction

Disponible depuis LÖVE 11.0

Ce-tte variant n'est pas supporté-e par des versions plus anciennes.

Synopsis

love.graphics.print( text, transform )

Arguments

string (Français) text

Texte à tracer.

Transform (Français) transform

Objet Transformation.

Retourne

Rien.

Fonction

Disponible depuis LÖVE 11.0

Ce-tte variant n'est pas supporté-e par des versions plus anciennes.

Synopsis

love.graphics.print( text, font, transform )

Arguments

string (Français) text

Le texte à tracer.

Font (Français) font

Objet Font à utilisier.

Transform (Français) transform

Objet Transformation.

Retourne

Rien.

Fonction

Disponible depuis LÖVE 11.0

Ce-tte variant n'est pas supporté-e par des versions plus anciennes.

Synopsis

love.graphics.print( coloredtext, transform )

Arguments

table (Français) coloredtext

Table contenant les couleurs et chaînes de caractères à ajouter à l'objet, sous le forme de {couleur1, chaîne1, couleur2, chaîne2, ...}.

table (Français) color1

Table contenant les composantes rouge, vert, bleu et l'optionnel alpha à utiliser comme couleur pour la prochaine chaîne de la table, sous la forme {rouge, vert, bleu, alpha}.

string (Français) string1

Chaîne de texte qui a une couleur spécifiée par la couleur précédente.

table (Français) color2

Table contenant les composantes rouge, vert, bleu et l'optionnel alpha à utiliser comme couleur pour la prochaine chaîne de la table, sous la forme {rouge, vert, bleu, alpha}.

string (Français) string2

Chaîne de texte qui a une couleur spécifiée par la couleur précédente.

tables and strings (Français) ...

Couleurs et chaînes supplémentaires.

Transform (Français) transform

Objet Transformation.

Retourne

Rien.

Notes

Les couleurs définies par love.graphics.setColor seront combinées (multipliées) avec les couleurs du texte.

Function

Available since LÖVE 11.0

This variant is not supported in earlier versions.

Synopsis

love.graphics.print( coloredtext, font, transform )

Arguments

table (Français) coloredtext

Table contenant les couleurs et chaînes de caractères à ajouter à l'objet, sous le forme de {couleur1, chaîne1, coleur2, chaîne2, ...}.

table (Français) color1

Table contenant les composantes rouge, vert, bleu et l'optionnel alpha à utiliser comme couleur pour la prochaine chaîne de la table, sous la forme {rouge, vert, bleu, alpha}.

string (Français) string1

Chaîne de texte qui a une couleur spécifiée par la couleur précédente.

table (Français) color2

Table contenant les composantes rouge, vert, bleu et l'optionnel alpha à utiliser comme couleur pour la prochaine chaîne de la table, sous la forme {rouge, vert, bleu, alpha}.

string (Français) string2

Chaîne de texte qui a une couleur spécifiée par la couleur précédente.

tables and strings (Français) ...

Couleurs et chaînes supplémentaires.

Font (Français) font

Objet Font (fonte) à utiliser.

Transform (Français) transform

Objet Transformation.

Retourne

Rien.

Notes

Les couleurs définies par love.graphics.setColor seront combinées (multipliées) avec les couleurs du texte.

Exemples

Un exemple simple

function love.draw()
    love.graphics.setColor(0, 1, 0, 1)
    love.graphics.print("C'est un exemple plutôt lamentable.", 10, 200)
    love.graphics.setColor(1, 0, 0, 1)
    love.graphics.print("Cet exemple lamentable est deux fois plus gros.", 10, 250, 0, 2, 2)
    love.graphics.setColor(0, 0, 1, 1)
    love.graphics.print("Cet exemple est lamentablement vertical.", 300, 30, math.pi/2)
end

Trace du texte centré

function drawCenteredText(rectX, rectY, rectWidth, rectHeight, text)
	local font       = love.graphics.getFont()
	local textWidth  = font:getWidth(text)
	local textHeight = font:getHeight()
	love.graphics.print(text, rectX+rectWidth/2, rectY+rectHeight/2, 0, 1, 1, textWidth/2, textHeight/2)
end

function love.draw()
	local x, y = 100, 60
	local w, h = 400, 40
	love.graphics.rectangle("ligne", x, y, w, h)
	drawCenteredText(x, y, w, h, "J'imprime mon LÖVE")
end

Notes

Dans les version 0.8.0 et antérieures, love.graphics.print s'arrête au premier caractère '\0' (nul). Cela pourrait vous poser des problèmes, si vous ajoutez des saisies de touches par clavier pour former vos chaînes de caractères, comme certaines correspondent à des caractères unicode de plusieurs octets qui pourrait contenir des caractères nuls.

Voir également

• love.graphics (Français)
• love.graphics.printf (Français)
• Font (Français)
• love.graphics.newFont (Français)
• love.graphics.setFont (Français)
• love.graphics.getFont (Français)

Autres langues

Dansk – Deutsch – English – Español – Français – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Polski – Português – Română – Slovenský – Suomi – Svenska – Türkçe – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – ไทย – 日本語 – 正體中文 – 简体中文 – Tiếng Việt – 한국어
More info