imagecreate

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

imagecreateCrée une nouvelle image à palette

Description

function imagecreate(int $width, int $height): GdImage|false

imagecreate() retourne un identifiant d'image représentant une image vide de la taille spécifiée.

En général, il est recommandé d'utiliser la fonction imagecreatetruecolor() au lieu de la fonction imagecreate() afin que l'opération sur l'image s'effectue avec la plus haute qualité possible. Pour produire une image à palette, la fonction imagetruecolortopalette() doit être appelée immédiatement avant l'enregistrement de l'image avec la fonction imagepng() ou la fonction imagegif().

Liste de paramètres

width

La largeur de l'image.

height

La hauteur de l'image.

Valeurs de retour

Retourne un objet d'image en cas de succès, ou false si une erreur survient.

Historique

Version Description
8.0.0 En cas de succès, cette fonction retourne désormais une instance de GDImage ; auparavant, une resource était retournée.

Exemples

Exemple #1 Création d'un nouveau flux d'image GD et affichage d'une image.

<?php
header
("Content-Type: image/png");
$im = @imagecreate(110, 20)
or die(
"Impossible d'initialiser le nouveau flux d'image GD");
$background_color = imagecolorallocate($im, 0, 0, 0);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, "Une simple chaîne de texte", $text_color);
imagepng($im);
?>

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

Affichage de l'exemple : Création d'un nouveau flux d'image GD et affichage d'une image.

Voir aussi