org.openstreetmap.josm.data.osm

Class MultipolygonBuilder

java.lang.Object

org.openstreetmap.josm.data.osm.MultipolygonBuilder

public class MultipolygonBuilder
extends Object

Helper class to build multipolygons from multiple ways.

Since:

7392 (rename), 3704

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MultipolygonBuilder.JoinedPolygon Represents one polygon that consists of multiple ways.
static class	MultipolygonBuilder.JoinedPolygonCreationException An exception indicating an error while joining ways to multipolygon rings.
(package private) static class	MultipolygonBuilder.PolygonLevel Helper storage class for finding findOuterWays
private static class	MultipolygonBuilder.Worker

Field Summary

Fields

Modifier and Type	Field and Description
List<MultipolygonBuilder.JoinedPolygon>	innerWays List of inner ways
List<MultipolygonBuilder.JoinedPolygon>	outerWays List of outer ways
private static Pair<Integer,ExecutorService>	THREAD_POOL

Constructor Summary

Constructors

Constructor and Description
MultipolygonBuilder() Constructs a new empty MultipolygonBuilder.
MultipolygonBuilder(List<MultipolygonBuilder.JoinedPolygon> outerWays, List<MultipolygonBuilder.JoinedPolygon> innerWays) Constructs a new MultipolygonBuilder initialized with given ways.

Method Summary

Modifier and Type	Method and Description
private static Pair<Boolean,List<MultipolygonBuilder.JoinedPolygon>>	findInnerWaysCandidates(MultipolygonBuilder.JoinedPolygon outerWay, Collection<MultipolygonBuilder.JoinedPolygon> boundaryWays)
private static List<MultipolygonBuilder.PolygonLevel>	findOuterWaysMultiThread(List<MultipolygonBuilder.JoinedPolygon> boundaryWays) Collects outer way and corresponding inner ways from all boundaries.
static List<MultipolygonBuilder.JoinedPolygon>	joinWays(Collection<Way> ways) Joins the given ways to multipolygon rings.
private String	makeFromPolygons(List<MultipolygonBuilder.JoinedPolygon> polygons) This method analyzes which ways are inner and which outer.
String	makeFromWays(Collection<Way> ways) Splits ways into inner and outer JoinedWays.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

THREAD_POOL

private static final Pair<Integer,ExecutorService> THREAD_POOL

outerWays

public final List<MultipolygonBuilder.JoinedPolygon> outerWays

List of outer ways

innerWays

public final List<MultipolygonBuilder.JoinedPolygon> innerWays

List of inner ways

Constructor Detail

MultipolygonBuilder

public MultipolygonBuilder(List<MultipolygonBuilder.JoinedPolygon> outerWays,
                           List<MultipolygonBuilder.JoinedPolygon> innerWays)

Constructs a new MultipolygonBuilder initialized with given ways.

Parameters:

outerWays - The outer ways

innerWays - The inner ways

MultipolygonBuilder

public MultipolygonBuilder()

Constructs a new empty MultipolygonBuilder.

Method Detail

makeFromWays

public String makeFromWays(Collection<Way> ways)

Splits ways into inner and outer JoinedWays. Sets innerWays and outerWays to the result. TODO: Currently cannot process touching polygons. See code in JoinAreasAction.

Parameters:

ways - ways to analyze

Returns:

error description if the ways cannot be split, null if all fine.

joinWays

public static List<MultipolygonBuilder.JoinedPolygon> joinWays(Collection<Way> ways)
                                                        throws MultipolygonBuilder.JoinedPolygonCreationException

Joins the given ways to multipolygon rings.

Parameters:

ways - the ways to join.

Returns:

a list of multipolygon rings.

Throws:

MultipolygonBuilder.JoinedPolygonCreationException - if the creation fails.

makeFromPolygons

private String makeFromPolygons(List<MultipolygonBuilder.JoinedPolygon> polygons)

This method analyzes which ways are inner and which outer. Sets innerWays and outerWays to the result.

Parameters:

polygons - polygons to analyze

Returns:

error description if the ways cannot be split, null if all fine.

findInnerWaysCandidates

private static Pair<Boolean,List<MultipolygonBuilder.JoinedPolygon>> findInnerWaysCandidates(MultipolygonBuilder.JoinedPolygon outerWay,
                                                                                             Collection<MultipolygonBuilder.JoinedPolygon> boundaryWays)

findOuterWaysMultiThread

private static List<MultipolygonBuilder.PolygonLevel> findOuterWaysMultiThread(List<MultipolygonBuilder.JoinedPolygon> boundaryWays)

Collects outer way and corresponding inner ways from all boundaries.

Parameters:

boundaryWays - boundary ways

Returns:

the outermostWay, or null if intersection found.