imagecolortransparent

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

imagecolortransparentDefine la color transparente

Descripción

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

Obtiene o define la color transparente para la image proporcionada.

Parámetros

image

Un recurso image, es devuelto por una de las funciones de creación de imágenes, como imagecreatetruecolor().

color

Un identificador de color creato con imagecolorallocate().

Valores devueltos

Se devuelve el identificador de la nueva color transparente (o la actual, si no se especifica ninguna). Si el argumento color es null y la imagen no tiene color transparente, el identificador devuelto será -1.

Historial de cambios

Versión Descripción
8.0.0 image expects a GdImage instance now; previously, a valid gd resource was expected.
8.0.0 color ahora es nullable.

Ejemplos

Ejemplo #1 Ejemplo con imagecolortransparent()

<?php
// Creación de una imagen de 55x30
$im = imagecreatetruecolor(55, 30);
$red = imagecolorallocate($im, 255, 0, 0);
$black = imagecolorallocate($im, 0, 0, 0);

// Se hace el fondo transparente
imagecolortransparent($im, $black);

// Se dibuja un rectángulo rojo
imagefilledrectangle($im, 4, 4, 50, 25, $red);

// Se guarda la imagen
imagepng($im, './imagecolortransparent.png');
?>

El resultado del ejemplo sería algo similar a:

Visualización del ejemplo: imagecolortransparent()

Notas

Nota:

La transparencia se copia únicamente con la función imagecopymerge() y las imágenes en color verdadero, no con la función imagecopy() ni las imágenes de paleta.

Nota:

La color de transparencia es una propiedad de la imagen, no es una propiedad de la color. Una vez que se ha definido la color de transparencia, cada región de la imagen de esa color que se haya dibujado previamente será transparente.