org.locationtech.jts.operation.overlayng

Class RingClipper

java.lang.Object

org.locationtech.jts.operation.overlayng.RingClipper

public class RingClipper
extends Object

Clips rings of points to a rectangle. Uses a variant of Cohen-Sutherland clipping.

In general the output is not topologically valid. In particular, the output may contain coincident non-noded line segments along the clip rectangle sides. However, the output is sufficiently well-structured that it can be used as input to the OverlayNG algorithm (which is able to process coincident linework due to the need to handle topology collapse under precision reduction).

Because of the likelihood of creating extraneous line segments along the clipping rectangle sides, this class is not suitable for clipping linestrings.

The clipping envelope should be generated using RobustClipEnvelopeComputer, to ensure that intersecting line segments are not perturbed by clipping. This is required to ensure that the overlay of the clipped geometry is robust and correct (i.e. the same as if clipping was not used).

Author:

Martin Davis

See Also:

LineLimiter

Constructor Summary

Constructors

Constructor and Description
RingClipper(Envelope clipEnv) Creates a new clipper for the given envelope.

Method Summary

Modifier and Type	Method and Description
Coordinate[]	clip(Coordinate[] pts) Clips a list of points to the clipping rectangle box.

Methods inherited from class java.lang.Object

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

Constructor Detail

RingClipper

public RingClipper(Envelope clipEnv)

Creates a new clipper for the given envelope.

Parameters:

clipEnv - the clipping envelope

Method Detail

clip

public Coordinate[] clip(Coordinate[] pts)

Clips a list of points to the clipping rectangle box.

Parameters:

pts -

Returns:

clipped pts array