imagecolortransparent

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

imagecolortransparent — Definiert eine Farbe als transparent

Beschreibung

imagecolortransparent(GdImage$image, ?int$color = null): int

Liest oder setzt die transparente Farbe des angegebenen Bildes image.

Parameter-Liste

image: Ein GdImage-Objekt, das von einer der Funktionen zur Bilderzeugung, z. B. imagecreatetruecolor(), zurückgegeben wurde.
color: Eine Farbkennung, die mit imagecolorallocate() erzeugt wurde.

Rückgabewerte

Gibt die Kennung der neuen transparenten Farbe zurück (oder der aktuellen, falls keine Farbe angegeben wurde). Falls colornull ist und das Bild keine transparente Farbe hat, ist die zurückgegebene Kennung -1.

Changelog

Version	Beschreibung
8.0.0	`image` erwartet nun eine GdImage-Instanz; vorher wurde eine gültige `gd`-Ressource erwartet.
8.0.0	`color` ist jetzt nullbar.

Beispiele

Beispiel #1 imagecolortransparent()-Beispiel

<?php
// Erzeuge ein 55x30-Bild
$im = imagecreatetruecolor(55, 30);
$red = imagecolorallocate($im, 255, 0, 0);
$black = imagecolorallocate($im, 0, 0, 0);

// Mache den Hintergrund transparent
imagecolortransparent($im, $black);

// Zeichne ein rotes Rechteck
imagefilledrectangle($im, 4, 4, 50, 25, $red);

// Speichere das Bild
imagepng($im, './imagecolortransparent.png');
imagedestroy($im);
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Anmerkungen

Hinweis:
Die Transparenz wird nur mit imagecopymerge() und Echtfarbbildern kopiert, nicht mit imagecopy() oder Palettenbildern.

Hinweis:
Die transparente Farbe ist eine Eigenschaft des Bildes, nicht der Farbe. Sobald eine Farbe als transparente Farbe definiert wurde, sind alle Bereiche eines Bildes mit dieser Farbe, die zuvor gezeichnet wurden, transparent.