Aloca uma cor para uma imagem

# imagecolorallocate

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

imagecolorallocate — Aloca uma cor para uma imagem

### Descrição

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

Retorna um identificador de cor representando a cor composta pelos componentes RGB.

imagecolorallocate() precisa ser chamada para criar cada cor que será usada na imagem representada por `image`.

> Nota:

> A primeira chamada a imagecolorallocate() preenche a cor de fundo em imagens com base em paletas - imagens criadas usando imagecreate().

### Parâmetros

`image`
  Um objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().
`red`

  Valor do componente vermelho.

`green`

  Valor do componente verde.

`blue`

  Valor do componente azul.

Estes parâmetros são inteiros entre 0 e 255 ou hexadecimais entre 0x00 e 0xFF.

### Valor Retornado

Um identificador de cor ou `false` se a alocação falhar.

Aviso

Esta função pode retornar o valor booleano `false`, mas também pode retornar um valor não booleano que pode ser avaliado como `false`. Leia a seção sobre Booleanos para mais informações. Use o operador === para testar o valor retornado por esta função.

### Registro de Alterações

Versão | Descrição
--- | ---
8.0.0 | O parâmetro `image` agora espera uma instância de GdImage; anteriormente, um resource `gd` válido era esperado.

### Exemplos

Exemplo #1 Exemplo de imagecolorallocate()

    <?php

    $im = imagecreate(100, 100);

    // define a cor de fundo para vermelha
    $background = imagecolorallocate($im, 255, 0, 0);

    // define algumas cores
    $white = imagecolorallocate($im, 255, 255, 255); //branca
    $black = imagecolorallocate($im, 0, 0, 0); //preta

    // com hexadecimais
    $white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF); //branca
    $black = imagecolorallocate($im, 0x00, 0x00, 0x00); //preta

    ?>

### Veja Também

- imagecolorallocatealpha() - Aloca uma cor para uma imagem
- imagecolordeallocate() - Desaloca uma cor de uma imagem

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