imagedashedline

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

imagedashedlineDraw a dashed line

Description

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

This function is deprecated. Use combination of imagesetstyle() and imageline() instead.

Parameters

image

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

x1

Upper left x coordinate.

y1

Upper left y coordinate 0, 0 is the top left corner of the image.

x2

Bottom right x coordinate.

y2

Bottom right y coordinate.

color

The fill 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 imagedashedline() example

<?php// Create a 100x100 image$im = imagecreatetruecolor(100, 100);$white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);// Draw a vertical dashed lineimagedashedline($im, 50, 25, 50, 75, $white);// Save the imageimagepng($im, './dashedline.png');imagedestroy($im);?>

The above example will output something similar to:

Output of example : imagedashedline()

Example #2 Alternative to imagedashedline()

<?php// Create a 100x100 image$im = imagecreatetruecolor(100, 100);$white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);// Define our style: First 4 pixels is white and the // next 4 is transparent. This creates the dashed line effect$style = Array(                $white,                 $white,                 $white,                 $white,                 IMG_COLOR_TRANSPARENT,                 IMG_COLOR_TRANSPARENT,                 IMG_COLOR_TRANSPARENT,                 IMG_COLOR_TRANSPARENT                );imagesetstyle($im, $style);// Draw the dashed lineimageline($im, 50, 25, 50, 75, IMG_COLOR_STYLED);// Save the imageimagepng($im, './imageline.png');imagedestroy($im);?>

See Also