PHP 8.3.4 Released!

imagedashedline

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

imagedashedlineDibujar una línea discontinua

Descripción

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

Esta función esta obsoleta. Use una combinación de imagesetstyle() y imageline() en su lugar.

Parámetros

image

Un recurso image, es devuelto por una de las funciones de creación de imágenes, como imagecreatetruecolor().

x1

Coordenada x superior izquierda.

y1

Coordenada y superior izquierda 0, 0 es la esquina superior izquierda de la imagen.

x2

Coordenada x inferior derecha.

y2

Coordenada y inferior derecha.

color

El color de relleno. Un identificador de color creado con imagecolorallocate().

Valores devueltos

Siempre devuelve true

Ejemplos

Ejemplo #1 Ejemplo de imagedashedline()

<?php
// Crear una imagen de 100x100
$im = imagecreatetruecolor(100, 100);
$blanco = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);

// Dibujar una línea discontinua vertical
imagedashedline($im, 50, 25, 50, 75, $blanco);

// Guardar la imagen
imagepng($im, './linea_dis.png');
imagedestroy($im);
?>

El resultado del ejemplo sería algo similar a:

Salida del ejemplo : imagedashedline()

Ejemplo #2 Alternativa a imagedashedline()

<?php
// Crear una imagen de 100x100
$im = imagecreatetruecolor(100, 100);
$blanco = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);

// Definir nuestro estilo: Los primeros 4 píxeles son blancos y los
// 4 siguientes son transparentes. Esto crea el efecto de línea discontinua
$estilo = Array(
$blanco,
$blanco,
$blanco,
$blanco,
IMG_COLOR_TRANSPARENT,
IMG_COLOR_TRANSPARENT,
IMG_COLOR_TRANSPARENT,
IMG_COLOR_TRANSPARENT
);

imagesetstyle($im, $estilo);

// Dibujar la línea discontinua
imageline($im, 50, 25, 50, 75, IMG_COLOR_STYLED);

// Guardar la imagen
imagepng($im, './imageline.png');
imagedestroy($im);
?>

Ver también

add a note

User Contributed Notes 5 notes

up
1
tgabor72 at freemail dot hu
13 years ago
You can use the imagepatternedline() function with extra features instead of imagedashedline() to give a visible dashedlines and other any kind of patterned lines on your images. The routine also manages the thickness of the line. Have fun!

<?php
// imagepatternedline() function
// Routine was developed to draw any kind of straight line with thickness. Routine uses imageline() function to draw line.
// Parameters are (similar to imageline() function):
// $image: (resource) imagefile
// $xstart, $ystart: (int) x,y coordinates for first point
// $xend, $yend: (int) x,y coordinates for last point
// $color: (int) color identifier that created with imagecolorallocate()
// extra parameters:
// $thickness: (int) thickness of line in pixel
// $pattern: (string) pattern of line, which repeats continuously while line is being drawed.
// If there is '1' in the pattern that means the actual dot of line is visible,
// '0' means dot is not visible (space between two line elements).
// All characters regard for one pixel. Default: 1 dot wide dashed line with 4-4 dots and spaces.
// Examples for pattern:
// "1" or "" continuous line
// "10" close dotline
// "10000" dotline
// "111111110000001100000011111111" dotline for design drawing
// "111111111100000011000000110000001111111111" double dotline
// some examples for using imagepatternedline():
// imagepatternedline($image,300,300,442,442,$color,200,""); // a square with 200 length of edge and rotated 45 degrees
// imagepatternedline($image,100,200,289,200,$color,100,
// "11001100000011001111000011001111110000001100001100"
// ."00001111001100111100000011000000110000110011001100"
// ."11000011111100111111000011001111001111000011110000"
// ."1111001111110011000011000000001100110011"); // barcode

function imagepatternedline($image, $xstart, $ystart, $xend, $yend, $color, $thickness=1, $pattern="11000011") {
$pattern=(!strlen($pattern)) ? "1" : $pattern;
$x=$xend-$xstart;
$y=$yend-$ystart;
$length=floor(sqrt(pow(($x),2)+pow(($y),2)));
$fullpattern=$pattern;
while (
strlen($fullpattern)<$length) $fullpattern.=$pattern;
if (!
$length) {
if (
$fullpattern[0]) imagefilledellipse($image, $xstart, $ystart, $thickness, $thickness, $color);
return;
}
$x1=$xstart;
$y1=$ystart;
$x2=$x1;
$y2=$y1;
$mx=$x/$length;
$my=$y/$length;
$line="";
for(
$i=0;$i<$length;$i++){
if (
strlen($line)==0 or $fullpattern[$i]==$line[0]) {
$line.=$fullpattern[$i];
}else{
$x2+=strlen($line)*$mx;
$y2+=strlen($line)*$my;
if (
$line[0]) imageline($image, round($x1), round($y1), round($x2-$mx), round($y2-$my), $color);
$k=1;
for(
$j=0;$j<$thickness-1;$j++) {
$k1=-(($k-0.5)*$my)*(floor($j*0.5)+1)*2;
$k2= (($k-0.5)*$mx)*(floor($j*0.5)+1)*2;
$k=1-$k;
if (
$line[0]) {
imageline($image, round($x1)+$k1, round($y1)+$k2, round($x2-$mx)+$k1, round($y2-$my)+$k2, $color);
if (
$y) imageline($image, round($x1)+$k1+1, round($y1)+$k2, round($x2-$mx)+$k1+1, round($y2-$my)+$k2, $color);
if (
$x) imageline($image, round($x1)+$k1, round($y1)+$k2+1, round($x2-$mx)+$k1, round($y2-$my)+$k2+1, $color);
}
}
$x1=$x2;
$y1=$y2;
$line=$fullpattern[$i];
}
}
$x2+=strlen($line)*$mx;
$y2+=strlen($line)*$my;
if (
$line[0]) imageline($image, round($x1), round($y1), round($xend), round($yend), $color);
$k=1;
for(
$j=0;$j<$thickness-1;$j++) {
$k1=-(($k-0.5)*$my)*(floor($j*0.5)+1)*2;
$k2= (($k-0.5)*$mx)*(floor($j*0.5)+1)*2;
$k=1-$k;
if (
$line[0]) {
imageline($image, round($x1)+$k1, round($y1)+$k2, round($xend)+$k1, round($yend)+$k2, $color);
if (
$y) imageline($image, round($x1)+$k1+1, round($y1)+$k2, round($xend)+$k1+1, round($yend)+$k2, $color);
if (
$x) imageline($image, round($x1)+$k1, round($y1)+$k2+1, round($xend)+$k1, round($yend)+$k2+1, $color);
}
}
}
?>
up
1
ProfessorNeo at gmx dot de
18 years ago
The bug reported by 'michi at marel dot at' also exists in PHP version 5.1.1. This functions just works with vertical lines!
up
0
ihsanduvac at gmail dot com
11 years ago
It doesn't work for horizontal lines. Use imagesetstyle()
up
0
alien-scripts.de
18 years ago
I make my own dashedline:

<?
for($l=50;$l<=550;$l+=5)
{
if($da == 0) { $da = 1; }
elseif($da == 1){
imageline($bild,$l,50,$l+5,50,$green);
$da = 0; }
}
?>

$l is the x-value
and we have a dashed line :)
up
-1
michi at marel dot at
20 years ago
There's a bug till PHP 4.0.4 in this function. You can only draw vertical dashed lines. To draw other dashed lines you can set <ImageSetStyle> to a special dashed line and draw it by <ImageLine>.

Sample code:
<?php
function MDashedLine($image, $x0, $y0, $x1, $y1, $fg, $bg)
{
$st = array($fg, $fg, $fg, $fg, $bg, $bg, $bg, $bg);
ImageSetStyle($image, $st);
ImageLine($image, $x0, $y0, $x1, $y1, IMG_COLOR_STYLED);
}
?>
To Top