imagecolorset

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

imagecolorset — Define a cor para o índice da paleta especificado

Descrição

imagecolorset(
    GdImage $image,
    int $color,
    int $red,
    int $green,
    int $blue,
    int $alpha = 0
): ?false

Esta função atribui a cor especificada ao índice especificado na paleta. Isto é útil para criar efeitos de preenchimento em imagens de paleta sem a sobrecarga de realizar verdadeiramente o preenchimento.

Parâmetros

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

Um índice na paleta.

red

Valor do componente vermelho.

green

Valor do componente verde.

blue

Valor do componente azul.

alpha

Valor do componente alfa.

Valor Retornado

A função retorna null em caso de sucesso, ou false em caso de falha.

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 imagecolorset()

<?php
// Cria uma imagem 300x100
$im = imagecreate(300, 100);

// Define o plano de fundo para vermelho
imagecolorallocate($im, 255, 0, 0);

// Obtém o índice de cor para o plano de fundo
$bg = imagecolorat($im, 0, 0);

// Define o plano de fundo para azul
imagecolorset($im, $bg, 0, 0, 255);

// Mostra a imagem no navegador
header('Content-Type: image/png');

imagepng($im);
?>

Veja Também