imagearc

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

imagearc — Desenha um arco

Descrição

imagearc(
    GdImage $image,
    int $center_x,
    int $center_y,
    int $width,
    int $height,
    int $start_angle,
    int $end_angle,
    int $color
): bool

imagearc() desenha um arco de círculo centrado nas coordenadas fornecidas.

Parâmetros

image

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

center_x

Coordenada x do centro.

center_y

Coordenada y do centro.

width

Largura do arco.

height

Altura do arco.

start_angle

Ângulo inicial do arco, em graus.

end_angle

Ângulo final do arco, em graus. 0° está localizado na posição de 3 horas, e o arco é desenhado no sentido horário.

color

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 Desenhando um círculo com imagearc()

<?php

// cria uma imagem 200x200
$img = imagecreatetruecolor(200, 200);

// aloca algumas cores
$white = imagecolorallocate($img, 255, 255, 255);
$red   = imagecolorallocate($img, 255,   0,   0);
$green = imagecolorallocate($img,   0, 255,   0);
$blue  = imagecolorallocate($img,   0,   0, 255);

// desenha a cabeça
imagearc($img, 100, 100, 200, 200,  0, 360, $white);
// boca
imagearc($img, 100, 100, 150, 150, 25, 155, $red);
// olho esquerdo e olho direito
imagearc($img,  60,  75,  50,  50,  0, 360, $green);
imagearc($img, 140,  75,  50,  50,  0, 360, $blue);

// mostra a imagem no navegador
header("Content-type: image/png");
imagepng($img);

// libera a memória
imagedestroy($img);

?>

O exemplo acima produzirá algo semelhante a:

Saída do exemplo: Desenhando um círculo com imagearc()

Veja Também