imagecolorset
(PHP 4, PHP 5, PHP 7, PHP 8)
imagecolorset — Set the color for the specified palette index
Description
This sets the specified index in the palette to the specified color. This is useful for creating flood-fill-like effects in palleted images without the overhead of performing the actual flood-fill.
Parameters
-
image
-
A GdImage object, returned by one of the image creation functions, such as imagecreatetruecolor().
-
color
-
An index in the palette.
-
red
-
Value of red component.
-
green
-
Value of green component.
-
blue
-
Value of blue component.
-
alpha
-
Value of alpha component.
Return Values
The function returns null
on success, or false
on failure.
Changelog
Version | Description |
---|---|
8.0.0 |
image expects a GdImage
instance now; previously, a resource was expected.
|
Examples
Example #1 imagecolorset() example
<?php
// Create a 300x100 image
$im = imagecreate(300, 100);
// Set the background to be red
imagecolorallocate($im, 255, 0, 0);
// Get the color index for the background
$bg = imagecolorat($im, 0, 0);
// Set the backgrund to be blue
imagecolorset($im, $bg, 0, 0, 255);
// Output the image to the browser
header('Content-Type: image/png');
imagepng($im);
imagedestroy($im);
?>
See Also
- imagecolorat() - Get the index of the color of a pixel