imagesetpixel

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

imagesetpixel — Setzt ein einzelnes Pixel

Beschreibung

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

imagesetpixel() zeichnet ein Pixel an der angegebenen Koordinate.

Parameter-Liste

image: Ein GdImage-Objekt, das von einer der Funktionen zur Bilderzeugung, z. B. imagecreatetruecolor(), zurückgegeben wurde.
x: x-Koordinate
y: y-Koordinate
color: Eine Farbkennung, die mit imagecolorallocate() erzeugt wurde.

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

Changelog

Version	Beschreibung
8.0.0	`image` erwartet nun eine GdImage-Instanz; vorher wurde eine gültige `gd`-Ressource erwartet.

Beispiele

Beispiel #1 imagesetpixel()-Beispiel

Eine zufällige Zeichnung, die mit einem normalen Bild endet.

<?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);

?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Siehe auch

imagecreatetruecolor() - Create a new true color image
imagecolorallocate() - Alloziert eine Farbe für eine Grafik
imagecolorat() - Liefert den Farbwert eines Bildpunktes