OGRLineString Class Reference

#include <ogr_geometry.h>

Inheritance diagram for OGRLineString:

OGRCurve OGRGeometry OGRLinearRing List of all members.

Public Member Functions

 OGRLineString ()
virtual OGRErr importFromWkb (unsigned char *, int=-1)
virtual OGRErr importFromWkt (char **)
virtual void empty ()
void getPoint (int, OGRPoint *) const
virtual OGRBoolean Equals (OGRGeometry *) const
void setNumPoints (int)
void setPoint (int, OGRPoint *)
void setPoint (int, double, double, double=0.0)
void setPoints (int, OGRRawPoint *, double *=NULL)
void setPoints (int, double *padfX, double *padfY, double *padfZ=NULL)
void addPoint (OGRPoint *)
void addPoint (double, double, double=0.0)
virtual OGRErr transform (OGRCoordinateTransformation *poCT)
virtual void flattenTo2D ()

Detailed Description

Concrete representation of a multi-vertex line.


Constructor & Destructor Documentation

OGRLineString::OGRLineString  ) 
 

Create an empty line string.


Member Function Documentation

void OGRLineString::addPoint double  x,
double  y,
double  z = 0.0
 

Add a point to a line string.

The vertex count of the line string is increased by one, and assigned from the passed location value.

There is no SFCOM analog to this method.

Parameters:
x the X coordinate to assign to the new point.
y the Y coordinate to assign to the new point.
z the Z coordinate to assign to the new point (defaults to zero).

void OGRLineString::addPoint OGRPoint poPoint  ) 
 

Add a point to a line string.

The vertex count of the line string is increased by one, and assigned from the passed location value.

There is no SFCOM analog to this method.

Parameters:
poPoint the point to assign to the new vertex.

void OGRLineString::empty  )  [virtual]
 

Clear geometry information. This restores the geometry to it's initial state after construction, and before assignment of actual geometry.

This method relates to the SFCOM IGeometry::Empty() method.

This method is the same as the C function OGR_G_Empty().

Implements OGRGeometry.

OGRBoolean OGRLineString::Equals OGRGeometry poOther  )  const [virtual]
 

Returns two if two geometries are equivalent.

This method is the same as the C function OGR_G_Equal().

Returns:
TRUE if equivalent or FALSE otherwise.

Implements OGRGeometry.

void OGRLineString::flattenTo2D  )  [virtual]
 

Convert geometry to strictly 2D. In a sense this converts all Z coordinates to 0.0.

This method is the same as the C function OGR_G_FlattenTo2D().

Implements OGRGeometry.

void OGRLineString::getPoint int  i,
OGRPoint poPoint
const
 

Fetch a point in line string.

This method relates to the SFCOM ILineString::get_Point() method.

Parameters:
i the vertex to fetch, from 0 to getNumPoints()-1.
poPoint a point to initialize with the fetched point.

OGRErr OGRLineString::importFromWkb unsigned char *  pabyData,
int  nSize = -1
[virtual]
 

Assign geometry from well known binary data.

The object must have already been instantiated as the correct derived type of geometry object to match the binaries type. This method is used by the OGRGeometryFactory class, but not normally called by application code.

This method relates to the SFCOM IWks::ImportFromWKB() method.

This method is the same as the C function OGR_G_ImportFromWkb().

Parameters:
pabyData the binary input data.
nSize the size of pabyData in bytes, or zero if not known.
Returns:
OGRERR_NONE if all goes well, otherwise any of OGRERR_NOT_ENOUGH_DATA, OGRERR_UNSUPPORTED_GEOMETRY_TYPE, or OGRERR_CORRUPT_DATA may be returned.

Implements OGRGeometry.

Reimplemented in OGRLinearRing.

OGRErr OGRLineString::importFromWkt char **  ppszInput  )  [virtual]
 

Assign geometry from well known text data.

The object must have already been instantiated as the correct derived type of geometry object to match the text type. This method is used by the OGRGeometryFactory class, but not normally called by application code.

This method relates to the SFCOM IWks::ImportFromWKT() method.

This method is the same as the C function OGR_G_ImportFromWkt().

Parameters:
ppszInput pointer to a pointer to the source text. The pointer is updated to pointer after the consumed text.
Returns:
OGRERR_NONE if all goes well, otherwise any of OGRERR_NOT_ENOUGH_DATA, OGRERR_UNSUPPORTED_GEOMETRY_TYPE, or OGRERR_CORRUPT_DATA may be returned.

Implements OGRGeometry.

void OGRLineString::setNumPoints int  nNewPointCount  ) 
 

Set number of points in geometry.

This method primary exists to preset the number of points in a linestring geometry before setPoint() is used to assign them to avoid reallocating the array larger with each call to addPoint().

This method has no SFCOM analog.

Parameters:
nNewPointCount the new number of points for geometry.

void OGRLineString::setPoint int  iPoint,
double  xIn,
double  yIn,
double  zIn = 0.0
 

Set the location of a vertex in line string.

If iPoint is larger than the number of necessary the number of existing points in the line string, the point count will be increased to accomodate the request.

There is no SFCOM analog to this method.

Parameters:
iPoint the index of the vertex to assign (zero based).
xIn input X coordinate to assign.
yIn input Y coordinate to assign.
zIn input Z coordinate to assign (defaults to zero).

void OGRLineString::setPoint int  iPoint,
OGRPoint poPoint
 

Set the location of a vertex in line string.

If iPoint is larger than the number of necessary the number of existing points in the line string, the point count will be increased to accomodate the request.

There is no SFCOM analog to this method.

Parameters:
iPoint the index of the vertex to assign (zero based).
poPoint the value to assign to the vertex.

void OGRLineString::setPoints int  nPointsIn,
double *  padfX,
double *  padfY,
double *  padfZ = NULL
 

Assign all points in a line string.

This method clear any existing points assigned to this line string, and assigns a whole new set.

There is no SFCOM analog to this method.

Parameters:
nPointsIn number of points being passed in padfX and padfY.
padfX list of X coordinates of points being assigned.
padfY list of Y coordinates of points being assigned.
padfZ list of Z coordinates of points being assigned (defaults to NULL for 2D objects).

void OGRLineString::setPoints int  nPointsIn,
OGRRawPoint paoPointsIn,
double *  padfZ = NULL
 

Assign all points in a line string.

This method clears any existing points assigned to this line string, and assigns a whole new set. It is the most efficient way of assigning the value of a line string.

There is no SFCOM analog to this method.

Parameters:
nPointsIn number of points being passed in paoPointsIn
paoPointsIn list of points being assigned.
padfZ the Z values that go with the points (optional, may be NULL).

OGRErr OGRLineString::transform OGRCoordinateTransformation poCT  )  [virtual]
 

Apply arbitrary coordinate transformation to geometry.

This method will transform the coordinates of a geometry from their current spatial reference system to a new target spatial reference system. Normally this means reprojecting the vectors, but it could include datum shifts, and changes of units.

Note that this method does not require that the geometry already have a spatial reference system. It will be assumed that they can be treated as having the source spatial reference system of the OGRCoordinateTransformation object, and the actual SRS of the geometry will be ignored. On successful completion the output OGRSpatialReference of the OGRCoordinateTransformation will be assigned to the geometry.

This method is the same as the C function OGR_G_Transform().

Parameters:
poCT the transformation to apply.
Returns:
OGRERR_NONE on success or an error code.

Implements OGRGeometry.


The documentation for this class was generated from the following files:
Generated on Mon Jan 9 18:03:32 2006 for OGR by  doxygen 1.4.6