PolygonBuilder Class

Detailed Description

The initial shape stored in the builder can be initialized in the constructors by passing in existing geometries or collections. Change the contents of the shape by using the mutable PartCollection accessible from the parts() getter. Call the toGeometry method to create a new immutable Polygon from the current state of this builder.

// create a polygon builder
PolygonBuilder* polygonBuilder = new PolygonBuilder(SpatialReference(3857), this);

// create a single-part polygon using x/y
polygonBuilder->addPoint(-18.0, 34.0);
polygonBuilder->addPoint(-18.0, 35.0);
polygonBuilder->addPoint(-17.0, 34.0);
Polygon singlePartPolygonXY(polygonBuilder->toGeometry());

// create a multi-part polygon with same PolygonBuilder
PartCollection* partCollection = new PartCollection(polygonBuilder->spatialReference(), this);

// create outer poly 1
Part* part1 = new Part(polygonBuilder->spatialReference(), this);
part1->addPoint(2.123456789, 3.123456789);
part1->addPoint(1.123456789, 3.123456789);
part1->addPoint(1.123456789, 1.123456789);
partCollection->addPart(part1);

// create outer poly 2
Part* part2 = new Part(polygonBuilder->spatialReference(), this);
part2->addPoint(3.123456789, 3.123456789);
part2->addPoint(4.123456789, 3.123456789);
part2->addPoint(4.123456789, 1.123456789);
partCollection->addPart(part2);

polygonBuilder->setParts(partCollection);

Polygon multipartPolygon = polygonBuilder->toPolygon();