imagecreate
(PHP 4, PHP 5, PHP 7, PHP 8)
imagecreate — Erzeugt ein neues Paletten-Bild
Beschreibung
imagecreate() gibt eine Bildkennung zurück, die eine leeres Bild mit der angegebene Größe repräsentiert.
Im Allgemeinen wird empfohlen, die Funktion imagecreatetruecolor() anstelle von imagecreate() zu verwenden, so dass 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 resource zurückgegeben. |
Beispiele
Beispiel #1 Erzeugung eines neuen GD-Bild-Streams und Ausgabe des Bildes:
<?php
header("Content-type: image/png");
$im = @imagecreate(50, 100)
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);
imagedestroy($im);
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Siehe auch
- imagedestroy() - Löscht ein Bild
- imagecreatetruecolor() - Create a new true color image
