imagecolortransparent
(PHP 4, PHP 5, PHP 7, PHP 8)
imagecolortransparent — Definiert eine Farbe als transparent
Beschreibung
Liest oder setzt die transparente Farbe des angegebenen 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
Die Kennung der neuen (oder der aktuellen, falls keine Farbe angegeben wurde)
transparenten Farbe wird zurückgegeben. Wird color null, und das Bild hat keine transparente Farbe, ist die
zurückgegebene Kennung -1.
Changelog
| Version | Beschreibung |
|---|---|
| 8.0.0 |
image erwartet nun eine
GdImage-Instanz; vorher wurde eine
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:
Transparenz wird nur mit imagecopymerge() und Echtfarbbildern kopiert, aber 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, werden alle Bereiche eines Bildes mit dieser Farbe, die zuvor gezeichnet wurden, transparent sein.
