imagesetpixel

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

imagesetpixelSet a single pixel

Description

imagesetpixel(
    GdImage $image,
    int $x,
    int $y,
    int $color
): bool

imagesetpixel() draws a pixel at the specified coordinate.

Parameters

image

A GdImage object, returned by one of the image creation functions, such as imagecreatetruecolor().

x

x-coordinate.

y

y-coordinate.

color

A color identifier created with imagecolorallocate().

Return Values

Returns true on success or false on failure.

Changelog

Version Description
8.0.0 image expects a GdImage instance now; previously, a valid gd resource was expected.

Examples

Example #1 imagesetpixel() example

A random drawing that ends with a regular picture.

<?php$x = 200;$y = 200;$gd = imagecreatetruecolor($x, $y); $corners[0] = array('x' => 100, 'y' =>  10);$corners[1] = array('x' =>   0, 'y' => 190);$corners[2] = array('x' => 200, 'y' => 190);$red = imagecolorallocate($gd, 255, 0, 0); for ($i = 0; $i < 100000; $i++) {  imagesetpixel($gd, round($x), round($y), $red);  $a = rand(0, 2);  $x = ($x + $corners[$a]['x']) / 2;  $y = ($y + $corners[$a]['y']) / 2;} header('Content-Type: image/png');imagepng($gd);?>

The above example will output something similar to:

Output of example : imagesetpixel()

See Also