13872073621

Committed 15 Mar 2025 10:37AM UTC coverage: 51.165% (-36.2%) from 87.322%

Build # 13872073621

Build Type

push

github

Committed by

BenMorel

Commit Message

Add support for GeosOp in requireEngine()

Run Details

1866 of 3647 relevant lines covered (51.17%)

1154.34 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

66.67

/src/CurvePolygon.php

<?php

declare(strict_types=1);

namespace Brick\Geo;

use ArrayIterator;
use Brick\Geo\Attribute\NoProxy;
use Brick\Geo\Exception\CoordinateSystemException;
use Brick\Geo\Exception\EmptyGeometryException;
use Brick\Geo\Exception\NoSuchGeometryException;
use Brick\Geo\Projector\Projector;
use Override;

/**
 * A CurvePolygon is a planar Surface defined by 1 exterior boundary and 0 or more interior boundaries.
 *
 * A CurvePolygon instance differs from a Polygon instance in that a CurvePolygon instance may contain
 * the following circular arc segments: CircularString and CompoundCurve in addition to LineString.
 *
 * @template-implements \IteratorAggregate<int<0, max>, Curve>
 * @final
 */
class CurvePolygon extends Surface implements \Countable, \IteratorAggregate
{
    /**
     * The rings that compose this CurvePolygon.
     *
     * The first one represents the exterior ring, and the
     * (optional) other ones represent the interior rings (holes) of the CurvePolygon.
     *
     * An empty CurvePolygon contains no rings.
     *
     * @var list<Curve>
     */
    protected array $rings = [];

    /**
     * The coordinate system of each of the rings must match the one of the CurvePolygon.
     *
     * @param CoordinateSystem $cs       The coordinate system of the CurvePolygon.
     * @param Curve            ...$rings The rings that compose the CurvePolygon.
     *
     * @throws CoordinateSystemException If different coordinate systems are used.
     */
    public function __construct(CoordinateSystem $cs, Curve ...$rings)
    {
        parent::__construct($cs, ! $rings);

        if (! $rings) {
            return;
        }

        CoordinateSystem::check($this, ...$rings);

        $this->rings = array_values($rings);
    }

    /**
     * Creates a non-empty CurvePolygon composed of the given rings.
     *
     * @param Curve    $exteriorRing  The exterior ring.
     * @param Curve ...$interiorRings The interior rings, if any.
     *
     * @throws CoordinateSystemException If the rings use different coordinate systems.
     */
    public static function of(Curve $exteriorRing, Curve ...$interiorRings) : CurvePolygon
    {
        return new static($exteriorRing->coordinateSystem(), $exteriorRing, ...$interiorRings);
    }

    /**
     * Returns the exterior ring of this CurvePolygon.
     *
     * @throws EmptyGeometryException
     */
    public function exteriorRing() : Curve
    {
        if ($this->isEmpty) {
            throw new EmptyGeometryException('An empty CurvePolygon has no exterior ring.');
        }

        return $this->rings[0];
    }

    /**
     * Returns the number of interior rings in this CurvePolygon.
     */
    public function numInteriorRings() : int
    {
        if ($this->isEmpty) {
            return 0;
        }

        return count($this->rings) - 1;
    }

    /**
     * Returns the specified interior ring N in this CurvePolygon.
     *
     * @param int $n The ring number, 1-based.
     *
     * @throws NoSuchGeometryException If there is no interior ring at this index.
     */
    public function interiorRingN(int $n) : Curve
    {
        if ($n === 0 || ! isset($this->rings[$n])) {
            throw new NoSuchGeometryException('There is no interior ring in this CurvePolygon at index ' . $n);
        }

        return $this->rings[$n];
    }

    /**
     * Returns the interior rings in this CurvePolygon.
     *
     * @return list<Curve>
     */
    public function interiorRings() : array
    {
        return array_slice($this->rings, 1);
    }

    #[NoProxy, Override]
    public function geometryType() : string
    {
        return 'CurvePolygon';
    }

    #[NoProxy, Override]
    public function geometryTypeBinary() : int
    {
        return Geometry::CURVEPOLYGON;
    }

    #[Override]
    public function getBoundingBox() : BoundingBox
    {
        return array_reduce(
            $this->rings,
            fn (BoundingBox $boundingBox, Curve $ring) => $boundingBox->extendedWithBoundingBox($ring->getBoundingBox()),
            BoundingBox::new(),
        );
    }

    #[Override]
    public function toArray() : array
    {
        return array_map(
            fn (Curve $ring) => $ring->toArray(),
            $this->rings,
        );
    }

    #[Override]
    public function project(Projector $projector): CurvePolygon
    {
        return new CurvePolygon(
            $projector->getTargetCoordinateSystem($this->coordinateSystem),
            ...array_map(
                fn (Curve $ring) => $ring->project($projector),
                $this->rings,
            ),
        );
    }

    /**
     * Returns the number of rings (exterior + interior) in this CurvePolygon.
     */
    #[Override]
    public function count() : int
    {
        return count($this->rings);
    }

    /**
     * Returns an iterator for the rings (exterior + interior) in this CurvePolygon.
     *
     * @return ArrayIterator<int<0, max>, Curve>
     */
    #[Override]
    public function getIterator() : ArrayIterator
    {
        return new ArrayIterator($this->rings);
    }

    /**
     * Returns a copy of this CurvePolygon, with the exterior ring replaced with the given one.
     */
    public function withExteriorRing(Curve $exteriorRing) : CurvePolygon
    {
        return new CurvePolygon($this->coordinateSystem, $exteriorRing, ...$this->interiorRings());
    }

    /**
     * Returns a copy of this CurvePolygon, with the interior rings replaced with the given ones.
     */
    public function withInteriorRings(Curve ...$interiorRings) : CurvePolygon
    {
        return new CurvePolygon($this->coordinateSystem, $this->exteriorRing(), ...$interiorRings);
    }

    /**
     * Returns a copy of this CurvePolygon, with the given interior rings added.
     */
    public function withAddedInteriorRings(Curve ...$interiorRings) : CurvePolygon
    {
        return new CurvePolygon($this->coordinateSystem, $this->exteriorRing(), ...$this->interiorRings(), ...$interiorRings);
    }
}

1	<?php
2
3	declare(strict_types=1);
4
5	namespace Brick\Geo;
6
7	use ArrayIterator;
8	use Brick\Geo\Attribute\NoProxy;
9	use Brick\Geo\Exception\CoordinateSystemException;
10	use Brick\Geo\Exception\EmptyGeometryException;
11	use Brick\Geo\Exception\NoSuchGeometryException;
12	use Brick\Geo\Projector\Projector;
13	use Override;
14
15	/**
16	* A CurvePolygon is a planar Surface defined by 1 exterior boundary and 0 or more interior boundaries.
17	*
18	* A CurvePolygon instance differs from a Polygon instance in that a CurvePolygon instance may contain
19	* the following circular arc segments: CircularString and CompoundCurve in addition to LineString.
20	*
21	* @template-implements \IteratorAggregate<int<0, max>, Curve>
22	* @final
23	*/
24	class CurvePolygon extends Surface implements \Countable, \IteratorAggregate
25	{
26	/**
27	* The rings that compose this CurvePolygon.
28	*
29	* The first one represents the exterior ring, and the
30	* (optional) other ones represent the interior rings (holes) of the CurvePolygon.
31	*
32	* An empty CurvePolygon contains no rings.
33	*
34	* @var list<Curve>
35	*/
36	protected array $rings = [];
37
38	/**
39	* The coordinate system of each of the rings must match the one of the CurvePolygon.
40	*
41	* @param CoordinateSystem $cs The coordinate system of the CurvePolygon.
42	* @param Curve ...$rings The rings that compose the CurvePolygon.
43	*
44	* @throws CoordinateSystemException If different coordinate systems are used.
45	*/
46	public function __construct(CoordinateSystem $cs, Curve ...$rings)
47	{
48	parent::__construct($cs, ! $rings);	1,976✔
49
50	if (! $rings) {	1,976✔
51	return;	912✔
52	}
53
54	CoordinateSystem::check($this, ...$rings);	1,080✔
55
56	$this->rings = array_values($rings);	1,080✔
57	}
58
59	/**
60	* Creates a non-empty CurvePolygon composed of the given rings.
61	*
62	* @param Curve $exteriorRing The exterior ring.
63	* @param Curve ...$interiorRings The interior rings, if any.
64	*
65	* @throws CoordinateSystemException If the rings use different coordinate systems.
66	*/
67	public static function of(Curve $exteriorRing, Curve ...$interiorRings) : CurvePolygon
68	{
69	return new static($exteriorRing->coordinateSystem(), $exteriorRing, ...$interiorRings);	×
70	}
71
72	/**
73	* Returns the exterior ring of this CurvePolygon.
74	*
75	* @throws EmptyGeometryException
76	*/
77	public function exteriorRing() : Curve
78	{
79	if ($this->isEmpty) {	160✔
80	throw new EmptyGeometryException('An empty CurvePolygon has no exterior ring.');	32✔
81	}
82
83	return $this->rings[0];	128✔
84	}
85
86	/**
87	* Returns the number of interior rings in this CurvePolygon.
88	*/
89	public function numInteriorRings() : int
90	{
91	if ($this->isEmpty) {	72✔
92	return 0;	32✔
93	}
94
95	return count($this->rings) - 1;	40✔
96	}
97
98	/**
99	* Returns the specified interior ring N in this CurvePolygon.
100	*
101	* @param int $n The ring number, 1-based.
102	*
103	* @throws NoSuchGeometryException If there is no interior ring at this index.
104	*/
105	public function interiorRingN(int $n) : Curve
106	{
107	if ($n === 0 \|\| ! isset($this->rings[$n])) {	352✔
108	throw new NoSuchGeometryException('There is no interior ring in this CurvePolygon at index ' . $n);	288✔
109	}
110
111	return $this->rings[$n];	64✔
112	}
113
114	/**
115	* Returns the interior rings in this CurvePolygon.
116	*
117	* @return list<Curve>
118	*/
119	public function interiorRings() : array
120	{
121	return array_slice($this->rings, 1);	80✔
122	}
123
124	#[NoProxy, Override]
125	public function geometryType() : string
126	{
127	return 'CurvePolygon';	768✔
128	}
129
130	#[NoProxy, Override]
131	public function geometryTypeBinary() : int
132	{
133	return Geometry::CURVEPOLYGON;	398✔
134	}
135
136	#[Override]
137	public function getBoundingBox() : BoundingBox
138	{
139	return array_reduce(	×
140	$this->rings,	×
141	fn (BoundingBox $boundingBox, Curve $ring) => $boundingBox->extendedWithBoundingBox($ring->getBoundingBox()),	×
142	BoundingBox::new(),	×
143	);	×
144	}
145
146	#[Override]
147	public function toArray() : array
148	{
149	return array_map(	256✔
150	fn (Curve $ring) => $ring->toArray(),	256✔
151	$this->rings,	256✔
152	);	256✔
153	}
154
155	#[Override]
156	public function project(Projector $projector): CurvePolygon
157	{
158	return new CurvePolygon(	×
159	$projector->getTargetCoordinateSystem($this->coordinateSystem),	×
160	...array_map(	×
161	fn (Curve $ring) => $ring->project($projector),	×
162	$this->rings,	×
163	),	×
164	);	×
165	}
166
167	/**
168	* Returns the number of rings (exterior + interior) in this CurvePolygon.
169	*/
170	#[Override]
171	public function count() : int
172	{
173	return count($this->rings);	398✔
174	}
175
176	/**
177	* Returns an iterator for the rings (exterior + interior) in this CurvePolygon.
178	*
179	* @return ArrayIterator<int<0, max>, Curve>
180	*/
181	#[Override]
182	public function getIterator() : ArrayIterator
183	{
184	return new ArrayIterator($this->rings);	846✔
185	}
186
187	/**
188	* Returns a copy of this CurvePolygon, with the exterior ring replaced with the given one.
189	*/
190	public function withExteriorRing(Curve $exteriorRing) : CurvePolygon
191	{
192	return new CurvePolygon($this->coordinateSystem, $exteriorRing, ...$this->interiorRings());	32✔
193	}
194
195	/**
196	* Returns a copy of this CurvePolygon, with the interior rings replaced with the given ones.
197	*/
198	public function withInteriorRings(Curve ...$interiorRings) : CurvePolygon
199	{
200	return new CurvePolygon($this->coordinateSystem, $this->exteriorRing(), ...$interiorRings);	48✔
201	}
202
203	/**
204	* Returns a copy of this CurvePolygon, with the given interior rings added.
205	*/
206	public function withAddedInteriorRings(Curve ...$interiorRings) : CurvePolygon
207	{
208	return new CurvePolygon($this->coordinateSystem, $this->exteriorRing(), ...$this->interiorRings(), ...$interiorRings);	48✔
209	}
210	}

brick / geo / 13872073621

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous