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).

Available since 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 prochaîne chaine 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 prochaîne chaine 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 prochaîne chaine 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 prochaîne chaine 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 prochaîne chaine 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 prochaîne chaine de la table, sous la forme {rouge, vert, bleu, alpha}.
string 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 prochaîne chaine 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 prochaîne chaine 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

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

love.graphics.print (Français)

Contents

Fonction

Synopsis

Arguments

Retourne

Fonction

Synopsis

Arguments

Retourne

Fonction

Synopsis

Arguments

Retourne

Notes

Fonction

Synopsis

Arguments

Retourne

Notes

Fonction

Synopsis

Arguments

Retourne

Fonction

Synopsis

Arguments

Retourne

Fonction

Synopsis

Arguments

Retourne

Notes

Function

Synopsis

Arguments

Retourne

Notes

Exemples

Un exemple simple

Trace du texte centré

Notes

Voir également

Autres langues

Search