# imagestring

(PHP 4, PHP 5, PHP 7, PHP 8)

imagestring — Dessine une chaîne horizontale

### Description

imagestring(
GdImage `$image`,
GdFont|int `$font`,
int `$x`,
int `$y`,
string `$string`,
int `$color`
): bool

Dessine une chaîne aux coordonnées spécifiées.

### Liste de paramètres

`image`

  Un objet GdImage, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().

`font`

  Peut être 1, 2, 3, 4, 5 pour les polices internes d'encodage Latin2 (où les plus grands nombres correspondent aux polices larges) ou une instance de GdFont retourné par imageloadfont().

`x`

  X : coordonnée du coin en haut, à gauche.

`y`

  Y : coordonnée du coin en haut, à gauche.

`string`

  La chaîne de caractères à écrire.

`color`

  Un identificateur de couleur créé avec imagecolorallocate().

### Valeurs de retour

Cette fonction retourne `true` en cas de succès ou `false` si une erreur survient.

### Historique

Version | Description
--- | ---
8.1.0 | Le paramètre `font` accepte désormais une instance de GdFont et un entier; auparavant seulement un entier était accepté.
8.0.0 | `image` attend une instance de GdImage désormais; auparavant, une resource `gd` était attendue.

### Exemples

Exemple #1 Exemple avec imagestring()

`<?php
// Nouvelle image 100*30
$im = imagecreate(100, 30);
// Fond blanc et texte bleu
$bg = imagecolorallocate($im, 255, 255, 255);
$textcolor = imagecolorallocate($im, 0, 0, 255);
// Ajout de la phrase en haut à gauche
imagestring($im, 5, 0, 0, 'Hello world!', $textcolor);
// Affichage de l'image
header('Content-type: image/png');
imagepng($im);
?>`

Résultat de l'exemple ci-dessus est similaire à :

### Voir aussi

- imagestringup() - Dessine une chaîne verticale
- imageloadfont() - Charge une nouvelle police
- imagettftext() - Dessine un texte avec une police TrueType