imagedashedline

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

imagedashedline — Zeichnet eine gestrichelte Linie

Beschreibung

imagedashedline(
    GdImage $image,
    int $x1,
    int $y1,
    int $x2,
    int $y2,
    int $color
): bool

Diese Funktion ist veraltet. Stattdessen sollte eine Kombination von imagesetstyle() und imageline() verwendet werden.

Parameter-Liste

image

Ein GdImage-Objekt, das von einer der Funktionen zur Bilderzeugung, z. B. imagecreatetruecolor(), zurückgegeben wurde.

x1

x-Koordinate des oberen linken Punktes.

y1

y-Koordinate des oberen linken Punktes. 0,0 ist die obere linke Ecke des Bildes.

x2

x-Koordinate des unteren rechten Punktes.

y2

y-Koordinate des unteren rechten Punktes.

color

Die Füllfarbe. 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 imagedashedline()-Beispiel

<?php
// Erzeuge ein 100x100-Bild
$im = imagecreatetruecolor(100, 100);
$white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);

// Zeichne die vertikale gestrichelte Linie
imagedashedline($im, 50, 25, 50, 75, $white);

// Speichere das Bild
imagepng($im, './dashedline.png');
imagedestroy($im);
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Ausgabe des Beispiels: imagedashedline()

Beispiel #2 Alternative zu imagedashedline()

<?php
// Erzeuge ein 100x100-Bild
$im = imagecreatetruecolor(100, 100);
$white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);

// Definiere den gewünschten Stil: die ersten 4 Pixel sind weiß und die
// nächsten 4 sind transparent. Dies erzeugt den Effekt einer gestrichelten Linie
$style = Array(
$white,
$white,
$white,
$white,
IMG_COLOR_TRANSPARENT,
IMG_COLOR_TRANSPARENT,
IMG_COLOR_TRANSPARENT,
IMG_COLOR_TRANSPARENT
);

imagesetstyle($im, $style);

// Zeichne die vertikale gestrichelte Linie
imageline($im, 50, 25, 50, 75, IMG_COLOR_STYLED);

// Speichere das Bild
imagepng($im, './imageline.png');
imagedestroy($im);
?>

Siehe auch