Adding drawPolygon method

Author: DantSu

docs/classes/DantSu/PHPImageEditor/Image.md

@@ -59,6 +59,7 @@ DantSu\PHPImageEditor\Image is PHP library to easily edit image with GD extensio
 - [writeText](#-writetext) 
 - [writeTextAndGetBoundingBox](#-writetextandgetboundingbox) 
 - [drawRectangle](#-drawrectangle) 
+- [drawPolygon](#-drawpolygon) 
 - [drawLine](#-drawline) 
 - [drawLineWithAngle](#-drawlinewithangle) 
 - [drawArrowWithAngle](#-drawarrowwithangle) 
@@ -894,6 +895,33 @@ Draw a rectangle.
 
 
 
+---
+### ->drawPolygon
+
+Draw a polygon.
+
+
+
+
+
+
+
+
+#### Parameters:
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `points` | **int[]** | Array of polygon's points [x1, y1, x2, y2, x3, y3...] |
+| `color` | **string** | Hexadecimal string color |
+| `antialias` | **mixed** |  |
+
+
+#### Return Value:
+
+ **$this** : Fluent interface
+
+
+
 ---
 ### ->drawLine
 
@@ -1376,4 +1404,4 @@ Get image GIF base64 data for <img src=""> tag.
 
 
 ---
-> Automatically generated from source code comments on 2022-05-11 using [phpDocumentor](http://www.phpdoc.org/)
+> Automatically generated from source code comments on 2022-05-24 using [phpDocumentor](http://www.phpdoc.org/)

docs/index.md

@@ -19,4 +19,4 @@ This is an automatically generated documentation for **PHP Image Editor**.
 
 
 ---
-> Automatically generated from source code comments on 2022-05-11 using [phpDocumentor](http://www.phpdoc.org/)
+> Automatically generated from source code comments on 2022-05-24 using [phpDocumentor](http://www.phpdoc.org/)

src/Image.php

@@ -10,7 +10,6 @@
  * @access public
  * @see https://github.com/DantSu/php-image-editor Github page of this project
  */
-
 class Image
 {
     const ALIGN_LEFT = 'left';
@@ -664,10 +663,10 @@ public function pasteOn(Image $image, $posX = Image::ALIGN_CENTER, $posY = Image
         if (!$this->isImageDefined() || !$image->isImageDefined()) {
             return $this;
         }
-        
+
         return $this->pasteGdImageOn($image->getImage(), $image->getWidth(), $image->getHeight(), $posX, $posY);
     }
-    
+
     /**
      * Paste the image at $posX and $posY position (You can use `Image::ALIGN_...`).
      *
@@ -683,7 +682,7 @@ public function pasteGdImageOn($image, int $imageWidth, int $imageHeight, $posX
         if (!$this->isImageDefined() || !static::isGdImage($image)) {
             return $this;
         }
-        
+
         $posX = $this->convertPosX($posX, $imageWidth);
         $posY = $this->convertPosY($posY, $imageHeight);
 
@@ -939,6 +938,33 @@ public function drawRectangle(int $left, int $top, int $right, int $bottom, stri
         return $this;
     }
 
+    /**
+     * Draw a polygon.
+     *
+     * @param int[] $points Array of polygon's points [x1, y1, x2, y2, x3, y3...]
+     * @param string $color Hexadecimal string color
+     * @return $this Fluent interface
+     */
+    public function drawPolygon(array $points, string $color = '#000000', $antialias = false): Image
+    {
+        if (!$this->isImageDefined()) {
+            return $this;
+        }
+
+        $color = $this->colorAllocate($color);
+
+        if ($color === false) {
+            return $this;
+        }
+
+        if($antialias) {
+            \imageantialias($this->image, true);
+            \imagepolygon($this->image, $points, \count($points) / 2, $color);
+        }
+        \imagefilledpolygon($this->image, $points, \count($points) / 2, $color);
+
+        return $this;
+    }
 
     /**
      * Draw a Line from `$originX, $originY` to `$dstX, $dstY`.
@@ -974,39 +1000,27 @@ public function drawLine(int $originX, int $originY, int $dstX, int $dstY, int $
      */
     public function drawLineWithAngle(int $originX, int $originY, float $angle, float $length, int $weight, string $color = '#000000'): Image
     {
-        if (!$this->isImageDefined()) {
-            return $this;
-        }
-
-        $color = $this->colorAllocate($color);
-
-        if ($color === false) {
-            return $this;
-        }
-
         $angle = Geometry2D::degrees0to360($angle);
 
         $points1 = Geometry2D::getDstXY($originX, $originY, Geometry2D::degrees0to360($angle - 90), \floor($weight / 2));
         $points2 = Geometry2D::getDstXY($points1['x'], $points1['y'], $angle, $length);
         $points4 = Geometry2D::getDstXY($originX, $originY, Geometry2D::degrees0to360($angle + 90), \floor($weight / 2));
         $points3 = Geometry2D::getDstXY($points4['x'], $points4['y'], $angle, $length);
 
-        $points = [
-            \round($points1['x']),
-            \round($points1['y']),
-            \round($points2['x']),
-            \round($points2['y']),
-            \round($points3['x']),
-            \round($points3['y']),
-            \round($points4['x']),
-            \round($points4['y'])
-        ];
-
-        \imageantialias($this->image, true);
-        \imagepolygon($this->image, $points, 4, $color);
-        \imagefilledpolygon($this->image, $points, 4, $color);
-
-        return $this;
+        return $this->drawPolygon(
+            [
+                \round($points1['x']),
+                \round($points1['y']),
+                \round($points2['x']),
+                \round($points2['y']),
+                \round($points3['x']),
+                \round($points3['y']),
+                \round($points4['x']),
+                \round($points4['y'])
+            ],
+            $color,
+            true
+        );
     }
 
     /**
@@ -1020,7 +1034,7 @@ public function drawLineWithAngle(int $originX, int $originY, float $angle, floa
      * @param string $color Hexadecimal string color
      * @return $this Fluent interface
      */
-    public function drawArrowWithAngle(int $originX, int $originY, float  $angle, float  $length, int $weight, string $color = '#000000'): Image
+    public function drawArrowWithAngle(int $originX, int $originY, float $angle, float $length, int $weight, string $color = '#000000'): Image
     {
         if (!$this->isImageDefined()) {
             return $this;

src/samples/sample4.php

@@ -0,0 +1,22 @@
+<?php
+
+
+require_once '../Geometry2D.php';
+require_once '../Image.php';
+
+use \DantSu\PHPImageEditor\Image;
+
+\header('Content-type: image/png');
+
+Image::fromPath(__DIR__ . '/resources/photo.jpg')
+    ->downscaleAndCrop(1920, 1080, Image::ALIGN_CENTER, Image::ALIGN_BOTTOM)
+    ->drawPolygon([110, 500, 240, 250, 400, 140, 650, 280, 400, 400, 800, 510, 400, 950, 180, 620, 230, 540], '#88229988')
+    ->drawCircle(450, 600, 200, '#FFFFFF88')
+    ->pasteOn(
+        Image::newCanvas(1920, 1080)
+            ->drawPolygon([1110, 500, 1240, 250, 1400, 140, 1650, 280, 1400, 400, 1800, 510, 1400, 950, 1180, 620, 1230, 540], '#88229988')
+            ->drawCircle(1450, 600, 200, '#FFFFFF88'),
+        0,
+        0
+    )
+    ->displayPNG();