org.opentrafficsim.core.geometry

Class OTSBuffering

java.lang.Object

org.opentrafficsim.core.geometry.OTSBuffering

public final class OTSBuffering
extends Object

Copyright (c) 2013-2015 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.

$LastChangedDate: 2015-07-16 10:20:53 +0200 (Thu, 16 Jul 2015) $, @version $Revision: 1124 $, by $Author: pknoppers $, initial version Jul 22, 2015

Author:

Alexander Verbraeck, Peter Knoppers

Method Summary

Modifier and Type	Method and Description
static OTSLine3D	constructContour(CrossSectionElement cse) Construct a buffer geometry by offsetting the linear geometry line with a distance and constructing a so-called "buffer" around it.
static OTSLine3D	offsetGeometry(OTSLine3D referenceLine, double offset) Generate a Geometry that has a fixed offset from a reference Geometry.
static OTSLine3D	offsetLine(OTSLine3D referenceLine, double offsetAtStart, double offsetAtEnd) Create the Geometry of a line at offset from a reference line.

Methods inherited from class java.lang.Object

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

Method Detail

offsetGeometry

public static OTSLine3D offsetGeometry(OTSLine3D referenceLine,
                                       double offset)
                                throws OTSGeometryException

Generate a Geometry that has a fixed offset from a reference Geometry.

Parameters:

referenceLine - Geometry; the reference line

offset - double; offset distance from the reference line; positive is LEFT, negative is RIGHT

Returns:

Geometry; the Geometry of a line that has the specified offset from the reference line

Throws:

OTSGeometryException - on failure

offsetLine

public static OTSLine3D offsetLine(OTSLine3D referenceLine,
                                   double offsetAtStart,
                                   double offsetAtEnd)
                            throws OTSGeometryException

Create the Geometry of a line at offset from a reference line. The offset may change linearly from its initial value at the start of the reference line to its final offset value at the end of the reference line.

Parameters:

referenceLine - Geometry; the Geometry of the reference line

offsetAtStart - double; offset at the start of the reference line (positive value is Left, negative value is Right)

offsetAtEnd - double; offset at the end of the reference line (positive value is Left, negative value is Right)

Returns:

Geometry; the Geometry of the line at linearly changing offset of the reference line

Throws:

OTSGeometryException - when this method fails to create the offset line

constructContour

public static OTSLine3D constructContour(CrossSectionElement cse)
                                  throws OTSGeometryException

Construct a buffer geometry by offsetting the linear geometry line with a distance and constructing a so-called "buffer" around it.

Parameters:

cse - the CrossSectionElement to construct the contour for

Returns:

the geometry belonging to this CrossSectionElement.

Throws:

OTSGeometryException - when construction of the geometry fails