imagesetstyle

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

imagesetstyle — Establecer el estilo para el dibujo de líneas

Descripción

imagesetstyle(resource $image, array $style): bool

imagesetstyle() establece el estilo para ser usado por todas las funciones de dibujo de líneas (como imageline() y imagepolygon()) cuando se dibuja con el color especial IMG_COLOR_STYLED o líneas de imágenes con el color IMG_COLOR_STYLEDBRUSHED.

Parámetros

image: Un recurso image, es devuelto por una de las funciones de creación de imágenes, como imagecreatetruecolor().
style: Una matriz de colores de píxel. Se puede usar la constante IMG_COLOR_TRANSPARENT para añadir un píxel transparente. Observe que style no debe ser un array vacío.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Ejemplos

El siguiente script de ejemplo dibuja una línea discontinua desde la esquina superior izquierda a la esquina inferior derecha del lienzo:

Ejemplo #1 Ejemplo de imagesetstyle()

<?php
header("Content-type: image/jpeg");
$im  = imagecreatetruecolor(100, 100);
$b   = imagecolorallocate($im, 255, 255, 255);
$rojo = imagecolorallocate($im, 255, 0, 0);

/* Dibujar una línea discontinua, 5 píxeles rojos, 5 píxeles blancos */
$estilo = array($rojo, $rojo, $rojo, $rojo, $rojo, $b, $b, $b, $b, $b);
imagesetstyle($im, $estilo);
imageline($im, 0, 0, 100, 100, IMG_COLOR_STYLED);

/* Dibujar una línea de caras felices usando imagesetbrush() con imagesetstyle */
$estilo = array($b, $b, $b, $b, $b, $b, $b, $b, $b, $b, $b, $b, $rojo);
imagesetstyle($im, $estilo);

$pincel = imagecreatefrompng("http://www.libpng.org/pub/png/images/smile.happy.png");
$b2 = imagecolorallocate($pincel, 255, 255, 255);
imagecolortransparent($pincel, $b2);
imagesetbrush($im, $pincel);
imageline($im, 100, 0, 0, 100, IMG_COLOR_STYLEDBRUSHED);

imagejpeg($im);
imagedestroy($im);
?>

El resultado del ejemplo sería algo similar a:

Ver también

imagesetbrush() - Establecer la imagen de pincel para el dibujo de líneas
imageline() - Dibujar una línea

add a note

User Contributed Notes 7 notes

down

Michael_Todd_335 at yahoo dot com ¶

17 years ago


Watch out! If you pass imagesetstyle() an empty array as the second argument, it will crash your server!
I was messing with it just earlier and accidentally did so, and the page took a good minute to process, when my Apache server came up with the good ol' Windows 'Send Error Report' window.

down

dazbert ¶

7 years ago


To clarify, for lines where the thickness is greater than 1, the total length of the $style array needs to be an exact divisor of the length of the line.

This is because the pattern is repeated lengthways and wraps onto the second row of pixels, causing staggering to occur.

So if you have 5 red and 5 white pixels, and you want a line length of 55 pixels, either change the length to a multiple of 10, or change the dashes to, say, 6 red and 5 white.

down

-1

Wander ¶

17 years ago


Function to make a line with random fading:

<?php
    function fading_line($img,$sx,$sy,$ex,$ey){
        $r=rand(0,5);$g=rand(0,5);$b=rand(0,5);
        $l=sqrt((($ex-$sx)*($ex-$sx))+(($ey-$sy)*($ey-$sy)));
        for($i=0;$i<$l;$i++){
            $a = array(255-((255/$l)*$i), 255,0,(255/$l)*$i/2,(255/$l)*$i,(255-((255/$l)*$i))/2);
            $style[]=imagecolorallocate($img,$a[$r],$a[$g],$a[$b]);
        }
        imagesetstyle($img,$style);
        imageline($img,$sx,$sy,$ex,$ey,IMG_COLOR_STYLED);
    }
    
    fading_line($img,10,20,490,40);    // image, start x, start y, end x, end y
?>

down

-1

Cruz at FtUC dot net ¶

18 years ago


When lines drawn with imagesetstyle seem to produce a thin white line only, make sure antialiasing is disabled.

<?
  imageantialias($im, false);
  $style = array($gridxcolor, $gridxcolor, IMG_COLOR_TRANSPARENT, IMG_COLOR_TRANSPARENT);
  imagesetstyle($im, $style);
  imageline($im, $x, 0, $x, $ymax+5, IMG_COLOR_STYLED);
  imageantialias($im, true);
?>

Setstyle and Antialias don't go together.

down

-1

Anonymous ¶

12 years ago


a shortcut for basic dashed lines, making it easy to adjust the lengths:

<?php

$length1 = 20;
$length2 = 10;
$style = array_merge(array_fill(0, $length1, $red), array_fill(0, $length2, $w));
imagesetstyle($im, $style);

?>

down

-2

php at imperium dot be ¶

14 years ago


Be aware that styles are applied towards the width of the line instead of linear.

To convert a style to be used for thick lines you can use the function below:



<?php

/*

ImageStyleThicken(<aStyle>,<iThickness>) --> <aThickStyle>



<aStyle> is the style array for a thickness of 1 (see imagesetstyle()).

<iThickness> is the new thickness to apply (see imagesetthickness()).



<aThickStyle> is the style array suitable for the given thickness.

*/

function ImageStyleThicken($_1,$_2) {

    $a = array();

    foreach ($_1 as $x) {

        $i = $_2;

        do $a[] = $x; while (--$i>0); }

    return $a;

}

?>

down

-1

zackbloom at gmail dot com ¶

19 years ago


Use this to set the style to any combination of pixels.
You can pass as many modifiers as you wish.
Use the format [num]r[red]g[green]b[blue].

For example:

$im=dashed($im,"4r255g0b0","2r0g255b0","5r0g0b255");
imageline($im, 0, 0, 600, 600, IMG_COLOR_STYLED);

function dashed($im){
$size = func_num_args();
for($i = 0; $i < $size; $i++){
$arg = func_get_arg($i);
if(!is_resource($arg)){
$r=substr($arg,strpos($arg,"r")+1,
strpos($arg,"g")-strpos($arg,"r")-1);
$g=substr($arg,strpos($arg,"g")+1,
strpos($arg,"b")-strpos($arg,"g")-1);
$b=substr($arg,strpos($arg,"b")+1,
strlen($arg)-strpos($arg,"b"));
$color = imagecolorallocate($im,$r,$g,$b);
$x = substr($arg,0,strpos($arg,"r"));
$vals[$i] = array_fill(0,$x,$color);
}
}
for($k=0;$k<count($vals)+1;$k++)
if(array_key_exists($k,$vals)) $prop=array_merge($prop,$vals[$k]);
imagesetstyle($im, $prop);
return $im;
}

add a note