imagechar

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

imagechar — Dessine un caractère horizontalement

Description

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

imagechar() dessine le premier caractère de la chaîne char dans l'image image avec le coin supérieur gauche placé à la position x,y (le coin en haut à gauche est l'origine (0,0)) avec la couleur color.

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 de départ.
y: Y : coordonnée de départ.
char: Le caractère à dessiner.
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 imagechar()

<?php

$im = imagecreate(100, 100);

$string = 'PHP';

$bg = imagecolorallocate($im, 255, 255, 255);
$black = imagecolorallocate($im, 0, 0, 0);

// affiche un "P" noir dans le coin gauche en haut
imagechar($im, 1, 0, 0, $string, $black);

header('Content-type: image/png');
imagepng($im);

?>

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

Voir aussi

imagecharup() - Dessine un caractère verticalement
imageloadfont() - Charge une nouvelle police