* * @var Point[] */ protected array $points = []; /** * @throws InvalidGeometryException If the number of points is invalid. * @throws CoordinateSystemException If different coordinate systems are used. */ public function __construct(CoordinateSystem $cs, Point ...$points) { parent::__construct($cs, ! $points); if (! $points) { return; } CoordinateSystem::check($this, ...$points); $numPoints = count($points); if ($numPoints < 3) { throw new InvalidGeometryException('A CircularString must be made of at least 3 points.'); } if ($numPoints % 2 === 0) { throw new InvalidGeometryException('A CircularString must have an odd number of points.'); } $this->points = $points; } /** * Creates a non-empty CircularString composed of the given points. * * @param Point $point1 The first point. * @param Point ...$pointN The subsequent points. * * @throws InvalidGeometryException If the number of points is invalid. * @throws CoordinateSystemException If the points use different coordinate systems. */ public static function of(Point $point1, Point ...$pointN) : CircularString { return new CircularString($point1->coordinateSystem(), $point1, ...$pointN); } public function startPoint() : Point { if ($this->isEmpty) { throw new EmptyGeometryException('The CircularString is empty and has no start point.'); } return $this->points[0]; } public function endPoint() : Point { if ($this->isEmpty) { throw new EmptyGeometryException('The CircularString is empty and has no end point.'); } return end($this->points); } /** * Returns the number of Points in this CircularString. */ public function numPoints() : int { return count($this->points); } /** * Returns the specified Point N in this CircularString. * * @param int $n The point number, 1-based. * * @throws NoSuchGeometryException If there is no Point at this index. */ public function pointN(int $n) : Point { if (! isset($this->points[$n - 1])) { throw new NoSuchGeometryException('There is no Point in this CircularString at index ' . $n); } return $this->points[$n - 1]; } /** * Returns the points that compose this CircularString. * * @return Point[] */ public function points() : array { return $this->points; } /** * @noproxy */ public function geometryType() : string { return 'CircularString'; } /** * @noproxy */ public function geometryTypeBinary() : int { return Geometry::CIRCULARSTRING; } public function toXY(): CircularString { if ($this->coordinateDimension() === 2) { return $this; } $cs = $this->coordinateSystem ->withZ(false) ->withM(false); $points = array_map(fn(Point $point) => $point->toXY(), $this->points); return new CircularString($cs, ...$points); } public function withoutZ(): CircularString { if (! $this->coordinateSystem->hasZ()) { return $this; } $cs = $this->coordinateSystem->withZ(false); $points = array_map(fn(Point $point) => $point->withoutZ(), $this->points); return new CircularString($cs, ...$points); } public function withoutM(): CircularString { if (! $this->coordinateSystem->hasM()) { return $this; } $cs = $this->coordinateSystem->withM(false); $geometries = array_map(fn(Point $point) => $point->withoutM(), $this->points); return new CircularString($cs, ...$geometries); } public function getBoundingBox() : BoundingBox { $boundingBox = new BoundingBox(); foreach ($this->points as $point) { $boundingBox = $boundingBox->extendedWithPoint($point); } return $boundingBox; } public function toArray() : array { $result = []; foreach ($this->points as $point) { $result[] = $point->toArray(); } return $result; } public function swapXY() : Geometry { $that = clone $this; foreach ($that->points as & $point) { $point = $point->swapXY(); } return $that; } /** * Returns the number of points in this CircularString. * * Required by interface Countable. */ public function count() : int { return count($this->points); } /** * Returns an iterator for the points in this CircularString. * * Required by interface IteratorAggregate. * * @psalm-return ArrayIterator */ public function getIterator() : ArrayIterator { return new ArrayIterator($this->points); } }