# imagecolorallocate

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

imagecolorallocate — Asigna un color para una imagen

### Descripción

imagecolorallocate(
resource `$image`,
int `$red`,
int `$green`,
int `$blue`
): int

Devuelve un identificador de color representando el color compuesto por los componentes RGB dados.

imagecolorallocate() debe ser llamada para crear cada color que va a ser usado en la imagen representada por `image`.

> Nota:

> La primera llamada a imagecolorallocate() rellena el color de fondo en imágenes basadas en paleta de colores - imágenes creadas usando imagecreate().

### Parámetros

`image`

  Un recurso image, es devuelto 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.

Estos parámetros son enteros entre 0 y 255 o hexadecimales entre 0x00 y 0xFF.

### Valores devueltos

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

Advertencia

Esta función puede devolver el valor booleano `false`, pero también puede devolver un valor no booleano que se evalúa como `false`. Por favor lea la sección sobre Booleanos para más información. Use el operador === para comprobar el valor devuelto por esta función.

### Historial de cambios

Versión | Descripción
--- | ---
5.1.3 | Devuelve `false` si falló la asignación. Anteriormente devolvía `-1`.

### Ejemplos

Ejemplo #1 Ejemplo de imagecolorallocate()

`<?php
$im = imagecreate(100, 100);
// establece el fondo a rojo
$fondo = imagecolorallocate($im, 255, 0, 0);
// establece más colores
$blanco = imagecolorallocate($im, 255, 255, 255);
$negro = imagecolorallocate($im, 0, 0, 0);
// forma hexadecimal
$blanco = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
$negro = imagecolorallocate($im, 0x00, 0x00, 0x00);
?>`

### Ver también

- imagecolorallocatealpha() - Asignar un color para una imagen
- imagecolordeallocate() - Desasignar un color de una imagen