imagearc

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

imagearc — Zeichnet einen Bogen

Beschreibung

imagearc(
    GdImage$image,
    int$center_x,
    int$center_y,
    int$width,
    int$height,
    int$start_angle,
    int$end_angle,
    int$color
): bool

imagearc() zeichnet einen Kreisbogen um den angegebenen Mittelpunkt

Parameter-Liste

image: Ein GdImage-Objekt, das von einer der Funktionen zur Bilderzeugung, z. B. imagecreatetruecolor(), zurückgegeben wurde.
center_x: x-Koordinate des Mittelpunkts
center_y: y-Koordinate des Mittelpunkts
width: Die Breite der Ellipse
height: Die Höhe der Ellipse
start_angle: Der Startwinkel des Bogens, in Grad.
end_angle: Der Endwinkel des Bogens, in Grad. 0° liegt in der Drei-Uhr-Position und der Bogen wird im Uhrzeigersinn gezeichnet.
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 Zeichnen eines Kreises mittels imagearc()

<?php

// eine 200*200-Grafik erstellen
$img = imagecreatetruecolor(200, 200);

// Farben vorbereiten
$white = imagecolorallocate($img, 255, 255, 255);
$red = imagecolorallocate($img, 255, 0, 0);
$green = imagecolorallocate($img, 0, 255, 0);
$blue = imagecolorallocate($img, 0, 0, 255);

// Kopf
imagearc($img, 100, 100, 200, 200, 0, 360, $white);
// Mund
imagearc($img, 100, 100, 150, 150, 25, 155, $red);
// Augen
imagearc($img, 60, 75, 50, 50, 0, 360, $green);
imagearc($img, 140, 75, 50, 50, 0, 360, $blue);

// Ausgabe im Browser
header("Content-type: image/png");
imagepng($img);

// Speicher freigeben
imagedestroy($img);

?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Ausgabe des Beispiels: Zeichnen eines Kreises mittels imagearc()

Siehe auch

imagefilledarc() - Draw a partial arc and fill it
imageellipse() - Draw an ellipse
imagefilledellipse() - Draw a filled ellipse