Documentación offline PHP master

imagecolortransparent

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

imagecolortransparent

Define la color transparente

Descripción#

imagecolortransparent(GdImage $image, [int $color]): int
```php

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 recurso `gd` de tipo `resource` válido. |
| 8.0.0 | `color` ahora es nullable. |

## Ejemplos

Ejemplo con `imagecolortransparent`

```php

Resultado del ejemplo anterior es similar a:

Visualización del ejemplo: imagecolortransparent()

Notas#

[!NOTE] 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.

[!NOTE] 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.