array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.imagecolortransparent.php', 1 => 'imagecolortransparent', 2 => 'Definiert eine Farbe als transparent', ), 'up' => array ( 0 => 'ref.image.php', 1 => 'GD- und Image-Funktionen', ), 'prev' => array ( 0 => 'function.imagecolorstotal.php', 1 => 'imagecolorstotal', ), 'next' => array ( 0 => 'function.imageconvolution.php', 1 => 'imageconvolution', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/image/functions/imagecolortransparent.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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 color null 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');
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Ausgabe des Beispiels: imagecolortransparent()

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.