# imagecreate

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

imagecreate — Crée une nouvelle image à palette

### Description

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

imagecreate() retourne un identifiant d'image représentant une image vide.

En général, nous recommandons l'utilisation de la fonction imagecreatetruecolor() au lieu de la fonction imagecreate() afin que l'opération sur l'image s'effectue avec une qualité la plus haute possible. Si vous voulez sortir une palette, alors 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'une image GD et affichage de cette image

`<?php
header("Content-Type: image/png");
$im = @imagecreate(110, 20)
or die("Impossible d'initialiser la bibliothèque GD");
$background_color = imagecolorallocate($im, 0, 0, 0);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, "A Simple Text String", $text_color);
imagepng($im);
?>`

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

### Voir aussi

- imagedestroy() - Détruit une image
- imagecreatetruecolor() - Crée une nouvelle image en couleurs vraies