array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.imagecolorallocate.php', 1 => 'imagecolorallocate', ), 'up' => array ( 0 => 'ref.image.php', 1 => 'Funções de GD e Image', ), 'prev' => array ( 0 => 'function.imagecharup.php', 1 => 'imagecharup', ), 'next' => array ( 0 => 'function.imagecolorallocatealpha.php', 1 => 'imagecolorallocatealpha', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/image/functions/imagecolorallocate.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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().
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.
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
?>