# imagecreate

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

imagecreate — Erzeugt ein neues Palettenbild

### Beschreibung

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

imagecreate() gibt den Bezeichner für ein Bild zurück, der ein leeres Bild mit der angegebenen Größe repräsentiert.

Im Allgemeinen wird empfohlen, die Funktion imagecreatetruecolor() anstelle von imagecreate() zu verwenden, sodass die Bildverarbeitung mit der bestmöglichen Qualität erfolgt. Sollen Palettenbilder ausgegeben werden, dann sollte imagetruecolortopalette() unmittelbar vor dem Speichern des Bildes mit imagepng() oder imagegif() aufgerufen werden.

### Parameter-Liste

`width`

  Die Breite des Bildes.

`height`

  Die Höhe des Bildes.

### Rückgabewerte

Gibt im Erfolgsfall eine Bildobjekt zurück, im Fehlerfall `false`.

### Changelog

Version | Beschreibung
--- | ---
8.0.0 | Bei Erfolg gibt diese Funktion jetzt eine GDImage-Instanz zurück; zuvor wurde eine Ressource zurückgegeben.

### Beispiele

Beispiel #1 Erzeugen eines neuen GD-Bild-Streams und Ausgabe des Bildes

`<?php
header("Content-Type: image/png");
$im = @imagecreate(110, 20)
or die("Kann keinen neuen GD-Bild-Stream erzeugen");
$background_color = imagecolorallocate($im, 0, 0, 0);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, "Ein Test-String", $text_color);
imagepng($im);
?>`

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

### Siehe auch

- imagecreatetruecolor() - Create a new true color image

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open