Difference between revisions of "love.graphics.print (Français)"

(Arguments)
 
Line 22: Line 22:
 
{{param|number (Français)|ox (0)|Déplacement de l'origine (axe des x).}}
 
{{param|number (Français)|ox (0)|Déplacement de l'origine (axe des x).}}
 
{{param|number (Français)|oy (0)|Déplacement de l'origine (axe des y).}}
 
{{param|number (Français)|oy (0)|Déplacement de l'origine (axe des y).}}
{{New feature|0.8.0|
+
{{New feature (Français)|0.8.0|
 
{{param|number (Français)|kx (0)|Facteur de déformation (axe des x).}}
 
{{param|number (Français)|kx (0)|Facteur de déformation (axe des x).}}
 
{{param|number (Français)|ky (0)|Facteur de déformation (axe des y).}}
 
{{param|number (Français)|ky (0)|Facteur de déformation (axe des y).}}
Line 58: Line 58:
 
=== Arguments ===
 
=== Arguments ===
 
{{param|table (Français)|coloredtext|Table contenant les couleurs et chaînes de caractères à ajouter à l'objet, sous le forme de <code>{couleur1, chaîne1, couleur2, chaîne2, ... ...}</code>.}}
 
{{param|table (Français)|coloredtext|Table contenant les couleurs et chaînes de caractères à ajouter à l'objet, sous le forme de <code>{couleur1, chaîne1, couleur2, chaîne2, ... ...}</code>.}}
{{subparam|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 <code>{rouge, vert, bleu, alpha}</code>.}}
+
{{subparam|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 <code>{rouge, vert, bleu, alpha}</code>.}}
 
{{subparam|string (Français)|string1|Chaîne de texte qui a une couleur spécifiée par la couleur précédente.}}
 
{{subparam|string (Français)|string1|Chaîne de texte qui a une couleur spécifiée par la couleur précédente.}}
{{subparam|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 <code>{rouge, vert, bleu, alpha}</code>.}}
+
{{subparam|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 <code>{rouge, vert, bleu, alpha}</code>.}}
 
{{subparam|string (Français)|string2|Chaîne de texte qui a une couleur spécifiée par la couleur précédente.}}
 
{{subparam|string (Français)|string2|Chaîne de texte qui a une couleur spécifiée par la couleur précédente.}}
 
{{subparam|tables and strings (Français)|...|Couleurs et chaînes supplémentaires.}}
 
{{subparam|tables and strings (Français)|...|Couleurs et chaînes supplémentaires.}}
Line 85: Line 85:
 
=== Arguments ===
 
=== Arguments ===
 
{{param|table (Français)|coloredtext|Table contenant les couleurs et chaînes de caractères à ajouter à l'objet, sous le forme de <code>{couleur1, chaîne1, couleur2, chaîne2, ...}</code>.}}
 
{{param|table (Français)|coloredtext|Table contenant les couleurs et chaînes de caractères à ajouter à l'objet, sous le forme de <code>{couleur1, chaîne1, couleur2, chaîne2, ...}</code>.}}
{{subparam|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 <code>{rouge, vert, bleu, alpha}</code>.}}
+
{{subparam|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 <code>{rouge, vert, bleu, alpha}</code>.}}
 
{{subparam|string (Français)|string1|Chaîne de texte qui a une couleur spécifiée par la couleur précédente.}}
 
{{subparam|string (Français)|string1|Chaîne de texte qui a une couleur spécifiée par la couleur précédente.}}
{{subparam|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 <code>{rouge, vert, bleu, alpha}</code>.}}
+
{{subparam|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 <code>{rouge, vert, bleu, alpha}</code>.}}
 
{{subparam|string (Français)|string2|Chaîne de texte qui a une couleur spécifiée par la couleur précédente.}}
 
{{subparam|string (Français)|string2|Chaîne de texte qui a une couleur spécifiée par la couleur précédente.}}
 
{{subparam|tables and strings (Français)|...|Couleurs et chaînes supplémentaires.}}
 
{{subparam|tables and strings (Français)|...|Couleurs et chaînes supplémentaires.}}
Line 158: Line 158:
 
=== Arguments ===
 
=== Arguments ===
 
{{param|table (Français)|coloredtext|Table contenant les couleurs et chaînes de caractères à ajouter à l'objet, sous le forme de <code>{couleur1, chaîne1, coleur2, chaîne2, ...}</code>.}}
 
{{param|table (Français)|coloredtext|Table contenant les couleurs et chaînes de caractères à ajouter à l'objet, sous le forme de <code>{couleur1, chaîne1, coleur2, chaîne2, ...}</code>.}}
{{subparam|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 <code>{rouge, vert, bleu, alpha}</code>.}}
+
{{subparam|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 <code>{rouge, vert, bleu, alpha}</code>.}}
 
{{subparam|string (Français)|string1|Chaîne de texte qui a une couleur spécifiée par la couleur précédente.}}
 
{{subparam|string (Français)|string1|Chaîne de texte qui a une couleur spécifiée par la couleur précédente.}}
{{subparam|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 <code>{rouge, vert, bleu, alpha}</code>.}}
+
{{subparam|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 <code>{rouge, vert, bleu, alpha}</code>.}}
 
{{subparam|string (Français)|string2|Chaîne de texte qui a une couleur spécifiée par la couleur précédente.}}
 
{{subparam|string (Français)|string2|Chaîne de texte qui a une couleur spécifiée par la couleur précédente.}}
 
{{subparam|tables and strings (Français)|...|Couleurs et chaînes supplémentaires.}}
 
{{subparam|tables and strings (Français)|...|Couleurs et chaînes supplémentaires.}}

Latest revision as of 06:25, 20 August 2021

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.

O.png 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



Autres langues