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ãoDescrição
    8.0.0 O parâmetro image agora espera uma instância de GdImage; anteriormente, um resourcegd 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

    To Top