Dibuja un polígono relleno

# imagefilledpolygon

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

imagefilledpolygon — Dibuja un polígono relleno

### Descripción

Firma a partir de PHP 8.0.0 (no soportada con argumentos nombrados)

function imagefilledpolygon(GdImage `$image`, array `$points`, int `$color`): bool

Firma alternativa (obsoleta a partir de PHP 8.1.0)

function imagefilledpolygon(
GdImage `$image`,
array `$points`,
int `$num_points`,
int `$color`
): bool

imagefilledpolygon() dibuja un polígono relleno en la imagen `image`.

### Parámetros

`image`
  Un objeto GdImage, retornado por una de las funciones de creación de imágenes, como imagecreatetruecolor().
`points`

  Un array que contiene las coordenadas `x` y `y` del vértice de los polígonos.

`num_points`

  Número total de puntos (vértices), que deben ser al menos 3.

  Si este parámetro es omitido conforme a la segunda firma, `points` debe tener un número par de elementos, y `num_points` se asume como `count($points)/2`.
`color`

  Un identificador de color creado con imagecolorallocate().

### Valores devueltos

Esta función retorna `true` en caso de éxito o `false` si ocurre un error.

### Historial de cambios

Versión | Descripción
--- | ---
8.1.0 | El parámetro `num_points` ha sido marcado como obsoleto.
8.0.0 | `image` ahora espera una instancia de GdImage; anteriormente, se esperaba un resource `gd` válido.

### Ejemplos

Ejemplo #1 Ejemplo con imagefilledpolygon()

    <?php
    // Definición del array de puntos para el polígono
    $values = array(
                40,  50,  // Punto 1 (x, y)
                20,  240, // Punto 2 (x, y)
                60,  60,  // Punto 3 (x, y)
                240, 20,  // Punto 4 (x, y)
                50,  40,  // Punto 5 (x, y)
                10,  10   // Punto 6 (x, y)
                );

    // Creación de una imagen
    $image = imagecreatetruecolor(250, 250);

    // Asignación de algunos colores
    $bg   = imagecolorallocate($image, 0, 0, 0);
    $blue = imagecolorallocate($image, 0, 0, 255);

    // Relleno del fondo
    imagefilledrectangle($image, 0, 0, 249, 249, $bg);

    // Dibujo del polígono
    imagefilledpolygon($image, $values, $blue);

    // Visualización de la imagen
    header('Content-type: image/png');
    imagepng($image);
    ?>

Resultado del ejemplo anterior es similar a:

### Ver también

- imagepolygon() - Dibuja un polígono

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open