imagecolorallocate

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

imagecolorallocate — Aloca uma cor para uma imagem

Descrição

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 identificadore 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