imagedashedline

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

imagedashedline — Desenha uma linha tracejada

Descrição

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

Esta função foi descontinuada. Use uma combinação de imagesetstyle() e imageline() em seu lugar.

Parâmetros

image

Um objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().

x1

Coordenada x do ponto inicial.

y1

Coordenada y do ponto inicial. 0, 0 é o canto superior esquerdo da imagem.

x2

Coordenada x do ponto final.

y2

Coordenada y do ponto final.

color

A cor de preenchimento. Um identificador de cor criado com imagecolorallocate().

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Registro de Alterações

Versão Descrição
8.0.0 O parâmetro image agora espera uma instância de GdImage; anteriormente, um resource gd válido era esperado.

Exemplos

Example #1 Exemplo de imagedashedline()

<?php
// Cria uma imagem 100x100
$im = imagecreatetruecolor(100, 100);
$white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);

// Desenha uma linha tracejada vertical
imagedashedline($im, 50, 25, 50, 75, $white);

// Grava a imagem
imagepng($im, './dashedline.png');
imagedestroy($im);
?>

O exemplo acima produzirá algo semelhante a:

Saída do exemplo: imagedashedline()

Example #2 Alternativa a imagedashedline()

<?php
// Cria uma imagem 100x100
$im = imagecreatetruecolor(100, 100);
$white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);

// Define o estilo: primeiros 4 pixels brancos e os 4
// seguintes transparentes. Isto cria o efeito tracejado.
$style = Array(
                $white,
                $white,
                $white,
                $white,
                IMG_COLOR_TRANSPARENT,
                IMG_COLOR_TRANSPARENT,
                IMG_COLOR_TRANSPARENT,
                IMG_COLOR_TRANSPARENT
                );

imagesetstyle($im, $style);

// Desenha a linha tracejada
imageline($im, 50, 25, 50, 75, IMG_COLOR_STYLED);

// Grava a imagem
imagepng($im, './imageline.png');
imagedestroy($im);
?>

Veja Também