Draw a dashed line

- « imagecropauto

- imagedestroy »

- PHP Manual
- GD and Image Functions
- Draw a dashed line

# imagedashedline

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

imagedashedline — Draw 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 line
    imagedashedline($im, 50, 25, 50, 75, $white);

    // Save the image
    imagepng($im, './dashedline.png');
    imagedestroy($im);
    ?>

The above example will output something similar to:

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 line
    imageline($im, 50, 25, 50, 75, IMG_COLOR_STYLED);

    // Save the image
    imagepng($im, './imageline.png');
    imagedestroy($im);
    ?>

### See Also

- imagesetstyle() - Set the style for line drawing
- imageline() - Draw a line