# imagecolortransparent

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

imagecolortransparent — Definir un color como transparente

### Descripción

imagecolortransparent(resource `$image`, int `$color` = ?): int

Establece el color transparente en `image`.

### 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 creado con imagecolorallocate().

### Valores devueltos

El identificador del nuevo (o actual, si no se especificó nada) color transparente es devuelto. Si `color` no se especifica y la imagen no tiene color transparente, el identificador devuelto será -1.

### Ejemplos

Ejemplo #1 Ejemplo de imagecolortransparent()

`<?php
// Crear una imagen de 55x30
$im = imagecreatetruecolor(55, 30);
$rojo = imagecolorallocate($im, 255, 0, 0);
$negro = imagecolorallocate($im, 0, 0, 0);
// Hacer el fondo transparente
imagecolortransparent($im, $negro);
// Dibujar un rectángulo rojo
imagefilledrectangle($im, 4, 4, 50, 25, $rojo);
// Guardar la imagen
imagepng($im, './imagecolortransparent.png');
imagedestroy($im);
?>`

El resultado del ejemplo sería algo similar a:

### Notas

> Nota:

> La transpariencia se copia sólo con imagecopymerge() y con imágenes de color verdadero, no con imagecopy() o con imágenes de paleta.

> Nota:

> El color transparente es una propiedad de la imagen, la transparencia no es una propiedad del color. Una vez que se ha establecido un color a color transparente, cualquier región de la imagen en ese color que se haya dibujado previamente será transparente.