# Imagick::newImage

(PECL imagick 2, PECL imagick 3)

Imagick::newImage — Crée une nouvelle image

### Description

public Imagick::newImage(
int `$cols`,
int `$rows`,
mixed `$background`,
string `$format` = ?
): bool

Crée une nouvelle image et lui associe un objet ImagickPixel pour la couleur de fond

### Liste de paramètres

`cols`

  Le nombre de colonnes de la nouvelle image

`rows`

  Le nombre de lignes de la nouvelle image

`background`

  La couleur de fond utilisée pour cette image

`format`

  Le format de l'image. Ce paramètre a été ajouté en Imagick version 2.0.1.

### Valeurs de retour

Retourne `true` en cas de succès.

### Erreurs / Exceptions

Lance une exception ImagickException si une erreur survient.

### Historique

Version | Description
--- | ---
PECL imagick 2.1.0 | Permet désormais l'utilisation d'une chaîne pour représenter la couleur. Les versions précédentes ne permettaient que les objets ImagickPixel.

### Exemples

Exemple #1 Exemple avec Imagick::newImage()

Crée une nouvelle image et l'affiche.

`<?php
$image = new Imagick();
$image->newImage(100, 100, new ImagickPixel('red'));
$image->setImageFormat('png');
header('Content-type: image/png');
echo $image;
?>`