imagecolorallocate

Allocate a color for an image

&reftitle.description; `int` `imagecolorallocate` `resource` `image` `int` `red` `int` `green` `int` `blue`

Returns a color identifier representing the color composed of the given RGB components.

`imagecolorallocate` must be called to create each color that is to be used in the image represented by `image`.

The first call to `imagecolorallocate` fills the background color in palette-based images - images created using `imagecreate`.

&reftitle.parameters;

&gd.image.description;

`red`

- &gd.value.red;

`green`

- &gd.value.green;

`blue`

- &gd.value.blue;

These parameters are integers between 0 and 255 or hexadecimals between 0x00 and 0xFF.
&reftitle.returnvalues;

A color identifier or &false; if the allocation failed.

&return.falseproblem;
&reftitle.changelog;

&Version; | &Description;
5.1.3 | Returns &false; if the allocation failed. Previously `-1` was returned.

&reftitle.examples;

### `imagecolorallocate` example

    <?php

    $im = imagecreate(100, 100);

    // sets background to red
    $background = imagecolorallocate($im, 255, 0, 0);

    // sets some colors
    $white = imagecolorallocate($im, 255, 255, 255);
    $black = imagecolorallocate($im, 0, 0, 0);

    // hexadecimal way
    $white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
    $black = imagecolorallocate($im, 0x00, 0x00, 0x00);

    ?>

&reftitle.seealso;

- `imagecolorallocatealpha`
- `imagecolordeallocate`