# Imagick::newImage

(PECL imagick 2, PECL imagick 3)

Imagick::newImage — Crea una nueva imagen

### Descripción

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

Crea una nueva imagen y asocia el valor de ImagickPixel al color de fondo

### Parámetros

`cols`

  Columnas en la nueva imagen

`rows`

  Filas en la nueva imagen

`background`

  El color de fondo usado para esta imagen

`format`

  El formato de la imagen. Este parámetro se añadió en la versión 2.0.1 de Imagick.

### Valores devueltos

Devuelve `true` en caso de éxito.

### Errores/Excepciones

Lanza ImagickException en caso de error.

### Historial de cambios

Versión | Descripción
--- | ---
PECL imagick 2.1.0 | Ahora se permite que una cadena represente el color como tercer parámetro Versiones anteriores sólo permitían un objeto ImagickPixel.

### Ejemplos

Ejemplo #1 Usar Imagick::newImage():

Crear una nueva imagen y mostrarla.

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