(PHP 4, PHP 5, PHP 7, PHP 8)
imagecolorallocate — Aloca uma cor para uma imagem
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().
imageUm objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().
redValor do componente vermelho.
greenValor do componente verde.
blueValor do componente azul.
Um identificadore de cor ou false se a alocação falhar.
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.
| 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.
|
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
?>