geos::operation::buffer::BufferOp Class Reference

Computes the buffer of a geometry, for both positive and negative buffer distances. More...

#include <geos/opBuffer.h>

List of all members.

Public Types

enum  { CAP_ROUND, CAP_BUTT, CAP_SQUARE }

Public Member Functions

 BufferOp (const geom::Geometry *g)
void setEndCapStyle (int nEndCapStyle)
void setQuadrantSegments (int nQuadrantSegments)
geom::GeometrygetResultGeometry (double nDistance)
geom::GeometrygetResultGeometry (double nDistance, int nQuadrantSegments)

Static Public Member Functions

static geom::GeometrybufferOp (const geom::Geometry *g, double distance, int quadrantSegments=OffsetCurveBuilder::DEFAULT_QUADRANT_SEGMENTS, int endCapStyle=BufferOp::CAP_ROUND)


Detailed Description

Computes the buffer of a geometry, for both positive and negative buffer distances.

In GIS, the buffer of a geometry is defined as the Minkowski sum or difference of the geometry with a circle with radius equal to the absolute value of the buffer distance. In the CAD/CAM world buffers are known as offset curves. In morphological analysis they are known as erosion and dilation.

The buffer operation always returns a polygonal result. The negative or zero-distance buffer of lines and points is always an empty Polygon.

Since true buffer curves may contain circular arcs, computed buffer polygons can only be approximations to the true geometry. The user can control the accuracy of the curve approximation by specifying the number of linear segments with which to approximate a curve.

The end cap style of a linear buffer may be specified. The following end cap styles are supported:

Last port: operation/buffer/BufferOp.java rev. 1.31 (JTS-1.7)


Member Enumeration Documentation

anonymous enum

Enumerator:
CAP_ROUND  Specifies a round line buffer end cap style.
CAP_BUTT  Specifies a butt (or flat) line buffer end cap style.
CAP_SQUARE  Specifies a square line buffer end cap style.


Constructor & Destructor Documentation

geos::operation::buffer::BufferOp::BufferOp ( const geom::Geometry g  )  [inline]

Initializes a buffer computation for the given geometry

Parameters:
g the geometry to buffer


Member Function Documentation

static geom::Geometry* geos::operation::buffer::BufferOp::bufferOp ( const geom::Geometry g,
double  distance,
int  quadrantSegments = OffsetCurveBuilder::DEFAULT_QUADRANT_SEGMENTS,
int  endCapStyle = BufferOp::CAP_ROUND 
) [static]

Computes the buffer for a geometry for a given buffer distance and accuracy of approximation.

Parameters:
g the geometry to buffer
distance the buffer distance
quadrantSegments the number of segments used to approximate a quarter circle
Returns:
the buffer of the input geometry

void geos::operation::buffer::BufferOp::setEndCapStyle ( int  nEndCapStyle  )  [inline]

Specifies the end cap style of the generated buffer. The styles supported are CAP_ROUND, CAP_BUTT, and CAP_SQUARE. The default is CAP_ROUND.

Parameters:
endCapStyle the end cap style to specify

void geos::operation::buffer::BufferOp::setQuadrantSegments ( int  nQuadrantSegments  )  [inline]

Specifies the end cap style of the generated buffer. The styles supported are CAP_ROUND, CAP_BUTT, and CAP_SQUARE. The default is CAP_ROUND.

Parameters:
endCapStyle the end cap style to specify

geom::Geometry* geos::operation::buffer::BufferOp::getResultGeometry ( double  nDistance  ) 

Returns the buffer computed for a geometry for a given buffer distance.

Parameters:
g the geometry to buffer
distance the buffer distance
Returns:
the buffer of the input geometry

geom::Geometry* geos::operation::buffer::BufferOp::getResultGeometry ( double  nDistance,
int  nQuadrantSegments 
)

Comutes the buffer for a geometry for a given buffer distance and accuracy of approximation.

Parameters:
g the geometry to buffer
distance the buffer distance
quadrantSegments the number of segments used to approximate a quarter circle
Returns:
the buffer of the input geometry
Deprecated:
use setQuadrantSegments instead


The documentation for this class was generated from the following file:
Generated on Fri Mar 27 04:53:49 2009 for GEOS by  doxygen 1.5.4