imagecolorallocatealpha

imagecolorallocatealpha(GdImage $image, int $red, int $green, int $blue, int $alpha): int
```php

`imagecolorallocatealpha` se comporta como `imagecolorallocate` con el parámetro adicional de transparencia `alpha`.

## Parámetros

`image`  
Un objeto `GdImage`, retornado por una de las funciones de creación de imágenes, como `imagecreatetruecolor`.

`red`  
Valor del componente rojo.

`green`  
Valor del componente verde.

`blue`  
Valor del componente azul.

`alpha`  
Un valor entre `0` y `127`. `0` indica opacidad completa mientras que `127` indica transparencia completa.

Los parámetros `red`, `green` y `blue` son enteros comprendidos entre 0 y 255, o hexadecimales comprendidos entre 0x00 y 0xFF.

## Valores devueltos

Un identificador de color o `false` si la asignación falla.

> [!WARNING]
> Esta función puede retornar `false`, pero también puede retornar un valor equivalente a `false`. Por favor, lea la sección sobre los [booleanos](#language.types.boolean) para más información. Utilice el [operador ===](#language.operators.comparison) para probar el valor de retorno exacto de esta función.

## 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. |

## Ejemplos

Ejemplo de uso de `imagecolorallocatealpha`

Resultado del ejemplo anterior es similar a:

![Salida del ejemplo: imagecolorallocatealpha()](en/reference/image/figures/imagecolorallocatealpha.png)

Conversión de valor alpha típico para usarlo con `imagecolorallocatealpha`

Generalmente los valores alpha `0` designan los píxeles completamente transparentes, y el canal alpha tiene 8 bits. Para convertir tales valores alpha para ser compatibles con `imagecolorallocatealpha`, un poco de aritmética simple es suficiente:

int(127)
int(0)