From 57f0e0c8581fa1a0a5d8f85078a73ded4d2d621e Mon Sep 17 00:00:00 2001
From: darthmaim <git@darthmaim.de>
Date: Tue, 18 Oct 2016 15:18:28 +0200
Subject: [PATCH 1/3] use PHP 5.6 for stable test on travis

---
 .travis.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index 1bdb03d..4702fd3 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -13,7 +13,7 @@ matrix:
   include:
     - php: 5.5
       env: setup=lowest
-    - php: 5.5
+    - php: 5.6
       env: setup=stable
     - php: 5.6
       env: setup=phar

From 5a7ce5754ab365aff380e04ec88851609fb078bf Mon Sep 17 00:00:00 2001
From: darthmaim <git@darthmaim.de>
Date: Tue, 18 Oct 2016 15:19:47 +0200
Subject: [PATCH 2/3] Add first revision of static maps

---
 src/Common/APIObject.php      |  27 +++
 src/Common/Continent.php      |  20 +++
 src/Common/ItemStack.php      |  22 +--
 src/Common/Map.php            |  18 ++
 src/Maps/Coordinate.php       |  85 +++++++++
 src/Maps/StaticMap.php        | 313 ++++++++++++++++++++++++++++++++++
 src/Maps/assets/landmark.png  | Bin 0 -> 532 bytes
 src/Maps/assets/menomonia.ttf | Bin 0 -> 44372 bytes
 src/Maps/assets/vista.png     | Bin 0 -> 1165 bytes
 src/Maps/assets/waypoint.png  | Bin 0 -> 4204 bytes
 10 files changed, 464 insertions(+), 21 deletions(-)
 create mode 100644 src/Common/APIObject.php
 create mode 100644 src/Common/Continent.php
 create mode 100644 src/Common/Map.php
 create mode 100644 src/Maps/Coordinate.php
 create mode 100644 src/Maps/StaticMap.php
 create mode 100644 src/Maps/assets/landmark.png
 create mode 100644 src/Maps/assets/menomonia.ttf
 create mode 100644 src/Maps/assets/vista.png
 create mode 100644 src/Maps/assets/waypoint.png

diff --git a/src/Common/APIObject.php b/src/Common/APIObject.php
new file mode 100644
index 0000000..1907c4e
--- /dev/null
+++ b/src/Common/APIObject.php
@@ -0,0 +1,27 @@
+<?php
+
+
+namespace GW2Treasures\GW2Tools\Common;
+
+
+class APIObject {
+    public static function fromObject(\stdClass $object) {
+        $itemStack = new static();
+
+        foreach ($object as $property => &$value) {
+            $itemStack->{$property} = $value;
+        }
+
+        return $itemStack;
+    }
+
+    public static function fromArray(array $array) {
+        $itemStack = new static();
+
+        foreach ($array as $property => &$value) {
+            $itemStack->{$property} = $value;
+        }
+
+        return $itemStack;
+    }
+}
diff --git a/src/Common/Continent.php b/src/Common/Continent.php
new file mode 100644
index 0000000..e3dad08
--- /dev/null
+++ b/src/Common/Continent.php
@@ -0,0 +1,20 @@
+<?php
+
+
+namespace GW2Treasures\GW2Tools\Common;
+
+
+class Continent extends APIObject {
+    /** @var int $id */
+    public $id = 0;
+
+    public $name = "";
+
+    public $continent_dims = [];
+
+    public $min_zoom = 0;
+
+    public $max_zoom = 0;
+
+    public $floors = [];
+}
diff --git a/src/Common/ItemStack.php b/src/Common/ItemStack.php
index 20684d2..6be523c 100644
--- a/src/Common/ItemStack.php
+++ b/src/Common/ItemStack.php
@@ -2,7 +2,7 @@
 
 namespace GW2Treasures\GW2Tools\Common;
 
-class ItemStack extends \stdClass {
+class ItemStack extends APIObject {
     /** @var int $count */
     public $count = 1;
 
@@ -14,24 +14,4 @@ class ItemStack extends \stdClass {
 
     /** @var int */
     public $skin = null;
-
-    public static function fromObject(\stdClass $object) {
-        $itemStack = new ItemStack();
-
-        foreach ($object as $property => &$value) {
-            $itemStack->{$property} = $value;
-        }
-
-        return $itemStack;
-    }
-
-    public static function fromArray(array $array) {
-        $itemStack = new ItemStack();
-
-        foreach ($array as $property => &$value) {
-            $itemStack->{$property} = $value;
-        }
-
-        return $itemStack;
-    }
 }
diff --git a/src/Common/Map.php b/src/Common/Map.php
new file mode 100644
index 0000000..210c04b
--- /dev/null
+++ b/src/Common/Map.php
@@ -0,0 +1,18 @@
+<?php
+
+
+namespace GW2Treasures\GW2Tools\Common;
+
+
+class Map extends APIObject {
+    /** @var int $id */
+    public $id = 0;
+
+    public $continent_id = 0;
+
+    public $default_floor = 0;
+
+    public $map_rect = [];
+
+    public $continent_rect = [];
+}
diff --git a/src/Maps/Coordinate.php b/src/Maps/Coordinate.php
new file mode 100644
index 0000000..d1f3825
--- /dev/null
+++ b/src/Maps/Coordinate.php
@@ -0,0 +1,85 @@
+<?php
+
+
+namespace GW2Treasures\GW2Tools\Maps;
+
+
+class Coordinate {
+    public $x, $y;
+
+    /**
+     * Coordinate constructor.
+     *
+     * @param float $x
+     * @param float $y
+     */
+    public function __construct($x, $y) {
+        $this->x = $x;
+        $this->y = $y;
+    }
+
+    public static function fromArray(array $array) {
+        return new Coordinate($array[0], $array[1]);
+    }
+
+    public function multiply($x, $y = null) {
+        if($y == null) {
+            $y = $x;
+        }
+
+        return new Coordinate(
+            $this->x * $x,
+            $this->y * $y
+        );
+    }
+
+    public function add($x, $y = null) {
+        if($y == null) {
+            $y = $x;
+        }
+
+        return new Coordinate(
+            $this->x + $x,
+            $this->y + $y
+        );
+    }
+
+    public function subtract($x, $y = null) {
+        if($y == null) {
+            $y = $x;
+        }
+
+        return new Coordinate(
+            $this->x - $x,
+            $this->y - $y
+        );
+    }
+
+    public function floor() {
+        return new Coordinate(floor($this->x), floor($this->y));
+    }
+
+    public function round() {
+        return new Coordinate(round($this->x), round($this->y));
+    }
+
+    public function ceil() {
+        return new Coordinate(ceil($this->x), ceil($this->y));
+    }
+
+    public function distance(Coordinate $other) {
+        return sqrt($this->distanceSquared($other));
+    }
+
+    public function distanceSquared(Coordinate $other) {
+        return pow($this->x - $other->x, 2) + pow($this->y - $other->y, 2);
+    }
+
+    public function min(Coordinate $other) {
+        return new Coordinate(min($this->x, $other->x), min($this->y, $other->y));
+    }
+
+    public function max(Coordinate $other) {
+        return new Coordinate(max($this->x, $other->x), max($this->y, $other->y));
+    }
+}
diff --git a/src/Maps/StaticMap.php b/src/Maps/StaticMap.php
new file mode 100644
index 0000000..aaf0033
--- /dev/null
+++ b/src/Maps/StaticMap.php
@@ -0,0 +1,313 @@
+<?php
+
+namespace GW2Treasures\GW2Tools\Maps;
+
+
+use GW2Treasures\GW2Tools\Common\Continent;
+use GW2Treasures\GW2Tools\Common\Map;
+
+class StaticMap {
+    /** @var Continent continentId */
+    protected $continent;
+
+    /** @var int floor */
+    protected $floor;
+
+    /** @var Coordinate $nwCorner */
+    protected $nwCorner;
+
+    /** @var Coordinate $seCorner */
+    protected $seCorner;
+
+    /** @var string $cachePath */
+    protected $cachePath;
+
+    /** @var array $pointsOfInterest */
+    protected $pointsOfInterest = [];
+
+    /**
+     * StaticMap constructor.
+     *
+     * @param Continent $continent
+     * @param int $floor
+     * @throws \Exception
+     */
+    public function __construct(Continent $continent, $floor) {
+        if(!in_array($floor, $continent->floors)) {
+            throw new \Exception("Floor $floor is not a valid floor of {$continent->name}.");
+        }
+
+        $this->continent = $continent;
+        $this->floor = $floor;
+
+        $this->setCachePath('./_mapcache');
+    }
+
+    /**
+     * Sets the bounding rectangle of the map.
+     *
+     * @param Coordinate $nwCorner
+     * @param Coordinate $seCorner
+     */
+    public function setBounds(Coordinate $nwCorner, Coordinate $seCorner) {
+        if($nwCorner->x < 0 || $nwCorner->y < 0 || $seCorner->x > $this->continent->continent_dims[0] || $seCorner->y > $this->continent->continent_dims[1]) {
+            throw new \InvalidArgumentException("The map bounds are not within the continent dimensions.");
+        }
+
+        $this->nwCorner = $nwCorner;
+        $this->seCorner = $seCorner;
+    }
+
+    public function addWaypoint(Coordinate $position, $label) {
+        $this->pointsOfInterest[] = ['type' => 'waypoint'] + compact('position', 'label');
+    }
+
+    public function addLandmark(Coordinate $position, $label) {
+        $this->pointsOfInterest[] = ['type' => 'landmark'] + compact('position', 'label');
+    }
+
+    public function addVista(Coordinate $position) {
+        $this->pointsOfInterest[] = ['type' => 'vista', 'label' => null] + compact('position');
+    }
+
+    /**
+     * Adds a custom point of interest.
+     *
+     * @param Coordinate $position
+     * @param resource $icon
+     * @param string|null $label
+     */
+    public function addCustomPointOfInterest(Coordinate $position, $icon, $label) {
+        $this->pointsOfInterest[] = ['type' => 'custom'] + compact('position', 'label', 'icon');
+    }
+
+    /**
+     * Converts world coordinates to tile coordinates
+     *
+     * @param Coordinate $coordinate
+     * @param int $zoom
+     * @return Coordinate
+     */
+    protected function getTileCoordinatesOf(Coordinate $coordinate, $zoom) {
+        $tileCount = 1 << $zoom;
+
+        return new Coordinate(
+            floor($coordinate->x / ($this->continent->continent_dims[0] / $tileCount)),
+            floor($coordinate->y / ($this->continent->continent_dims[1] / $tileCount))
+        );
+    }
+
+    public function setCachePath($path) {
+        $this->cachePath = realpath($path);
+    }
+
+    public function getCachePath() {
+        return $this->cachePath;
+    }
+
+    protected function getTile($x, $y, $zoom) {
+        $cachePath = $this->getCachePath();
+        $url = "https://tiles.guildwars2.com/{$this->continent->id}/{$this->floor}/$zoom/$x/$y.jpg";
+        $cacheFileName = $cachePath."/{$this->continent->id}-{$this->floor}-$x-$y-$zoom.jpg";
+
+        if($cachePath === false) {
+            return imagecreatefromjpeg($url);
+        }
+
+        if(!file_exists($cacheFileName)) {
+            $file = file_get_contents($url);
+            file_put_contents($cacheFileName, $file);
+
+            return imagecreatefromstring($file);
+        }
+
+        return imagecreatefromjpeg($cacheFileName);
+    }
+
+    /**
+     * @param int $width
+     * @param int $height
+     * @param int $scale
+     *
+     * @return resource
+     */
+    public function render($width, $height, $scale) {
+        if($width <= 0 || $height <= 0 || $scale <= 0) {
+            throw new \InvalidArgumentException("Parameters for render have to be positive.");
+        }
+
+        // always use max_zoom
+        $zoom = $this->continent->max_zoom;
+
+        $continentSize = new Coordinate($this->continent->continent_dims[0], $this->continent->continent_dims[1]);
+        $tileCount = 1 << $zoom;
+        $tileSize = $continentSize->x / $tileCount;
+
+        // get the tiles of the north-west and south-east corner
+        $tileNW = $this->getTileCoordinatesOf($this->nwCorner, $zoom);
+        $tileSE = $this->getTileCoordinatesOf($this->seCorner, $zoom);
+
+        // calculate how many tiles we are displaying
+        $tileCountX = $tileSE->x - $tileNW->x + 1;
+        $tileCountY = $tileSE->y - $tileNW->y + 1;
+
+        // create a temp image buffer that gets resized later
+        // this prevents seems beetween tiles but uses a lot of memory if there are to many tiles…
+        $buffer = imagecreatetruecolor($tileCountX * 256, $tileCountY * 256);
+
+        // load all tiles
+        // TODO: parallel loading
+        for($x = $tileNW->x; $x <= $tileSE->x; $x++) {
+            for($y = $tileNW->y; $y <= $tileSE->y; $y++) {
+                $tile = $this->getTile($x, $y, $zoom);
+
+                // render the tile in the buffer
+                imagecopy($buffer, $tile, ($x - $tileNW->x) * 256, ($y - $tileNW->y) * 256, 0, 0, 256, 256);
+                imagedestroy($tile);
+                unset($tile);
+            }
+        }
+
+        // get the world coordinates of the nw corner of the nw tile
+        $tileNWWorld = new Coordinate(
+            $tileSize * $tileNW->x,
+            $tileSize * $tileNW->y
+        );
+
+        // get the world coordinates of the sw corner of the sw tile
+        $tileSEWorld = new Coordinate(
+            $tileSize * $tileSE->x + $tileSize,
+            $tileSize * $tileSE->y + $tileSize
+        );
+
+        // get the size in world coordinates of the rendered buffer
+        $renderedSize = new Coordinate(
+            $tileSEWorld->x - $tileNWWorld->x,
+            $tileSEWorld->y - $tileNWWorld->y
+        );
+
+        // get the position of the NW corner of the requested bounds within the buffer
+        $rectMin = new Coordinate(
+            ($this->nwCorner->x - $tileNWWorld->x) / $renderedSize->x,
+            ($this->nwCorner->y - $tileNWWorld->y) / $renderedSize->y
+        );
+
+        // get the position of the SW corner of the requested bounds within the buffer
+        $rectMax = new Coordinate(
+            ($this->seCorner->x - $tileNWWorld->x) / $renderedSize->x,
+            ($this->seCorner->y - $tileNWWorld->y) / $renderedSize->y
+        );
+
+
+        // get the aspect ration of the map bounds and the size of the image
+        $aspectRatio = $width / $height;
+        $mapAspectRatio = ($this->seCorner->x - $this->nwCorner->x) / ($this->seCorner->y - $this->nwCorner->y);
+
+        // resize the image if needed
+        // TODO: adjust the bounds of rendered map instead? Always return exactly the requested image size…
+        if($aspectRatio < $mapAspectRatio) {
+            $width = ceil($height * $mapAspectRatio);
+        } else {
+            $height = ceil($width * (1 / $mapAspectRatio));
+        }
+
+        // create the image
+        $image = imagecreatetruecolor($width * $scale, $height * $scale);
+        $white = imagecolorallocate($buffer, 255, 255, 255);
+        $black = imagecolorallocate($buffer, 0, 0, 0);
+
+        // copy the buffer into the image
+        imagecopyresampled($image, $buffer,
+            // destination position
+            0, 0,
+            // source position
+            $rectMin->x * $tileCountX * 256, $rectMin->y * $tileCountY * 256,
+            // destination size
+            $width * $scale, $height * $scale,
+            // source size
+            ($rectMax->x - $rectMin->x) * $tileCountX * 256, ($rectMax->y - $rectMin->y) * $tileCountY * 256
+        );
+        imagedestroy($buffer);
+        unset($buffer);
+
+        // render waypoints/pois/…
+        $poiIcons = [];
+        foreach($this->pointsOfInterest as $pointOfInterest) {
+            $hasCustomIcon = array_key_exists('icon', $pointOfInterest) && is_resource($pointOfInterest['icon']);
+
+            if(!$hasCustomIcon && !array_key_exists($pointOfInterest['type'], $poiIcons)) {
+                $poiIcons[$pointOfInterest['type']] = imagecreatefrompng(__DIR__.'/assets/'.$pointOfInterest['type'].'.png');
+            }
+
+            $icon = $hasCustomIcon
+                ? $pointOfInterest['icon']
+                : $poiIcons[$pointOfInterest['type']];
+
+            $poiPosition = $this->worldCoordinateToBoundary($pointOfInterest['position'])
+                ->multiply($width * $scale, $height * $scale)->round();
+
+            $this->drawIconWithLabel($image, $icon, $pointOfInterest['label'], $poiPosition, $scale, $white, $black);
+        }
+
+        foreach($poiIcons as $icon) {
+            imagedestroy($icon);
+            unset($icon);
+        }
+        unset($poiIcons);
+
+        return $image;
+    }
+
+    protected function drawIconWithLabel(&$image, &$icon, $text, $position, $scale, $color, $shadow) {
+        imagecopyresampled($image, $icon, $position->x - 8 * $scale, $position->y - 8 * $scale, 0, 0, 16 * $scale, 16 * $scale, imagesx($icon), imagesy($icon));
+
+        if($text === null) {
+            return;
+        }
+
+        $fontFile = __DIR__.'/assets/menomonia.ttf';
+
+        $fontSize = 10 * ($scale * 0.75 + 0.25);
+        $textSize = imagettfbbox($fontSize, 0, $fontFile, $text);
+        $textWidth = $textSize[2] - $textSize[0];
+        $textHeight = $textSize[3] - $textSize[1];
+
+        $imageWidth = imagesx($image);
+        $imageHeight = imagesy($image);
+
+        $x = min(max(8 * $scale, $position->x - $textWidth / 2), $imageWidth - 8 * $scale - $textWidth);
+        $y = min(max($textHeight + 8 * $scale, $position->y + $textHeight + 18 * $scale), $imageHeight - 8 * $scale);
+
+        imagettftext($image, $fontSize, 0, $x + 1, $y + 0, $shadow, $fontFile, $text);
+        imagettftext($image, $fontSize, 0, $x - 1, $y + 0, $shadow, $fontFile, $text);
+        imagettftext($image, $fontSize, 0, $x + 0, $y + 1, $shadow, $fontFile, $text);
+        imagettftext($image, $fontSize, 0, $x + 0, $y - 1, $shadow, $fontFile, $text);
+
+        imagettftext($image, $fontSize, 0, $x + 1, $y + 1, $shadow, $fontFile, $text);
+        imagettftext($image, $fontSize, 0, $x + 1, $y - 1, $shadow, $fontFile, $text);
+        imagettftext($image, $fontSize, 0, $x - 1, $y + 1, $shadow, $fontFile, $text);
+        imagettftext($image, $fontSize, 0, $x - 1, $y - 1, $shadow, $fontFile, $text);
+
+        imagettftext($image, $fontSize, 0, $x + 0, $y + 0, $color, $fontFile, $text);
+    }
+
+    public function worldCoordinateToBoundary(Coordinate $coordinate) {
+        return new Coordinate(
+            ($coordinate->x - $this->nwCorner->x) / ($this->seCorner->x - $this->nwCorner->x),
+            ($coordinate->y - $this->nwCorner->y) / ($this->seCorner->y - $this->nwCorner->y)
+        );
+    }
+
+    public static function mapCoordinateToContinent(Coordinate $coordinate, Map $map) {
+        $continentMin = Coordinate::fromArray($map->continent_rect[0]);
+        $continentMax = Coordinate::fromArray($map->continent_rect[1]);
+
+        $mapMin = Coordinate::fromArray($map->map_rect[0]);
+        $mapMax = Coordinate::fromArray($map->map_rect[1]);
+
+        return new Coordinate(
+            $continentMin->x + ($continentMax->x - $continentMin->x) * (($coordinate->x - $mapMin->x) / ($mapMax->x - $mapMin->x)),
+            $continentMin->y + ($continentMax->y - $continentMin->y) * (($coordinate->y - $mapMin->y) / ($mapMax->y - $mapMin->y))
+        );
+    }
+}
diff --git a/src/Maps/assets/landmark.png b/src/Maps/assets/landmark.png
new file mode 100644
index 0000000000000000000000000000000000000000..7352e564f593d5c3538390426799c73773ac7e1d
GIT binary patch
literal 532
zcmV+v0_**WP)<h;3K|Lk000e1NJLTq001BW001Be1^@s6b9#F800001b5ch_0Itp)
z=>Px#1ZP1_K>z@;j|==^1poj532;bRa{vGi!vFvd!vV){sAK>D0jWtuK~z{r?Up}F
z!$26u6I1m-MF)pWVh1NDzks+2E{c<b6d~v$2x+S*g7^W%LGaIJk@_|C8<b8NTb#NG
z9UL+^ygqMxr<WF5$;DtHfgeW;*XMW7HJ4acc4ZA@4UB37j^m`JE|9bgcoZThCI?~V
zEIWdsrj7ZV;8s#ZxIYMlA4xVkB8Jx(<`)4e5Ke<YC`oQGE*a)`R#4pDTBoobbopou
zB~bx)UYr98Lj*IQtq6qAIxHyA0=NTH#trleyj4BYX*_wPU=dBAoP>Y{fm6K!4iC=q
z-_(xt#IVF)2^{JI@Ac;t1hkt6;a*n&^@7&R71exK0}c3SpmIP&ZG8()um!X6{sU2g
zo%97XZG;zefo668w+%eRZy+jA?rnf26kNTcXA4+hCEgbN%(CaE#U;Sr@*xD&d7#F=
zgDFtwz$*k6Oa&~2@5K~&OjH08O%`#7AWuPVfdy7g8{jQilr60B2!RT?2iKqsN?=!x
zC4^qc@IoRD^sT^l_<ZMggK@x5OLf!o$nbYFV8V3uBRAjp<->f%|3JZf5!o-K-M|+F
WS?phxuPy8V0000<MNUMnLSTaYN7T~*

literal 0
HcmV?d00001

diff --git a/src/Maps/assets/menomonia.ttf b/src/Maps/assets/menomonia.ttf
new file mode 100644
index 0000000000000000000000000000000000000000..ccbdebd1936d73f68b7f66e9cce7a66126691e04
GIT binary patch
literal 44372
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
G(f<IbyQ#te

literal 0
HcmV?d00001

diff --git a/src/Maps/assets/vista.png b/src/Maps/assets/vista.png
new file mode 100644
index 0000000000000000000000000000000000000000..8cd4cc810b12b507c0f54f5f1045697c1589edce
GIT binary patch
literal 1165
zcmV;81akX{P)<h;3K|Lk000e1NJLTq001BW001Be1^@s6b9#F800001b5ch_0Itp)
z=>Px#1ZP1_K>z@;j|==^1poj532;bRa{vGi!vFvd!vV){sAK>D1R_a9K~z{r?Urk3
z6jvCAr)DFAtLsQEO|mw+O-!=hlSY){EsIGoWw8o{R+PpIjoZ|=zuHQFw2BC}X%Q0;
zC7=XR5w?mTT1wF$B`9bpO%aOr1{Q*d777Zr*{|<=I%oT3lXN#~`bP&I&dlb_d7t^t
znKN;mr^nbT5JdL^Fw1YpcK0LpejfL)0lQ8nns>djsB)t(;y&WI|9!g~a3+8%@HRM?
z+!Py-{aXgm_8@r!?k@R11X>W@`D$H65N@Cd1bPtOJf0E(|LHr?Ucdi&I^0OCuZ?_*
z@b|%j@v1_(UwRWx@Z=0OEeYl49Ygr*<57hQ4BF&5PV&@ii~o>4>x3kil}krWfwUL8
z(ziA$ecM}pM8AWe4xszvJDM=mXRY(X12!BYCe%t$1On1nSxSlbe2LKGP~g)iK)(+6
z1yU3stis;awMGJczw#yKpnYhGXK=F(Ki!*%-J<}5EvUdC!i@wgfTuSCN@6R<c<!OA
zfJuyj&er+mH|3M{a(82`bWeAszqx{>j<2X9LOv{U<<eWtavyI5X`kucL~ti~2~>l;
zv5M3n`~z^A;e_Gm>x$FpaGtAh$~<_n%)726#w1XP8`mKG3mblF!_pz)6ww00R})Wu
zsA(>r-n7YhE!V?2@Qz=FoVV&4-0&$vP3akqX)qPgu<WG2tx+hzDPXvT0vQrq4}n~!
zq9Hoj{pM~wDw@8f5z(BDRmrt&jb>9qo7!FBrMl;p3TcPfj_P7bE{VvhqTsJyz&U{6
zm0)Hzfe1QmhQMz<FN8(YQB#c7{x1};yCTj__*n$9g$#oYlz_l@8295`1Sr@L3gjKd
zgk8<x2V9fe1mS}ephy>{hv8O$6086P*n;0N?h(+cB>1Y2c(4i$2zgnN!1)ev81!N)
zD3Ib5m~coSd=R9pgdd!)LjAL$U;HX?DtJs7O@Iq!DkxIS_8jL;a1smhd-HZA@DW;w
zdH#n~Z++xX@Bqk(XsL8nmdLwdPvX;D!`Dlqf)Cn7unF*=8fJ`o(2gY{6j|;IT(GaE
z3a7wd2p%K|Ph|>3T}O6ShYbin0%F+&Xl4aw<GhVekMLXe)!bd^45<J^EqiBp!zzGK
zBe1F{^fS(PV$8YOB+^fhj{C45n9|#QfdU$SkTfhipWH$Lgr}zhW4@71!hVq27Kgnn
zKVe_cT*Io@aPBqT*pxIKxK`Xi_(z}~l=;;jwjR;~;VJH&F6;{}WuY|jf}m(((}JR@
z59W(z0j@PjI|Jf5382#zK<hMk9dBqd{{AJd$&h<8u5+q@U5IQaX%Ie1llk`%t|#L+
z4NGs!KkBB$Kk$|0=al<{B_HS6U|-#5BCaj`o#z~P)Nn2eEx?;b63_$dfRV!O7!0<1
f&9KGyWd86sQE8%~&*=`O00000NkvXXu0mjf@cA9n

literal 0
HcmV?d00001

diff --git a/src/Maps/assets/waypoint.png b/src/Maps/assets/waypoint.png
new file mode 100644
index 0000000000000000000000000000000000000000..b9cc41f3a7e7a16e2ffa3d00098fc223a7551ca8
GIT binary patch
literal 4204
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

literal 0
HcmV?d00001


From 8c0c78221cfef3923ecc728cd72b23e33a8cd069 Mon Sep 17 00:00:00 2001
From: darthmaim <git@darthmaim.de>
Date: Mon, 24 Oct 2016 23:39:48 +0200
Subject: [PATCH 3/3] always render labels on top of icons

---
 src/Maps/StaticMap.php      | 81 ++++++++++++++++++-------------------
 src/Maps/StaticMapIcon.php  | 72 +++++++++++++++++++++++++++++++++
 src/Maps/StaticMapLabel.php | 60 +++++++++++++++++++++++++++
 3 files changed, 171 insertions(+), 42 deletions(-)
 create mode 100644 src/Maps/StaticMapIcon.php
 create mode 100644 src/Maps/StaticMapLabel.php

diff --git a/src/Maps/StaticMap.php b/src/Maps/StaticMap.php
index aaf0033..af73b8e 100644
--- a/src/Maps/StaticMap.php
+++ b/src/Maps/StaticMap.php
@@ -22,8 +22,11 @@ class StaticMap {
     /** @var string $cachePath */
     protected $cachePath;
 
-    /** @var array $pointsOfInterest */
-    protected $pointsOfInterest = [];
+    /** @var StaticMapIcon[] $icons */
+    protected $icons = [];
+
+    /** @var StaticMapLabel[] $labels */
+    protected $labels = [];
 
     /**
      * StaticMap constructor.
@@ -59,26 +62,25 @@ public function setBounds(Coordinate $nwCorner, Coordinate $seCorner) {
     }
 
     public function addWaypoint(Coordinate $position, $label) {
-        $this->pointsOfInterest[] = ['type' => 'waypoint'] + compact('position', 'label');
+        $this->addLabel(new StaticMapLabel($label, $position, true));
+        $this->addIcon(StaticMapIcon::waypoint($position));
     }
 
     public function addLandmark(Coordinate $position, $label) {
-        $this->pointsOfInterest[] = ['type' => 'landmark'] + compact('position', 'label');
+        $this->addLabel(new StaticMapLabel($label, $position, true));
+        $this->addIcon(StaticMapIcon::landmark($position));
     }
 
     public function addVista(Coordinate $position) {
-        $this->pointsOfInterest[] = ['type' => 'vista', 'label' => null] + compact('position');
+        $this->addIcon(StaticMapIcon::vista($position));
     }
 
-    /**
-     * Adds a custom point of interest.
-     *
-     * @param Coordinate $position
-     * @param resource $icon
-     * @param string|null $label
-     */
-    public function addCustomPointOfInterest(Coordinate $position, $icon, $label) {
-        $this->pointsOfInterest[] = ['type' => 'custom'] + compact('position', 'label', 'icon');
+    public function addIcon(StaticMapIcon $icon) {
+        $this->icons[] = $icon;
+    }
+
+    public function addLabel(StaticMapLabel $label) {
+        $this->labels[] = $label;
     }
 
     /**
@@ -230,50 +232,45 @@ public function render($width, $height, $scale) {
         imagedestroy($buffer);
         unset($buffer);
 
-        // render waypoints/pois/…
-        $poiIcons = [];
-        foreach($this->pointsOfInterest as $pointOfInterest) {
-            $hasCustomIcon = array_key_exists('icon', $pointOfInterest) && is_resource($pointOfInterest['icon']);
-
-            if(!$hasCustomIcon && !array_key_exists($pointOfInterest['type'], $poiIcons)) {
-                $poiIcons[$pointOfInterest['type']] = imagecreatefrompng(__DIR__.'/assets/'.$pointOfInterest['type'].'.png');
-            }
-
-            $icon = $hasCustomIcon
-                ? $pointOfInterest['icon']
-                : $poiIcons[$pointOfInterest['type']];
-
-            $poiPosition = $this->worldCoordinateToBoundary($pointOfInterest['position'])
-                ->multiply($width * $scale, $height * $scale)->round();
-
-            $this->drawIconWithLabel($image, $icon, $pointOfInterest['label'], $poiPosition, $scale, $white, $black);
+        // render icons
+        foreach($this->icons as $icon) {
+            $this->renderIcon($image, $icon, $width, $height, $scale);
         }
 
-        foreach($poiIcons as $icon) {
-            imagedestroy($icon);
-            unset($icon);
+        // render labels
+        foreach($this->labels as $label) {
+            $this->renderLabel($image, $label, $width, $height, $scale);
         }
-        unset($poiIcons);
 
         return $image;
     }
 
-    protected function drawIconWithLabel(&$image, &$icon, $text, $position, $scale, $color, $shadow) {
-        imagecopyresampled($image, $icon, $position->x - 8 * $scale, $position->y - 8 * $scale, 0, 0, 16 * $scale, 16 * $scale, imagesx($icon), imagesy($icon));
+    protected function renderIcon(&$image, StaticMapIcon $icon, $width, $height, $scale) {
+        $position = $this->worldCoordinateToBoundary($icon->getPosition())
+            ->multiply($width * $scale, $height * $scale)->round();
 
-        if($text === null) {
-            return;
-        }
+        $img = $icon->getIcon();
 
+        imagecopyresampled($image, $img, $position->x - 8 * $scale, $position->y - 8 * $scale, 0, 0, 16 * $scale, 16 * $scale, imagesx($img), imagesy($img));
+    }
+
+    protected function renderLabel(&$image, StaticMapLabel $label, $width, $height, $scale) {
         $fontFile = __DIR__.'/assets/menomonia.ttf';
+        $color = $label->getColor();
+        $color = imagecolorallocate($image, $color[0], $color[1], $color[2]);
+        $shadow = imagecolorallocate($image, 0, 0, 0);
+        $text = $label->getText();
 
         $fontSize = 10 * ($scale * 0.75 + 0.25);
         $textSize = imagettfbbox($fontSize, 0, $fontFile, $text);
         $textWidth = $textSize[2] - $textSize[0];
         $textHeight = $textSize[3] - $textSize[1];
 
-        $imageWidth = imagesx($image);
-        $imageHeight = imagesy($image);
+        $imageWidth = $width * $scale;
+        $imageHeight = $height * $scale;
+
+        $position = $this->worldCoordinateToBoundary($label->getPosition())
+            ->multiply($width * $scale, $height * $scale)->round();
 
         $x = min(max(8 * $scale, $position->x - $textWidth / 2), $imageWidth - 8 * $scale - $textWidth);
         $y = min(max($textHeight + 8 * $scale, $position->y + $textHeight + 18 * $scale), $imageHeight - 8 * $scale);
diff --git a/src/Maps/StaticMapIcon.php b/src/Maps/StaticMapIcon.php
new file mode 100644
index 0000000..5d8ed52
--- /dev/null
+++ b/src/Maps/StaticMapIcon.php
@@ -0,0 +1,72 @@
+<?php
+
+namespace GW2Treasures\GW2Tools\Maps;
+
+class StaticMapIcon {
+    /** @var resource $icon */
+    private $icon;
+
+    /** @var Coordinate $position */
+    private $position;
+
+    /**
+     * StaticMapIcon constructor.
+     *
+     * @param resource $icon
+     * @param Coordinate $position
+     */
+    public function __construct($icon, Coordinate $position) {
+        $this->icon = $icon;
+        $this->position = $position;
+    }
+
+    public function getIcon() {
+        return $this->icon;
+    }
+
+    public function getPosition() {
+        return $this->position;
+    }
+
+    // === STATIC ===
+
+    public static function waypoint(Coordinate $position) {
+        $waypoint = new static(null, $position);
+        $waypoint->icon = self::getAsset(self::ASSET_WAYPOINT);
+
+        return $waypoint;
+    }
+
+    public static function landmark(Coordinate $position) {
+        $waypoint = new static(null, $position);
+        $waypoint->icon = self::getAsset(self::ASSET_LANDMARK);
+
+        return $waypoint;
+    }
+
+    public static function vista(Coordinate $position) {
+        $waypoint = new static(null, $position);
+        $waypoint->icon = self::getAsset(self::ASSET_VISTA);
+
+        return $waypoint;
+    }
+
+    /** @var resource[] $assets */
+    private static $_assets = [];
+
+    const ASSET_WAYPOINT = 'waypoint';
+    const ASSET_LANDMARK = 'landmark';
+    const ASSET_VISTA = 'vista';
+
+    /**
+     * @param string $asset
+     * @return resource
+     */
+    private static function getAsset($asset) {
+        if(!array_key_exists($asset, self::$_assets)) {
+            self::$_assets[$asset] = imagecreatefrompng(__DIR__.'/assets/'.$asset.'.png');
+        }
+
+        return self::$_assets[$asset];
+    }
+}
diff --git a/src/Maps/StaticMapLabel.php b/src/Maps/StaticMapLabel.php
new file mode 100644
index 0000000..a3d769d
--- /dev/null
+++ b/src/Maps/StaticMapLabel.php
@@ -0,0 +1,60 @@
+<?php
+
+namespace GW2Treasures\GW2Tools\Maps;
+
+class StaticMapLabel {
+    /** @var string $text */
+    private $text;
+
+    /** @var Coordinate $position */
+    private $position;
+
+    /** @var bool $hasIcon */
+    private $hasIcon;
+
+    /** @var int[] $color */
+    private $color;
+
+    /**
+     * StaticMapLabel constructor.
+     *
+     * @param string $text
+     * @param Coordinate $position
+     * @param int[] $color
+     * @param bool $hasIcon
+     */
+    public function __construct($text, Coordinate $position, $hasIcon = false, $color = [255, 255, 255]) {
+        $this->text = $text;
+        $this->position = $position;
+        $this->hasIcon = $hasIcon;
+        $this->color = $color;
+    }
+
+    /**
+     * @return string
+     */
+    public function getText() {
+        return $this->text;
+    }
+
+    /**
+     * @return Coordinate
+     */
+    public function getPosition() {
+        return $this->position;
+    }
+
+    /**
+     * @return boolean
+     */
+    public function hasIcon() {
+        return $this->hasIcon;
+    }
+
+    /**
+     * @return int[]
+     */
+    public function getColor() {
+        return $this->color;
+    }
+}