Difference between revisions of "love.graphics.print (Français)"
(Created page with "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...") |
|||
| (One intermediate revision by the same user not shown) | |||
| 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 | + | {{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 | + | {{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 | + | {{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 | + | {{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 138: | Line 138: | ||
=== 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 | + | {{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 | + | {{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|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.}} | ||
{{param|Transform (Français)|transform|Objet Transformation.}} | {{param|Transform (Français)|transform|Objet Transformation.}} | ||
| + | |||
=== Retourne === | === Retourne === | ||
Rien. | Rien. | ||
| Line 157: | 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 | + | {{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 | + | {{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.
|
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. |
Contents
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
