# imagedashedline

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

imagedashedline — Dessine une ligne pointillée

### Description

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

imagedashedline() est obsolète. Utilisez plutôt une combinaison des fonctions imagesetstyle() et imageline().

### Liste de paramètres

`image`

  Un objet GdImage, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().

`x1`

  Coordonnée en X : En haut, à gauche.

`y1`

  Coordonnée en Y : En haut, à gauche. 0 est le coin en haut à gauche de l'image.

`x2`

  Coordonnée en X : En bas, à droite.

`y2`

  Coordonnée en Y : En bas, à droite.

`color`

  La couleur de remplissage. Un identificateur de couleur créé avec imagecolorallocate().

### Valeurs de retour

Cette fonction retourne `true` en cas de succès ou `false` si une erreur survient.

### Historique

Version | Description
--- | ---
8.0.0 | `image` attend une instance de GdImage désormais; auparavant, une resource `gd` était attendue.

### Exemples

Exemple #1 Exemple avec imagedashedline()

`<?php
// Crée une image de 100x100 pixels
$im = imagecreatetruecolor(100, 100);
$white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
// Dessine une ligne verticale en pointillé
imagedashedline($im, 50, 25, 50, 75, $white);
// Sauvegarde l'image
imagepng($im, './dashedline.png');
?>`

Résultat de l'exemple ci-dessus est similaire à :

Exemple #2 Alternative à la fonction imagedashedline()

`<?php
// Crée une image de 100x100 pixels
$im = imagecreatetruecolor(100, 100);
$white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
// Définit le style : Les 4 premiers pixels sont blancs et les 4 suivants
// sont transparents. Ceci va créer l'effet de pointillé
$style = Array(
$white,
$white,
$white,
$white,
IMG_COLOR_TRANSPARENT,
IMG_COLOR_TRANSPARENT,
IMG_COLOR_TRANSPARENT,
IMG_COLOR_TRANSPARENT
);
imagesetstyle($im, $style);
// Dessine la ligne pointillée
imageline($im, 50, 25, 50, 75, IMG_COLOR_STYLED);
// Sauvegarde de l'image
imagepng($im, './imageline.png');
?>`

### Voir aussi

- imagesetstyle() - Configure le style pour le dessin des lignes
- imageline() - Dessine une ligne