imagepolygon

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

imagepolygon — Desenha um polígono

Descrição

Assinatura a partir do PHP 8.0.0 (não suportada com argumentos nomeados)

imagepolygon(GdImage $image, array $points, int $color): bool

Assinatura alternativa (defasada a partir do PHP 8.1.0)

imagepolygon(
    GdImage $image,
    array $points,
    int $num_points,
    int $color
): bool

imagepolygon() cria um polígono na imagem informada em image.

Parâmetros

image

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

points

Um array contendo os vértices do polígono, por exemplo:

points[0]	= x0
points[1]	= y0
points[2]	= x1
points[3]	= y1

num_points

Número total de pontos (vértices), que devem ser pelo menos 3.

Se este parâmetro for omitido conforme a segunda assinatura, points precisa ter um número par de elementos, e será assumido que num_points será igual a count($points)/2.

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.1.0	O parâmetro `num_points` tornou-se defasado.
8.0.0	O parâmetro `image` agora espera uma instância de GdImage; anteriormente, um resource `gd` válido era esperado.

Exemplos

Exemplo #1 Exemplo de imagepolygon()

<?php
// Cria uma imagem vazia
$image = imagecreatetruecolor(400, 300);

// Aloca uma cor para o polígono
$col_poly = imagecolorallocate($image, 255, 255, 255);

// Desenha o polígono
imagepolygon($image, array(
        0,   0,
        100, 200,
        300, 200
    ),
    3,
    $col_poly);

// Mostra a imagem no navegador
header('Content-type: image/png');

imagepng($image);
imagedestroy($image);
?>

O exemplo acima produzirá algo semelhante a:

Veja Também

imagefilledpolygon() - Desenha um polígono preenchido
imageopenpolygon() - Desenha um polígono aberto
imagecreate() - Crie uma nova imagem baseada em paleta
imagecreatetruecolor() - Cria uma nova imagem em cores verdadeiras

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema

＋adicione uma nota

Notas Enviadas por Usuários (em inglês) 3 notes

down

tatlar at yahoo dot com ¶

18 years ago

Function to get 5-sided polygon (pentagon) or star (pentagram) co-ords. 
<?php
function _makeFiveSidedStar( $x, $y, $radius, $shape='polygon', $spiky=NULL ) {
    $point = array() ; // new array                                                                                                                   
    $angle = 360 / 5 ;                                                                                                                    
    $point[0]['x'] = $x ;                                                                                                                 
    $point[0]['y'] = $y - $radius ;                                                                                                       
    $point[2]['x'] = $x + ( $radius * cos( deg2rad( 90 - $angle ) ) ) ; 
    $point[2]['y'] = $y - ( $radius * sin( deg2rad( 90 - $angle ) ) ) ;
    $point[4]['x'] = $x + ( $radius * sin( deg2rad( 180 - ( $angle*2 ) ) ) ) ;
    $point[4]['y'] = $y + ( $radius * cos( deg2rad( 180 - ( $angle*2 ) ) ) ) ;
    $point[6]['x'] = $x - ( $radius * sin( deg2rad( 180 - ( $angle*2 ) ) ) ) ;                                                            
    $point[6]['y'] = $y + ( $radius * cos( deg2rad( 180 - ( $angle*2 ) ) ) ) ;
    $point[8]['x'] = $x - ( $radius * cos( deg2rad( 90 - $angle ) ) ) ;                                                                   
    $point[8]['y'] = $y - ( $radius * sin( deg2rad( 90 - $angle ) ) ) ;
    if( $shape == 'star' ) {
        if( $spiky == NULL ) $spiky = 0.5 ;  // degree of spikiness, default to 0.5
        $indent = $radius * $spiky ;
        $point[1]['x'] = $x + ( $indent * cos( deg2rad( 90 - $angle/2 ) ) ) ;                                                             
        $point[1]['y'] = $y - ( $indent * sin( deg2rad( 90 - $angle/2 ) ) ) ;                                                     
        $point[3]['x'] = $x + ( $indent * sin( deg2rad( 180 - $angle ) ) ) ;                                                              
        $point[3]['y'] = $y - ( $indent * cos( deg2rad( 180 - $angle ) ) ) ;
        $point[5]['x'] = $x ;                                                                                                             
        $point[5]['y'] = $y + ( $indent * sin( deg2rad( 180 - $angle ) ) ) ;
        $point[7]['x'] = $x - ( $indent * sin( deg2rad( 180 - $angle ) ) ) ;                                                              
        $point[7]['y'] = $y - ( $indent * cos( deg2rad( 180 - $angle ) ) ) ;                                                              
        $point[9]['x'] = $x - ( $indent * cos( deg2rad( 90 - $angle/2 ) ) ) ;                                                             
        $point[9]['y'] = $y - ( $indent * sin( deg2rad( 90 - $angle/2 ) ) ) ;
    }
    ksort( $point ) ;
    $coords = array() ;  // new array                                                                                                                 
    foreach( $point as $pKey=>$pVal ) {                                                                                                   
        if( is_array( $pVal ) ) {                                                                                                         
            foreach( $pVal as $pSubKey=>$pSubVal ) {                                                                                      
                if( !empty( $pSubVal ) ) array_push( $coords, $pSubVal ) ;                                                                
            }                                                                                                                             
        }                                                                                                                                 
    }
    return $coords ;
}
$values = _makeFiveSidedStar( 100, 100, 50, 'star' ) ;
?>

down

licson0729 at gmail dot com ¶

12 years ago

Function to draw a n-sided regular polygon

<?php
$img = imagecreatetruecolor(1360,768);

function regularPolygon($img,$x,$y,$radius,$sides,$color)
{
    $points = array();
    for($a = 0;$a <= 360; $a += 360/$sides)
    {
        $points[] = $x + $radius * cos(deg2rad($a));
        $points[] = $y + $radius * sin(deg2rad($a));
    }
    return imagepolygon($img,$points,$sides,$color);
}

regularPolygon($img,1360/2,768/2,300,8,0xffffff);//Test draw

header('Content-type: image/png');
imagepng($img);
imagedestroy($img);
?>

down

-2

jsnell at networkninja dot com ¶

23 years ago

Here are some handy routines for rotation and translation of polygons.  Scaling could be added easily as well.



<?php

function translate_point(&$x,&$y,$angle,$about_x,$about_y,$shift_x,$shift_y)

{

    $x -= $about_x;

    $y -= $about_y;

    $angle = ($angle / 180) * M_PI;

/* math:

[x2,y2] = [x,  *  [[cos(a),-sin(a)],

           y]      [sin(a),cos(a)]]

==>

x = x * cos(a) + y*sin(a) 

y = x*-sin(a) + y*cos(a)

*/



    $new_x = $x * cos($angle) - $y * sin($angle);

    $new_y = $x * sin($angle) + $y * cos($angle);

    $x = $new_x+ $about_x + $shift_x ;

    $y = $new_y + $about_y + $shift_y;

}



function translate_poly($point_array, $angle, $about_x, $about_y,$shift_x,$shift_y)

{

    $translated_poly = Array();

    while(count($point_array) > 1)

    {

        $temp_x = array_shift($point_array);

        $temp_y = array_shift($point_array);

        translate_point($temp_x, $temp_y, $angle, $about_x, $about_y,$shift_x, $shift_y);

        array_push($translated_poly, $temp_x);

        array_push($translated_poly, $temp_y);

    }

    return $translated_poly;

}

?>

＋adicione uma nota