Asigna una coloración para una imagen

# imagecolorallocate

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

imagecolorallocate — Asigna una coloración para una imagen

### Descripción

function imagecolorallocate(
GdImage `$image`,
int `$red`,
int `$green`,
int `$blue`
): int|false

Devuelve un identificador de color, representando la coloración compuesta con los colores RGB.

imagecolorallocate() debe ser invocada para crear cada color que será representado por `image`.

> Nota:

> La primera llamada a imagecolorallocate() llena la coloración de fondo con la paleta de las imágenes - imágenes creadas utilizando imagecreate().

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

Estos argumentos 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.

Advertencia

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 para más información. Utilice el operador === 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 resource `gd` válido.

### Ejemplos

Ejemplo #1 Ejemplo con imagecolorallocate()

    <?php

    $im = imagecreate(100, 100);

    // El fondo de la imagen es rojo
    $background = imagecolorallocate($im, 255, 0, 0);

    // Se definen colores con enteros ..
    $white = imagecolorallocate($im, 255, 255, 255);
    $black = imagecolorallocate($im, 0, 0, 0);

    // .. o hexadecimales
    $white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
    $black = imagecolorallocate($im, 0x00, 0x00, 0x00);

    ?>

### Ver también

- imagecolorallocatealpha() - Asigna un color a una imagen
- imagecolordeallocate() - Elimina un color de una imagen

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open