imagecolortransparent

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

imagecolortransparent — Define 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 objeto GdImage, retornado por una de las funciones de creación de imágenes, como imagecreatetruecolor().
color: Un identificador de color creado 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` ahora espera una instancia de GdImage; anteriormente, se esperaba un resource `gd` válido.
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');
?>

Resultado del ejemplo anterior es similar a:

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.