kudm761/martinez-rueda-php

There is no license information available for the latest version (0.1.2) of this package.

Martinez-Rueda algorithm for polygon boolean operations

0.1.2 2020-06-11 07:53 UTC

Requires

• php: >=7.0

Requires (Dev)

• phpunit/phpunit: 5.5.*

Unknown License

• Dmitry Kubitsky

• geography
• polygon clipping
• polygon boolean operations
• polygon union
• polygon intersection
• polygon difference
• polygon xor
• martinez polygon algorithm
• martinez php

README

PHP implementation of original algorithm http://www4.ujaen.es/~fmartin/bool_op.html

Algorithm is used for computing Boolean operations on polygons:

• union
• difference
• intersection
• xor

install

$ composer require kudm761/martinez-rueda-php:dev

Usage

Input parameter is a multipolygon - an array of polygons. And each polygon is an array of points x,y.

    $data = [[[-1, 4], [-3, 4], [-3, 0], [-3, -1], [-1, -1], [-1, -2], [2, -2], [2, 1], [-1, 1], [-1, 4]]];
    $subject = new \MartinezRueda\Polygon($data);
    
    $data = [[[-2, 5], [-2, 0], [3, 0], [3, 3], [2, 3], [2, 2], [0, 2], [0, 5], [-2, 5]]];
    $clipping = new \MartinezRueda\Polygon($data);
    
    $result = (new \MartinezRueda\Algorithm())->getUnion($subject, $clipping);
    
    echo json_encode($result->toArray()), PHP_EOL;
    
    // Result is:
    // [[[2,3],[2,2],[0,2],[0,5],[-2,5],[-2,4],[-3,4],[-3,0],[-3,-1],[-1,-1],[-1,-2],[2,-2],[2,0],[3,0],[3,3],[2,3]]]

Some visual examples

Let's consider two polygons: green multipolygon of two polygons and yellow polygon.

Snow-white polygon is result of Boolean operation on two polygons.

Union

Difference (green NOT yellow)

Intersection

Xor