* * @var Polygon[] */ protected array $patches = []; /** * The coordinate system of each of the patches must match the one of the PolyhedralSurface. * * @param CoordinateSystem $cs The coordinate system of the PolyhedralSurface. * @param Polygon ...$patches The patches that compose the PolyhedralSurface. * * @throws CoordinateSystemException If different coordinate systems are used. */ public function __construct(CoordinateSystem $cs, Polygon ...$patches) { parent::__construct($cs, ! $patches); if (! $patches) { return; } CoordinateSystem::check($this, ...$patches); $this->patches = $patches; } /** * Creates a non-empty PolyhedralSurface composed of the given patches. * * @psalm-suppress UnsafeInstantiation * * @param Polygon $patch1 The first patch. * @param Polygon ...$patchN The subsequent patches, if any. * * @throws CoordinateSystemException If the patches use different coordinate systems. */ public static function of(Polygon $patch1, Polygon ...$patchN) : PolyhedralSurface { return new static($patch1->coordinateSystem(), $patch1, ...$patchN); } public function numPatches() : int { return count($this->patches); } /** * Returns the specified patch N in this PolyhedralSurface. * * @param int $n The patch number, 1-based. * * @throws NoSuchGeometryException If there is no patch at this index. */ public function patchN(int $n) : Polygon { if (! isset($this->patches[$n - 1])) { throw new NoSuchGeometryException('There is no patch in this PolyhedralSurface at index ' . $n); } return $this->patches[$n - 1]; } /** * Returns the patches that compose this PolyhedralSurface. * * @return Polygon[] */ public function patches() : array { return $this->patches; } /** * Returns the collection of polygons in this surface that bounds the given polygon 'p' for any polygon 'p' in the surface. * * @deprecated Please use `$geometryEngine->boundingPolygons()`. * * @noproxy * * @psalm-suppress LessSpecificReturnStatement * @psalm-suppress MoreSpecificReturnType * * @throws GeometryEngineException If the operation is not supported by the geometry engine. */ public function boundingPolygons(Polygon $p) : MultiPolygon { return GeometryEngineRegistry::get()->boundingPolygons($p); } /** * @deprecated Please use `$geometryEngine->isClosed()`. * * @noproxy * * @throws GeometryEngineException If the operation is not supported by the geometry engine. */ public function isClosed() : bool { return GeometryEngineRegistry::get()->isClosed($this); } /** * @noproxy */ public function geometryType() : string { return 'PolyhedralSurface'; } /** * @noproxy */ public function geometryTypeBinary() : int { return Geometry::POLYHEDRALSURFACE; } public function toXY(): PolyhedralSurface { if ($this->coordinateDimension() === 2) { return $this; } $cs = $this->coordinateSystem ->withZ(false) ->withM(false); $patches = array_map(fn(Polygon $patch) => $patch->toXY(), $this->patches); return new PolyhedralSurface($cs, ...$patches); } public function withoutZ(): PolyhedralSurface { if (! $this->coordinateSystem->hasZ()) { return $this; } $cs = $this->coordinateSystem->withZ(false); $patches = array_map(fn(Polygon $patch) => $patch->withoutZ(), $this->patches); return new PolyhedralSurface($cs, ...$patches); } public function withoutM(): PolyhedralSurface { if (! $this->coordinateSystem->hasM()) { return $this; } $cs = $this->coordinateSystem->withM(false); $patches = array_map(fn(Polygon $patch) => $patch->withoutM(), $this->patches); return new PolyhedralSurface($cs, ...$patches); } public function getBoundingBox() : BoundingBox { $boundingBox = new BoundingBox(); foreach ($this->patches as $patch) { $boundingBox = $boundingBox->extendedWithBoundingBox($patch->getBoundingBox()); } return $boundingBox; } public function toArray() : array { $result = []; foreach ($this->patches as $patch) { $result[] = $patch->toArray(); } return $result; } public function swapXY() : Geometry { $that = clone $this; foreach ($that->patches as & $patch) { $patch = $patch->swapXY(); } return $that; } /** * Returns the number of patches in this PolyhedralSurface. * * Required by interface Countable. */ public function count() : int { return count($this->patches); } /** * Returns an iterator for the patches in this PolyhedralSurface. * * Required by interface IteratorAggregate. * * @psalm-return ArrayIterator */ public function getIterator() : ArrayIterator { return new ArrayIterator($this->patches); } }