com.luciad.geometry.constructive

Advanced GIS EngineInterface ILcdConstructiveGeometry

All Known Implementing Classes:

TLcdCartesianConstructiveGeometry, TLcdEllipsoidalConstructiveGeometry, TLcdSphericalConstructiveGeometry

public interface ILcdConstructiveGeometry

This interface allows boolean operations and convex hull calculation of shapes.

Since:

10.1

Method Summary

Modifier and Type	Method and Description
ILcdShape	convexHull(ILcdShape... aShapes) Finds the convex hull of the given shape or shapes.
ILcdShape	difference(ILcdShape... aShapes) Calculates the difference of the given shapes.
ILcdShape	intersection(ILcdShape... aShapes) Calculates the intersection of the given shapes.
ILcdShape	symmetricDifference(ILcdShape... aShapes) Calculates the symmetric difference of the given shapes.
ILcdShape	union(ILcdShape... aShapes) Calculates the union of the given shapes.

Method Detail

union

ILcdShape union(ILcdShape... aShapes)

Calculates the union of the given shapes. The resulting shape contains all points that are contained in any of the given shapes. The returned shape may be any type of shape, or a shape list of multiple shapes, depending on what is required to describe the resulting shape.

Red and blue shapes are the input shapes. The green shape is the result.

Parameters:

aShapes - The input shapes. There must be at least two shapes.

Returns:

A shape representing the union of the input shapes

Throws:

IllegalArgumentException - if the shapes are not supported.

intersection

ILcdShape intersection(ILcdShape... aShapes)

Calculates the intersection of the given shapes. The resulting shape only contains points that are contained in all of the given shapes. The returned shape may be any type of shape, or a shape list of multiple shapes, depending on what is required to describe the resulting shape.

Red and blue shapes are the input shapes. The green shape is the result.

Parameters:

aShapes - The input shapes. There must be at least two shapes.

Returns:

A shape representing the intersection of the input shapes

Throws:

IllegalArgumentException - if the shapes are not supported.

difference

ILcdShape difference(ILcdShape... aShapes)

Calculates the difference of the given shapes. All next shapes are subtracted from the first shape. The returned shape may be any type of shape, or a shape list of multiple shapes, depending on what is required to describe the resulting shape.

Red and blue shapes are the input shapes. The green shape is the result.

Parameters:

aShapes - The input shapes. There must be at least two shapes.

Returns:

A shape representing the difference of the input shapes

Throws:

IllegalArgumentException - if the shapes are not supported.

symmetricDifference

ILcdShape symmetricDifference(ILcdShape... aShapes)

Calculates the symmetric difference of the given shapes. The resulting shape contains all points that are inside an odd amount of the input shapes. This can be compared to the XOR boolean operation. The returned shape may be any type of shape, or a shape list of multiple shapes, depending on what is required to describe the resulting shape.

Red and blue shapes are the input shapes. The green shape is the result.

Parameters:

aShapes - The input shapes. There must be at least two shapes.

Returns:

A shape representing the symmetric difference of the input shapes

Throws:

IllegalArgumentException - if the shapes are not supported.

convexHull

ILcdShape convexHull(ILcdShape... aShapes)

Finds the convex hull of the given shape or shapes. The convex hull is defined as the smallest convex polygon that contains the shapes. If multiple shapes are given, the result is the convex hull around the points of all shapes together.

Convex hull of the United Kingdom.

Parameters:

aShapes - the shape or shapes for which to find the convex hull.

Returns:

a shape representing the convex hull as a polygon.

Throws:

IllegalArgumentException - if the shapes are not supported.