A geometry is the spatial representation of a feature. More...

#include <qgsgeometry.h>

Classes
class	Error

Public Member Functions
	QgsGeometry ()
	Constructor.
	QgsGeometry (const QgsGeometry &)
	copy constructor will prompt a deep copy of the object
QgsGeometry &	operator= (QgsGeometry const &rhs)
	assignments will prompt a deep copy of the object
	~QgsGeometry ()
	Destructor.
void	fromGeos (GEOSGeometry *geos)
	Set the geometry, feeding in a geometry in GEOS format.
void	fromWkb (unsigned char *wkb, size_t length)
	Set the geometry, feeding in the buffer containing OGC Well-Known Binary and the buffer's length.
const unsigned char *	asWkb () const
	Returns the buffer containing this geometry in WKB format.
size_t	wkbSize () const
	Returns the size of the WKB in asWkb().
const GEOSGeometry *	asGeos () const
	Returns a geos geomtry.
QGis::WkbType	wkbType () const
	Returns type of wkb (point / linestring / polygon etc.)
QGis::GeometryType	type ()
	Returns type of the vector.
bool	isMultipart ()
	Returns true if wkb of the geometry is of WKBMulti* type.
bool	isGeosEqual (QgsGeometry &)
	compare geometries using GEOS
bool	isGeosValid ()
	check validity using GEOS
bool	isGeosEmpty ()
	check if geometry is empty using GEOS
double	area ()
	get area of geometry using GEOS
double	length ()
	get length of geometry using GEOS
double	distance (QgsGeometry &geom)
QgsPoint	closestVertex (const QgsPoint &point, int &atVertex, int &beforeVertex, int &afterVertex, double &sqrDist)
	Returns the vertex closest to the given point, the corresponding vertex index, squared distance snap point / target point and the indices of the vertices before/after.
void	adjacentVertices (int atVertex, int &beforeVertex, int &afterVertex)
	Returns the indexes of the vertices before and after the given vertex index.
bool	insertVertex (double x, double y, int beforeVertex)
	Insert a new vertex before the given vertex index, ring and item (first number is index 0) If the requested vertex number (beforeVertex.back()) is greater than the last actual vertex on the requested ring and item, it is assumed that the vertex is to be appended instead of inserted.
bool	moveVertex (double x, double y, int atVertex)
	Moves the vertex at the given position number and item (first number is index 0) to the given coordinates.
bool	deleteVertex (int atVertex)
	Deletes the vertex at the given position number and item (first number is index 0) Returns false if atVertex does not correspond to a valid vertex on this geometry (including if this geometry is a Point), or if the number of remaining verticies in the linestring would be less than two.
QgsPoint	vertexAt (int atVertex)
	Returns coordinates of a vertex.
double	sqrDistToVertexAt (QgsPoint &point, int atVertex)
	Returns the squared cartesian distance between the given point to the given vertex index (vertex at the given position number, ring and item (first number is index 0))
double	closestVertexWithContext (const QgsPoint &point, int &atVertex)
	Searches for the closest vertex in this geometry to the given point.
double	closestSegmentWithContext (const QgsPoint &point, QgsPoint &minDistPoint, int &afterVertex, double *leftOf=0, double epsilon=DEFAULT_SEGMENT_EPSILON)
	Searches for the closest segment of geometry to the given point.
int	addRing (const QList< QgsPoint > &ring)
	Adds a new ring to this geometry.
int	addPart (const QList< QgsPoint > &points)
	Adds a new island polygon to a multipolygon feature.
int	translate (double dx, double dy)
	Translate this geometry by dx, dy.
int	transform (const QgsCoordinateTransform &ct)
	Transform this geometry as described by CoordinateTranasform ct.
int	splitGeometry (const QList< QgsPoint > &splitLine, QList< QgsGeometry * > &newGeometries, bool topological, QList< QgsPoint > &topologyTestPoints)
	Splits this geometry according to a given line.
int	reshapeGeometry (const QList< QgsPoint > &reshapeWithLine)
	Replaces a part of this geometry with another line.
int	makeDifference (QgsGeometry *other)
	Changes this geometry such that it does not intersect the other geometry.
QgsRectangle	boundingBox ()
	Returns the bounding box of this feature.
bool	intersects (const QgsRectangle &r) const
	Test for intersection with a rectangle (uses GEOS)
bool	intersects (const QgsGeometry *geometry) const
	Test for intersection with a geometry (uses GEOS)
bool	contains (const QgsPoint *p) const
	Test for containment of a point (uses GEOS)
bool	contains (const QgsGeometry *geometry) const
	Test for if geometry is contained in an other (uses GEOS)
bool	disjoint (const QgsGeometry *geometry) const
	Test for if geometry is disjoint of an other (uses GEOS)
bool	equals (const QgsGeometry *geometry) const
	Test for if geometry equals an other (uses GEOS)
bool	touches (const QgsGeometry *geometry) const
	Test for if geometry touch an other (uses GEOS)
bool	overlaps (const QgsGeometry *geometry) const
	Test for if geometry overlaps an other (uses GEOS)
bool	within (const QgsGeometry *geometry) const
	Test for if geometry is within an other (uses GEOS)
bool	crosses (const QgsGeometry *geometry) const
	Test for if geometry crosses an other (uses GEOS)
QgsGeometry *	buffer (double distance, int segments)
	Returns a buffer region around this geometry having the given width and with a specified number of segments used to approximate curves.
QgsGeometry *	simplify (double tolerance)
	Returns a simplified version of this geometry using a specified tolerance value.
QgsGeometry *	centroid ()
	Returns the center of mass of a geometry.
QgsGeometry *	convexHull ()
	Returns the smallest convex polygon that contains all the points in the geometry.
QgsGeometry *	interpolate (double distance)
QgsGeometry *	intersection (QgsGeometry *geometry)
	Returns a geometry representing the points shared by this geometry and other.
QgsGeometry *	combine (QgsGeometry *geometry)
	Returns a geometry representing all the points in this geometry and other (a union geometry operation).
QgsGeometry *	difference (QgsGeometry *geometry)
	Returns a geometry representing the points making up this geometry that do not make up other.
QgsGeometry *	symDifference (QgsGeometry *geometry)
	Returns a Geometry representing the points making up this Geometry that do not make up other.
QString	exportToWkt () const
	Exports the geometry to mWkt.
QString	exportToGeoJSON () const
	Exports the geometry to mGeoJSON.
QgsPoint	asPoint () const
	return contents of the geometry as a point if wkbType is WKBPoint, otherwise returns [0,0]
QgsPolyline	asPolyline () const
	return contents of the geometry as a polyline if wkbType is WKBLineString, otherwise an empty list
QgsPolygon	asPolygon () const
	return contents of the geometry as a polygon if wkbType is WKBPolygon, otherwise an empty list
QgsMultiPoint	asMultiPoint () const
	return contents of the geometry as a multi point if wkbType is WKBMultiPoint, otherwise an empty list
QgsMultiPolyline	asMultiPolyline () const
	return contents of the geometry as a multi linestring if wkbType is WKBMultiLineString, otherwise an empty list
QgsMultiPolygon	asMultiPolygon () const
	return contents of the geometry as a multi polygon if wkbType is WKBMultiPolygon, otherwise an empty list
QList< QgsGeometry * >	asGeometryCollection () const
	return contents of the geometry as a list of geometries
bool	deleteRing (int ringNum, int partNum=0)
	delete a ring in polygon or multipolygon.
bool	deletePart (int partNum)
	delete part identified by the part number
bool	convertToMultiType ()
	Converts single type geometry into multitype geometry e.g.
int	avoidIntersections (QMap< QgsVectorLayer , QSet< QgsFeatureId > > ignoreFeatures=(QMap< QgsVectorLayer , QSet< QgsFeatureId > >()))
	Modifies geometry to avoid intersections with the layers specified in project properties.
void	validateGeometry (QList< Error > &errors)
	Validate geometry and produce a list of geometry errors.

Static Public Member Functions
static QgsGeometry *	fromWkt (QString wkt)
	static method that creates geometry from Wkt
static QgsGeometry *	fromPoint (const QgsPoint &point)
	construct geometry from a point
static QgsGeometry *	fromMultiPoint (const QgsMultiPoint &multipoint)
	construct geometry from a multipoint
static QgsGeometry *	fromPolyline (const QgsPolyline &polyline)
	construct geometry from a polyline
static QgsGeometry *	fromMultiPolyline (const QgsMultiPolyline &multiline)
	construct geometry from a multipolyline
static QgsGeometry *	fromPolygon (const QgsPolygon &polygon)
	construct geometry from a polygon
static QgsGeometry *	fromMultiPolygon (const QgsMultiPolygon &multipoly)
	construct geometry from a multipolygon
static QgsGeometry *	fromRect (const QgsRectangle &rect)
	construct geometry from a rectangle

Private Member Functions
bool	exportWkbToGeos () const
	Converts from the WKB geometry to the GEOS geometry.
bool	exportGeosToWkb () const
	Converts from the GEOS geometry to the WKB geometry.
bool	insertVertex (double x, double y, int beforeVertex, const GEOSCoordSequence old_sequence, GEOSCoordSequence *new_sequence)
	Insert a new vertex before the given vertex index (first number is index 0) in the given GEOS Coordinate Sequence.
void	translateVertex (int &wkbPosition, double dx, double dy, bool hasZValue)
	Translates a single vertex by dx and dy.
void	transformVertex (int &wkbPosition, const QgsCoordinateTransform &ct, bool hasZValue)
	Transforms a single vertex by ct.
int	splitLinearGeometry (GEOSGeometry splitLine, QList< QgsGeometry > &newGeometries)
	Splits line/multiline geometries.
int	splitPolygonGeometry (GEOSGeometry splitLine, QList< QgsGeometry > &newGeometries)
	Splits polygon/multipolygon geometries.
int	topologicalTestPointsSplit (const GEOSGeometry *splitLine, QList< QgsPoint > &testPoints) const
	Finds out the points that need to be tested for topological correctnes if this geometry will be split.
int	numberOfGeometries (GEOSGeometry *g) const
	Returns number of single geometry in a geos geometry.
int	mergeGeometriesMultiTypeSplit (QVector< GEOSGeometry * > &splitResult)
QgsPoint	asPoint (unsigned char *&ptr, bool hasZValue) const
	return point from wkb
QgsPolyline	asPolyline (unsigned char *&ptr, bool hasZValue) const
	return polyline from wkb
QgsPolygon	asPolygon (unsigned char *&ptr, bool hasZValue) const
	return polygon from wkb
double	leftOf (double x, double y, double &x1, double &y1, double &x2, double &y2)
	Returns < 0 if point(x/y) is left of the line x1,y1 -> x1,y2.

Static Private Member Functions
static GEOSGeometry *	reshapeLine (const GEOSGeometry origLine, const GEOSGeometry reshapeLineGeos)
	Creates a new line from an original line and a reshape line.
static GEOSGeometry *	reshapePolygon (const GEOSGeometry polygon, const GEOSGeometry reshapeLineGeos)
	Creates a new polygon replacing the part from the first to the second intersection with the reshape line.
static GEOSGeometry *	nodeGeometries (const GEOSGeometry splitLine, const GEOSGeometry poly)
	Nodes together a split line and a (multi-) polygon geometry in a multilinestring.
static int	lineContainedInLine (const GEOSGeometry line1, const GEOSGeometry line2)
	Tests if line1 is completely contained in line2.
static int	pointContainedInLine (const GEOSGeometry point, const GEOSGeometry line)
	Tests if a point is on a line.
static bool	geomInDegrees (const GEOSGeometry *geom)
	Tests if geom bounding rect is within -180 <= x <= 180, -90 <= y <= 90.
static bool	geosRelOp (char(op)(const GEOSGeometry , const GEOSGeometry ), const QgsGeometry a, const QgsGeometry *b)

Private Attributes
unsigned char *	mGeometry
	pointer to geometry in binary WKB format This is the class' native implementation
size_t	mGeometrySize
	size of geometry
GEOSGeometry *	mGeos
	cached GEOS version of this geometry
bool	mDirtyWkb
	If the geometry has been set since the last conversion to WKB.
bool	mDirtyGeos
	If the geometry has been set since the last conversion to GEOS.

Detailed Description

A geometry is the spatial representation of a feature.

Represents a geometry with input and output in formats specified by (at least) the Open Geospatial Consortium (WKB / Wkt), and containing various functions for geoprocessing of the geometry.

The geometry is represented internally by the OGC WKB format or as GEOS geometry. Some functions use WKB for their work, others use GEOS.

TODO: migrate completely to GEOS and only support WKB/Wkt import/export.

Author: Brendan Morley

Definition at line 72 of file qgsgeometry.h.

Constructor & Destructor Documentation

QgsGeometry::QgsGeometry ( )

Constructor.

Definition at line 191 of file qgsgeometry.cpp.

Referenced by asGeometryCollection(), and combine().

QgsGeometry::QgsGeometry ( const QgsGeometry & rhs )

copy constructor will prompt a deep copy of the object

Definition at line 200 of file qgsgeometry.cpp.

References mGeometry, mGeometrySize, and mGeos.

QgsGeometry::~QgsGeometry ( )

Destructor.

Definition at line 224 of file qgsgeometry.cpp.

References mGeometry, and mGeos.

Member Function Documentation

int QgsGeometry::addPart ( const QList< QgsPoint > & points )

Adds a new island polygon to a multipolygon feature.

Returns: 0 in case of success, 1 if not a multipolygon, 2 if ring is not a valid geometry, 3 if new polygon ring not disjoint with existing polygons of the feature

Definition at line 2893 of file qgsgeometry.cpp.

References convertToMultiType(), createGeosCollection(), createGeosLinearRing(), createGeosLineString(), createGeosPoint(), createGeosPolygon(), exportWkbToGeos(), isMultipart(), QGis::Line, QgsMessageLog::logMessage(), mDirtyGeos, mDirtyWkb, mGeos, QGis::Point, QGis::Polygon, QgsDebugMsg, tr, type(), and GEOSException::what().

Referenced by QgsVectorLayerEditUtils::addPart().

int QgsGeometry::addRing ( const QList< QgsPoint > & ring )

Adds a new ring to this geometry.

This makes only sense for polygon and multipolygons.

Returns: 0 in case of success (ring added), 1 problem with geometry type, 2 ring not closed, 3 ring is not valid geometry, 4 ring not disjoint with existing rings, 5 no polygon found which contained the ring

Definition at line 2695 of file qgsgeometry.cpp.

References createGeosCollection(), createGeosLinearRing(), createGeosPolygon(), exportWkbToGeos(), QgsMessageLog::logMessage(), mDirtyGeos, mDirtyWkb, mGeos, QGis::Polygon, throwGEOSException(), tr, type(), GEOSException::what(), QGis::WKBMultiPolygon, QGis::WKBPolygon, and wkbType().

Referenced by QgsVectorLayerEditUtils::addRing().

void QgsGeometry::adjacentVertices	(	int	atVertex,
		int &	beforeVertex,
		int &	afterVertex
	)

Returns the indexes of the vertices before and after the given vertex index.

This function takes into account the following factors:

If the given vertex index is at the end of a linestring, the adjacent index will be -1 (for "no adjacent vertex")
If the given vertex index is at the end of a linear ring (such as in a polygon), the adjacent index will take into account the first vertex is equal to the last vertex (and will skip equal vertex positions).

Definition at line 1011 of file qgsgeometry.cpp.

References exportGeosToWkb(), mDirtyWkb, mGeometry, QgsDebugMsg, QGis::WKBLineString, QGis::WKBLineString25D, QGis::WKBMultiLineString, QGis::WKBMultiLineString25D, QGis::WKBMultiPoint, QGis::WKBMultiPoint25D, QGis::WKBMultiPolygon, QGis::WKBMultiPolygon25D, QGis::WKBPoint, QGis::WKBPolygon, QGis::WKBPolygon25D, and wkbType().

double QgsGeometry::area ( )

get area of geometry using GEOS

Note: added in 1.5

Definition at line 6351 of file qgsgeometry.cpp.

References CATCH_GEOS, exportWkbToGeos(), mDirtyGeos, and mGeos.

Referenced by QgsPalLayerSettings::checkMinimumSizeMM(), and QgsZonalStatistics::statisticsFromPreciseIntersection().

QList< QgsGeometry * > QgsGeometry::asGeometryCollection ( ) const

return contents of the geometry as a list of geometries

Note: added in version 1.1

Definition at line 6643 of file qgsgeometry.cpp.

References exportWkbToGeos(), fromGeosGeom(), mDirtyGeos, mGeos, QgsDebugMsg, and QgsGeometry().

Referenced by QgsGeometryAnalyzer::addEventLayerFeature(), and QgsGeometryAnalyzer::createOffsetGeometry().

const GEOSGeometry * QgsGeometry::asGeos ( ) const

Returns a geos geomtry.

QgsGeometry keeps ownership, don't delete the returned object!

Note: this method was added in version 1.1; not available in python bindings

Definition at line 629 of file qgsgeometry.cpp.

References exportWkbToGeos(), mDirtyGeos, and mGeos.

Referenced by isGeosEmpty(), isGeosValid(), QgsPalLabeling::registerDiagramFeature(), QgsPalLayerSettings::registerFeature(), QgsGeometryValidator::run(), and QgsZonalStatistics::statisticsFromMiddlePointTest().

QgsMultiPoint QgsGeometry::asMultiPoint ( ) const

return contents of the geometry as a multi point if wkbType is WKBMultiPoint, otherwise an empty list

Definition at line 6286 of file qgsgeometry.cpp.

References asPoint(), mGeometry, QGis::WKBMultiPoint, QGis::WKBMultiPoint25D, and wkbType().

Referenced by QgsRubberBand::addGeometry(), deletePart(), and QgsHighlight::paint().

QgsMultiPolygon QgsGeometry::asMultiPolygon ( ) const

return contents of the geometry as a multi polygon if wkbType is WKBMultiPolygon, otherwise an empty list

Definition at line 6329 of file qgsgeometry.cpp.

References asPolygon(), mGeometry, QGis::WKBMultiPolygon, QGis::WKBMultiPolygon25D, and wkbType().

Referenced by QgsRubberBand::addGeometry(), QgsVectorLayerEditUtils::addTopologicalPoints(), deletePart(), deleteRing(), QgsHighlight::paint(), QgsGeometryAnalyzer::perimeterMeasure(), and QgsGeometryValidator::run().

QgsMultiPolyline QgsGeometry::asMultiPolyline ( ) const

return contents of the geometry as a multi linestring if wkbType is WKBMultiLineString, otherwise an empty list

Definition at line 6307 of file qgsgeometry.cpp.

References asPolyline(), mGeometry, QGis::WKBMultiLineString, QGis::WKBMultiLineString25D, and wkbType().

Referenced by QgsRubberBand::addGeometry(), QgsVectorLayerEditUtils::addTopologicalPoints(), deletePart(), QgsHighlight::paint(), and QgsGeometryValidator::run().

QgsPoint QgsGeometry::asPoint ( ) const

return contents of the geometry as a point if wkbType is WKBPoint, otherwise returns [0,0]

Definition at line 6256 of file qgsgeometry.cpp.

References mGeometry, QGis::WKBPoint, QGis::WKBPoint25D, and wkbType().

Referenced by QgsRubberBand::addGeometry(), asMultiPoint(), QgsPointDisplacementRenderer::createDisplacementGroups(), QgsMapToolIdentify::featureDerivedAttributes(), QgsHighlight::paint(), QgsGeometryAnalyzer::simpleMeasure(), and QgsMapCanvasSnapper::snapToBackgroundLayers().

QgsPoint QgsGeometry::asPoint	(	unsigned char *&	ptr,
		bool	hasZValue
	)		const

private

return point from wkb

Definition at line 6173 of file qgsgeometry.cpp.

QgsPolygon QgsGeometry::asPolygon ( ) const

return contents of the geometry as a polygon if wkbType is WKBPolygon, otherwise an empty list

Definition at line 6276 of file qgsgeometry.cpp.

References mGeometry, QGis::WKBPolygon, QGis::WKBPolygon25D, and wkbType().

Referenced by QgsRubberBand::addGeometry(), QgsVectorLayerEditUtils::addTopologicalPoints(), asMultiPolygon(), deleteRing(), QgsHighlight::paint(), QgsGeometryAnalyzer::perimeterMeasure(), and QgsGeometryValidator::run().

QgsPolygon QgsGeometry::asPolygon	(	unsigned char *&	ptr,
		bool	hasZValue
	)		const

private

return polygon from wkb

Definition at line 6214 of file qgsgeometry.cpp.

QgsPolyline QgsGeometry::asPolyline ( ) const

return contents of the geometry as a polyline if wkbType is WKBLineString, otherwise an empty list

Definition at line 6266 of file qgsgeometry.cpp.

References mGeometry, QGis::WKBLineString, QGis::WKBLineString25D, and wkbType().

Referenced by QgsRubberBand::addGeometry(), QgsVectorLayerEditUtils::addTopologicalPoints(), asMultiPolyline(), QgsMapToolIdentify::featureDerivedAttributes(), QgsHighlight::paint(), and QgsGeometryValidator::run().

QgsPolyline QgsGeometry::asPolyline	(	unsigned char *&	ptr,
		bool	hasZValue
	)		const

private

return polyline from wkb

Definition at line 6187 of file qgsgeometry.cpp.

const unsigned char * QgsGeometry::asWkb ( ) const

Returns the buffer containing this geometry in WKB format.

You may wish to use in conjunction with wkbSize().

Definition at line 608 of file qgsgeometry.cpp.

References exportGeosToWkb(), mDirtyWkb, and mGeometry.

Referenced by QgsInterpolator::addVerticesToCache(), QgsVectorFileWriter::createFeature(), QgsGeometryAnalyzer::dissolveFeature(), QgsOgcUtils::geometryToGML(), QgsTINInterpolator::insertData(), QgsLabel::labelPoint(), QgsGeometryAnalyzer::locateAlongMeasure(), QgsGeometryAnalyzer::locateBetweenMeasures(), QgsDistanceArea::measure(), QgsDistanceArea::measurePerimeter(), QgsPointDisplacementRenderer::renderFeature(), QgsFeatureRendererV2::renderFeatureWithSymbol(), and wkbType().

int QgsGeometry::avoidIntersections ( QMap< QgsVectorLayer *, QSet< QgsFeatureId > > ignoreFeatures = ( QMap<QgsVectorLayer*, QSet<QgsFeatureId> >() ) )

Modifies geometry to avoid intersections with the layers specified in project properties.

Returns: 0 in case of success, 1 if geometry is not of polygon type, 2 if avoid intersection would change the geometry type, 3 other error during intersection removal

Parameters

ignoreFeatures possibility to give a list of features where intersections should be ignored (not available in python bindings)

Note: added in 1.5

Definition at line 6796 of file qgsgeometry.cpp.

References QgsMapLayerRegistry::instance(), QgsProject::instance(), QgsMapLayerRegistry::mapLayer(), QGis::Polygon, QgsProject::readListEntry(), QgsVectorLayer::removePolygonIntersections(), type(), and wkbType().

QgsRectangle QgsGeometry::boundingBox ( )

Returns the bounding box of this feature.

Definition at line 3582 of file qgsgeometry.cpp.

References exportGeosToWkb(), MathUtils::max(), mDirtyWkb, mGeometry, QgsDebugMsg, QgsRectangle::setMinimal(), QGis::WKBLineString, QGis::WKBLineString25D, QGis::WKBMultiLineString, QGis::WKBMultiLineString25D, QGis::WKBMultiPoint, QGis::WKBMultiPoint25D, QGis::WKBMultiPolygon, QGis::WKBMultiPolygon25D, QGis::WKBPoint, QGis::WKBPoint25D, QGis::WKBPolygon, QGis::WKBPolygon25D, and wkbType().

Referenced by QgsVectorLayer::boundingBoxOfSelected(), QgsGml::calculateExtentFromFeatures(), QgsZonalStatistics::calculateStatistics(), QgsVectorLayer::extent(), QgsSpatialIndex::featureInfo(), QgsOverlayAnalyzer::intersectFeature(), QgsVectorLayer::removePolygonIntersections(), QgsVectorLayer::snapWithContext(), and QgsHighlight::updateRect().

QgsGeometry * QgsGeometry::buffer	(	double	distance,
		int	segments
	)

Returns a buffer region around this geometry having the given width and with a specified number of segments used to approximate curves.

Definition at line 6422 of file qgsgeometry.cpp.

References CATCH_GEOS, exportWkbToGeos(), fromGeosGeom(), mDirtyGeos, and mGeos.

Referenced by QgsGeometryAnalyzer::bufferFeature(), and fcnBuffer().

QgsGeometry * QgsGeometry::centroid ( )

Returns the center of mass of a geometry.

Note: for line based geometries, the center point of the line is returned, and for point based geometries, the point itself is returned

Definition at line 6457 of file qgsgeometry.cpp.

References CATCH_GEOS, exportWkbToGeos(), fromGeosGeom(), mDirtyGeos, and mGeos.

Referenced by QgsGeometryAnalyzer::centroidFeature(), and fcnCentroid().

double QgsGeometry::closestSegmentWithContext	(	const QgsPoint &	point,
		QgsPoint &	minDistPoint,
		int &	afterVertex,
		double *	leftOf = `0`,
		double	epsilon = `DEFAULT_SEGMENT_EPSILON`
	)

Searches for the closest segment of geometry to the given point.

Parameters

point	Specifies the point for search
minDistPoint	Receives the nearest point on the segment
afterVertex	Receives index of the vertex after the closest segment. The vertex before the closest segment is always afterVertex - 1
leftOf	Out: Returns if the point lies on the left of right side of the segment ( < 0 means left, > 0 means right )
epsilon	epsilon for segment snapping (added in 1.8)

Returns: The squared cartesian distance is also returned in sqrDist, negative number on error

Definition at line 2450 of file qgsgeometry.cpp.

References exportGeosToWkb(), leftOf(), MathUtils::max(), mDirtyWkb, mGeometry, QgsDebugMsg, QgsPoint::sqrDistToSegment(), QgsPoint::toString(), QGis::WKBLineString, QGis::WKBLineString25D, QGis::WKBMultiLineString, QGis::WKBMultiLineString25D, QGis::WKBMultiPoint, QGis::WKBMultiPoint25D, QGis::WKBMultiPolygon, QGis::WKBMultiPolygon25D, QGis::WKBPoint, QGis::WKBPoint25D, QGis::WKBPolygon, QGis::WKBPolygon25D, wkbType(), QGis::WKBUnknown, QgsPoint::x(), and QgsPoint::y().

Referenced by QgsGeometryAnalyzer::createPointOffset(), and QgsVectorLayer::snapToGeometry().

QgsPoint QgsGeometry::closestVertex	(	const QgsPoint &	point,
		int &	atVertex,
		int &	beforeVertex,
		int &	afterVertex,
		double &	sqrDist
	)

Returns the vertex closest to the given point, the corresponding vertex index, squared distance snap point / target point and the indices of the vertices before/after.

The vertices before/after are -1 if not present

Definition at line 733 of file qgsgeometry.cpp.

References exportGeosToWkb(), MathUtils::max(), mDirtyWkb, mGeometry, QgsDebugMsg, QgsPoint::sqrDist(), QGis::WKBLineString, QGis::WKBLineString25D, QGis::WKBMultiLineString, QGis::WKBMultiLineString25D, QGis::WKBMultiPoint, QGis::WKBMultiPoint25D, QGis::WKBMultiPolygon, QGis::WKBMultiPolygon25D, QGis::WKBPoint, QGis::WKBPoint25D, QGis::WKBPolygon, QGis::WKBPolygon25D, and wkbType().

Referenced by QgsVectorLayer::snapToGeometry().

double QgsGeometry::closestVertexWithContext	(	const QgsPoint &	point,
		int &	atVertex
	)

Searches for the closest vertex in this geometry to the given point.

Parameters

point	Specifiest the point for search
atVertex	Receives index of the closest vertex

Returns: The squared cartesian distance is also returned in sqrDist, negative number on error

Definition at line 2395 of file qgsgeometry.cpp.

References exportWkbToGeos(), QgsMessageLog::logMessage(), MathUtils::max(), mDirtyGeos, mGeos, QgsPoint::sqrDist(), tr, and GEOSException::what().

QgsGeometry * QgsGeometry::combine ( QgsGeometry * geometry )

Returns a geometry representing all the points in this geometry and other (a union geometry operation).

Note: this operation is not called union since its a reserved word in C++.

Definition at line 6544 of file qgsgeometry.cpp.

References CATCH_GEOS, exportWkbToGeos(), fromGeosGeom(), QGis::Line, mDirtyGeos, mGeos, QgsGeometry(), and type().

Referenced by QgsGeometryAnalyzer::bufferFeature(), QgsGeometryAnalyzer::convexFeature(), QgsGeometryAnalyzer::dissolveFeature(), and fcnCombine().

bool QgsGeometry::contains ( const QgsPoint * p ) const

Test for containment of a point (uses GEOS)

Definition at line 3892 of file qgsgeometry.cpp.

References createGeosPoint(), exportWkbToGeos(), QgsMessageLog::logMessage(), mGeos, QgsDebugMsg, tr, and GEOSException::what().

Referenced by fcnContains(), and QgsPalLayerSettings::registerFeature().

bool QgsGeometry::contains ( const QgsGeometry * geometry ) const

Test for if geometry is contained in an other (uses GEOS)

Note: added in 1.5

Definition at line 3944 of file qgsgeometry.cpp.

References geosRelOp().

bool QgsGeometry::convertToMultiType ( )

Converts single type geometry into multitype geometry e.g.

a polygon into a multipolygon geometry with one polygon

Returns: true in case of success and false else

Definition at line 5195 of file qgsgeometry.cpp.

References QgsApplication::endian(), mDirtyGeos, mGeometry, mGeometrySize, QGis::WKBLineString, QGis::WKBLineString25D, QGis::WKBMultiLineString, QGis::WKBMultiLineString25D, QGis::WKBMultiPoint, QGis::WKBMultiPoint25D, QGis::WKBMultiPolygon, QGis::WKBMultiPolygon25D, QGis::WKBPoint, QGis::WKBPoint25D, QGis::WKBPolygon, QGis::WKBPolygon25D, wkbType(), and QGis::WKBUnknown.

Referenced by addPart(), QgsVectorFileWriter::createFeature(), and makeDifference().

QgsGeometry * QgsGeometry::convexHull ( )

Returns the smallest convex polygon that contains all the points in the geometry.

Definition at line 6474 of file qgsgeometry.cpp.

References CATCH_GEOS, exportWkbToGeos(), fromGeosGeom(), mDirtyGeos, and mGeos.

Referenced by QgsGeometryAnalyzer::convexFeature(), QgsGeometryAnalyzer::convexHull(), and fcnConvexHull().

bool QgsGeometry::crosses ( const QgsGeometry * geometry ) const

Test for if geometry crosses an other (uses GEOS)

Note: added in 1.5

Definition at line 3974 of file qgsgeometry.cpp.

References geosRelOp().

Referenced by fcnCrosses().

bool QgsGeometry::deletePart ( int partNum )

delete part identified by the part number

Returns: true on success

Note: added in version 1.2

Definition at line 6733 of file qgsgeometry.cpp.

References asMultiPoint(), asMultiPolygon(), asMultiPolyline(), fromMultiPoint(), fromMultiPolygon(), fromMultiPolyline(), QGis::WKBMultiLineString, QGis::WKBMultiLineString25D, QGis::WKBMultiPoint, QGis::WKBMultiPoint25D, QGis::WKBMultiPolygon, QGis::WKBMultiPolygon25D, and wkbType().

bool QgsGeometry::deleteRing	(	int	ringNum,
		int	partNum = `0`
	)

delete a ring in polygon or multipolygon.

Ring 0 is outer ring and can't be deleted.

Returns: true on success

Note: added in version 1.2

Definition at line 6683 of file qgsgeometry.cpp.

References asMultiPolygon(), asPolygon(), fromMultiPolygon(), fromPolygon(), QGis::WKBMultiPolygon, QGis::WKBMultiPolygon25D, QGis::WKBPolygon, QGis::WKBPolygon25D, and wkbType().

bool QgsGeometry::deleteVertex ( int atVertex )

Deletes the vertex at the given position number and item (first number is index 0) Returns false if atVertex does not correspond to a valid vertex on this geometry (including if this geometry is a Point), or if the number of remaining verticies in the linestring would be less than two.

It is up to the caller to distinguish between these error conditions. (Or maybe we add another method to this object to help make the distinction?)

Definition at line 1541 of file qgsgeometry.cpp.

References exportGeosToWkb(), mDirtyGeos, mDirtyWkb, mGeometry, mGeometrySize, QgsDebugMsg, QGis::WKBLineString, QGis::WKBLineString25D, QGis::WKBMultiLineString, QGis::WKBMultiLineString25D, QGis::WKBMultiPoint, QGis::WKBMultiPoint25D, QGis::WKBMultiPolygon, QGis::WKBMultiPolygon25D, QGis::WKBNoGeometry, QGis::WKBPoint, QGis::WKBPoint25D, QGis::WKBPolygon, QGis::WKBPolygon25D, wkbType(), and QGis::WKBUnknown.

Referenced by QgsVectorLayerEditUtils::deleteVertex().

QgsGeometry * QgsGeometry::difference ( QgsGeometry * geometry )

Returns a geometry representing the points making up this geometry that do not make up other.

Definition at line 6587 of file qgsgeometry.cpp.

References CATCH_GEOS, exportWkbToGeos(), fromGeosGeom(), mDirtyGeos, and mGeos.

Referenced by fcnDifference().

bool QgsGeometry::disjoint ( const QgsGeometry * geometry ) const

Test for if geometry is disjoint of an other (uses GEOS)

Note: added in 1.5

Definition at line 3949 of file qgsgeometry.cpp.

References geosRelOp().

Referenced by fcnDisjoint().

double QgsGeometry::distance ( QgsGeometry & geom )

Definition at line 6396 of file qgsgeometry.cpp.

References CATCH_GEOS, exportWkbToGeos(), mDirtyGeos, and mGeos.

Referenced by fcnDistance().

bool QgsGeometry::equals ( const QgsGeometry * geometry ) const

Test for if geometry equals an other (uses GEOS)

Note: added in 1.5

Definition at line 3954 of file qgsgeometry.cpp.

References geosRelOp().

bool QgsGeometry::exportGeosToWkb ( ) const

private

Converts from the GEOS geometry to the WKB geometry.

Returns: true in case of success and false else

Definition at line 4800 of file qgsgeometry.cpp.

References QgsApplication::endian(), getNumGeosPoints(), mDirtyWkb, mGeometry, mGeometrySize, mGeos, QgsDebugMsg, QGis::WKBLineString, QGis::WKBMultiLineString, QGis::WKBMultiPoint, QGis::WKBMultiPolygon, QGis::WKBPoint, QGis::WKBPolygon, and wkbType().

Referenced by adjacentVertices(), asWkb(), boundingBox(), closestSegmentWithContext(), closestVertex(), deleteVertex(), exportToGeoJSON(), exportToWkt(), insertVertex(), isMultipart(), moveVertex(), splitGeometry(), transform(), translate(), type(), vertexAt(), and wkbSize().

QString QgsGeometry::exportToGeoJSON ( ) const

Exports the geometry to mGeoJSON.

Returns: true in case of success and false else

Note: added in 1.8; python binding added in 1.9

Definition at line 4259 of file qgsgeometry.cpp.

References exportGeosToWkb(), mDirtyWkb, mGeometry, QgsDebugMsg, qgsDoubleToString(), QGis::WKBLineString, QGis::WKBLineString25D, QGis::WKBMultiLineString, QGis::WKBMultiLineString25D, QGis::WKBMultiPoint, QGis::WKBMultiPoint25D, QGis::WKBMultiPolygon, QGis::WKBMultiPolygon25D, QGis::WKBPoint, QGis::WKBPoint25D, QGis::WKBPolygon, QGis::WKBPolygon25D, and wkbType().

QString QgsGeometry::exportToWkt ( ) const

Exports the geometry to mWkt.

Returns: true in case of success and false else

Definition at line 3979 of file qgsgeometry.cpp.

References exportGeosToWkb(), mDirtyWkb, mGeometry, QgsDebugMsg, qgsDoubleToString(), QGis::WKBLineString, QGis::WKBLineString25D, QGis::WKBMultiLineString, QGis::WKBMultiLineString25D, QGis::WKBMultiPoint, QGis::WKBMultiPoint25D, QGis::WKBMultiPolygon, QGis::WKBMultiPolygon25D, QGis::WKBPoint, QGis::WKBPoint25D, QGis::WKBPolygon, QGis::WKBPolygon25D, wkbSize(), and wkbType().

Referenced by QgsOfflineEditing::committedGeometriesChanges(), and fcnGeomToWKT().

bool QgsGeometry::exportWkbToGeos ( ) const

private

Converts from the WKB geometry to the GEOS geometry.

Returns: true in case of success and false else

Definition at line 4550 of file qgsgeometry.cpp.

References CATCH_GEOS, createGeosCollection(), createGeosLinearRing(), createGeosLineString(), createGeosPoint(), createGeosPolygon(), mDirtyGeos, mGeometry, mGeos, QgsDebugMsgLevel, QGis::WKBLineString, QGis::WKBLineString25D, QGis::WKBMultiLineString, QGis::WKBMultiLineString25D, QGis::WKBMultiPoint, QGis::WKBMultiPoint25D, QGis::WKBMultiPolygon, QGis::WKBMultiPolygon25D, QGis::WKBPoint, QGis::WKBPoint25D, QGis::WKBPolygon, and QGis::WKBPolygon25D.

Referenced by addPart(), addRing(), area(), asGeometryCollection(), asGeos(), buffer(), centroid(), closestVertexWithContext(), combine(), contains(), convexHull(), difference(), distance(), geosRelOp(), interpolate(), intersection(), intersects(), length(), makeDifference(), mergeGeometriesMultiTypeSplit(), reshapeGeometry(), simplify(), splitGeometry(), splitLinearGeometry(), splitPolygonGeometry(), and symDifference().

void QgsGeometry::fromGeos ( GEOSGeometry * geos )

Set the geometry, feeding in a geometry in GEOS format.

This class will take ownership of the buffer.

Note: not available in python bindings

Definition at line 712 of file qgsgeometry.cpp.

References mDirtyGeos, mDirtyWkb, mGeometry, and mGeos.

Referenced by QgsGeometryAnalyzer::createOffsetGeometry(), and fromGeosGeom().

QgsGeometry * QgsGeometry::fromMultiPoint ( const QgsMultiPoint & multipoint )

static

construct geometry from a multipoint

Definition at line 467 of file qgsgeometry.cpp.

References createGeosCollection(), createGeosPoint(), fromGeosGeom(), QgsMessageLog::logMessage(), tr, and GEOSException::what().

Referenced by QgsRubberBand::asGeometry(), deletePart(), and QgsGeometryAnalyzer::locateAlongMeasure().

QgsGeometry * QgsGeometry::fromMultiPolygon ( const QgsMultiPolygon & multipoly )

static

construct geometry from a multipolygon

Definition at line 513 of file qgsgeometry.cpp.

References createGeosCollection(), createGeosPolygon(), fromGeosGeom(), QgsMessageLog::logMessage(), tr, and GEOSException::what().

Referenced by deletePart(), and deleteRing().

QgsGeometry * QgsGeometry::fromMultiPolyline ( const QgsMultiPolyline & multiline )

static

construct geometry from a multipolyline

Definition at line 491 of file qgsgeometry.cpp.

References createGeosCollection(), createGeosLineString(), fromGeosGeom(), QgsMessageLog::logMessage(), tr, and GEOSException::what().

Referenced by QgsRubberBand::asGeometry(), deletePart(), and QgsGeometryAnalyzer::locateBetweenMeasures().

QgsGeometry * QgsGeometry::fromPoint ( const QgsPoint & point )

static

construct geometry from a point

Definition at line 452 of file qgsgeometry.cpp.

References createGeosPoint(), and fromGeosGeom().

QgsGeometry * QgsGeometry::fromPolygon ( const QgsPolygon & polygon )

static

construct geometry from a polygon

Definition at line 462 of file qgsgeometry.cpp.

References createGeosPolygon(), and fromGeosGeom().

Referenced by QgsRubberBand::asGeometry(), deleteRing(), and fromRect().

QgsGeometry * QgsGeometry::fromPolyline ( const QgsPolyline & polyline )

static

construct geometry from a polyline

Definition at line 457 of file qgsgeometry.cpp.

References createGeosLineString(), and fromGeosGeom().

Referenced by QgsRubberBand::asGeometry(), QgsGeometryAnalyzer::perimeterMeasure(), and QgsMapCanvasSnapper::snapToBackgroundLayers().

QgsGeometry * QgsGeometry::fromRect ( const QgsRectangle & rect )

static

construct geometry from a rectangle

Definition at line 538 of file qgsgeometry.cpp.

References fromPolygon(), QgsRectangle::xMaximum(), QgsRectangle::xMinimum(), QgsRectangle::yMaximum(), and QgsRectangle::yMinimum().

Referenced by QgsGml::endElement(), QgsGeometryAnalyzer::extent(), QgsOgcUtils::geometryFromGML(), intersects(), QgsPalLabeling::prepareLayer(), and QgsZonalStatistics::statisticsFromPreciseIntersection().

void QgsGeometry::fromWkb	(	unsigned char *	wkb,
		size_t	length
	)

Set the geometry, feeding in the buffer containing OGC Well-Known Binary and the buffer's length.

This class will take ownership of the buffer.

Definition at line 587 of file qgsgeometry.cpp.

References length(), mDirtyGeos, mDirtyWkb, mGeometry, mGeometrySize, and mGeos.

Referenced by QgsOgcUtils::geometryFromGMLLineString(), QgsOgcUtils::geometryFromGMLMultiLineString(), QgsOgcUtils::geometryFromGMLMultiPoint(), QgsOgcUtils::geometryFromGMLMultiPolygon(), QgsOgcUtils::geometryFromGMLPoint(), QgsOgcUtils::geometryFromGMLPolygon(), and QgsFeature::setGeometryAndOwnership().

QgsGeometry * QgsGeometry::fromWkt ( QString wkt )

static

static method that creates geometry from Wkt

Definition at line 432 of file qgsgeometry.cpp.

References fromGeosGeom(), QgsMessageLog::logMessage(), tr, and GEOSException::what().

Referenced by QgsOfflineEditing::applyGeometryChanges(), QgsOgcUtils::expressionFunctionToOgcFilter(), and fcnGeomFromWKT().

bool QgsGeometry::geomInDegrees ( const GEOSGeometry * geom )

staticprivate

Tests if geom bounding rect is within -180 <= x <= 180, -90 <= y <= 90.

Other methods may use more accurate tolerances if this is true

Definition at line 6027 of file qgsgeometry.cpp.

Referenced by lineContainedInLine(), and pointContainedInLine().

bool QgsGeometry::geosRelOp	(	char()(const GEOSGeometry , const GEOSGeometry *)	op,
		const QgsGeometry *	a,
		const QgsGeometry *	b
	)

staticprivate

Definition at line 3923 of file qgsgeometry.cpp.

References CATCH_GEOS, exportWkbToGeos(), mGeos, and QgsDebugMsg.

Referenced by contains(), crosses(), disjoint(), equals(), isGeosEqual(), overlaps(), touches(), and within().

bool QgsGeometry::insertVertex	(	double	x,
		double	y,
		int	beforeVertex
	)

Insert a new vertex before the given vertex index, ring and item (first number is index 0) If the requested vertex number (beforeVertex.back()) is greater than the last actual vertex on the requested ring and item, it is assumed that the vertex is to be appended instead of inserted.

Returns false if atVertex does not correspond to a valid vertex on this geometry (including if this geometry is a Point). It is up to the caller to distinguish between these error conditions. (Or maybe we add another method to this object to help make the distinction?)

Definition at line 1870 of file qgsgeometry.cpp.

References exportGeosToWkb(), mDirtyGeos, mDirtyWkb, mGeometry, mGeometrySize, QgsDebugMsg, QGis::WKBLineString, QGis::WKBLineString25D, QGis::WKBMultiLineString, QGis::WKBMultiLineString25D, QGis::WKBMultiPoint, QGis::WKBMultiPoint25D, QGis::WKBMultiPolygon, QGis::WKBMultiPolygon25D, QGis::WKBNoGeometry, QGis::WKBPoint, QGis::WKBPoint25D, QGis::WKBPolygon, QGis::WKBPolygon25D, wkbType(), and QGis::WKBUnknown.

Referenced by QgsVectorLayerEditUtils::insertVertex().

bool QgsGeometry::insertVertex	(	double	x,
		double	y,
		int	beforeVertex,
		const GEOSCoordSequence *	old_sequence,
		GEOSCoordSequence **	new_sequence
	)

private

Insert a new vertex before the given vertex index (first number is index 0) in the given GEOS Coordinate Sequence.

If the requested vertex number is greater than the last actual vertex, it is assumed that the vertex is to be appended instead of inserted.

Parameters

x	x coordinate
y	y coordinate
beforeVertex	insert before vertex with this index
old_sequence	The sequence to update (The caller remains the owner).
new_sequence	The updated sequence (The caller becomes the owner if the function returns true). Returns false if beforeVertex does not correspond to a valid vertex number on the Coordinate Sequence.

Definition at line 1240 of file qgsgeometry.cpp.

QgsGeometry * QgsGeometry::interpolate ( double distance )

Definition at line 6492 of file qgsgeometry.cpp.

References CATCH_GEOS, exportWkbToGeos(), fromGeosGeom(), QgsMessageLog::logMessage(), mDirtyGeos, mGeos, and tr.

QgsGeometry * QgsGeometry::intersection ( QgsGeometry * geometry )

Returns a geometry representing the points shared by this geometry and other.

Definition at line 6515 of file qgsgeometry.cpp.

References CATCH_GEOS, exportWkbToGeos(), fromGeosGeom(), mDirtyGeos, and mGeos.

Referenced by fcnIntersection(), QgsOverlayAnalyzer::intersectFeature(), QgsPalLayerSettings::registerFeature(), QgsMapCanvasSnapper::snapToBackgroundLayers(), and QgsZonalStatistics::statisticsFromPreciseIntersection().

bool QgsGeometry::intersects ( const QgsRectangle & r ) const

Test for intersection with a rectangle (uses GEOS)

Definition at line 3864 of file qgsgeometry.cpp.

References fromRect().

Referenced by fcnBbox(), fcnIntersects(), and QgsOverlayAnalyzer::intersectFeature().

bool QgsGeometry::intersects ( const QgsGeometry * geometry ) const

Test for intersection with a geometry (uses GEOS)

Definition at line 3872 of file qgsgeometry.cpp.

References CATCH_GEOS, exportWkbToGeos(), mGeos, and QgsDebugMsg.

bool QgsGeometry::isGeosEmpty ( )

check if geometry is empty using GEOS

Note: added in 1.5

Definition at line 6875 of file qgsgeometry.cpp.

References asGeos(), QgsMessageLog::logMessage(), tr, and GEOSException::what().

bool QgsGeometry::isGeosEqual ( QgsGeometry & g )

compare geometries using GEOS

Note: added in 1.5

Definition at line 6870 of file qgsgeometry.cpp.

References geosRelOp().

Referenced by QgsVectorLayer::updateFeature().

bool QgsGeometry::isGeosValid ( )

check validity using GEOS

Note: added in 1.5

Definition at line 6852 of file qgsgeometry.cpp.

References asGeos(), QgsMessageLog::logMessage(), tr, and GEOSException::what().

bool QgsGeometry::isMultipart ( )

Returns true if wkb of the geometry is of WKBMulti* type.

Definition at line 691 of file qgsgeometry.cpp.

References exportGeosToWkb(), mDirtyWkb, QGis::WKBMultiLineString, QGis::WKBMultiLineString25D, QGis::WKBMultiPoint, QGis::WKBMultiPoint25D, QGis::WKBMultiPolygon, QGis::WKBMultiPolygon25D, and wkbType().

Referenced by addPart(), QgsGeometryAnalyzer::createOffsetGeometry(), makeDifference(), and QgsGeometryAnalyzer::perimeterMeasure().

double QgsGeometry::leftOf	(	double	x,
		double	y,
		double &	x1,
		double &	y1,
		double &	x2,
		double &	y2
	)

private

Returns < 0 if point(x/y) is left of the line x1,y1 -> x1,y2.

Definition at line 6893 of file qgsgeometry.cpp.

Referenced by closestSegmentWithContext().

double QgsGeometry::length ( )

get length of geometry using GEOS

Note: added in 1.5

Definition at line 6374 of file qgsgeometry.cpp.

References CATCH_GEOS, exportWkbToGeos(), mDirtyGeos, and mGeos.

Referenced by QgsPalLayerSettings::checkMinimumSizeMM(), and fromWkb().

int QgsGeometry::lineContainedInLine	(	const GEOSGeometry *	line1,
		const GEOSGeometry *	line2
	)

staticprivate

Tests if line1 is completely contained in line2.

This method works with a very small buffer around line2 and therefore is less prone to numerical errors as the corresponding geos method

Definition at line 5960 of file qgsgeometry.cpp.

References DEFAULT_QUADRANT_SEGMENTS, and geomInDegrees().

Referenced by reshapeLine().

int QgsGeometry::makeDifference ( QgsGeometry * other )

Changes this geometry such that it does not intersect the other geometry.

Parameters

other geometry that should not be intersect

Returns: 0 in case of success

Definition at line 3515 of file qgsgeometry.cpp.

References CATCH_GEOS, convertToMultiType(), exportWkbToGeos(), isMultipart(), mDirtyGeos, mDirtyWkb, and mGeos.

Referenced by QgsVectorLayer::removePolygonIntersections().

int QgsGeometry::mergeGeometriesMultiTypeSplit ( QVector< GEOSGeometry * > & splitResult )

private

Definition at line 6088 of file qgsgeometry.cpp.

References createGeosCollection(), exportWkbToGeos(), mDirtyGeos, and mGeos.

Referenced by splitLinearGeometry(), and splitPolygonGeometry().

bool QgsGeometry::moveVertex	(	double	x,
		double	y,
		int	atVertex
	)

Moves the vertex at the given position number and item (first number is index 0) to the given coordinates.

Returns false if atVertex does not correspond to a valid vertex on this geometry

Definition at line 1292 of file qgsgeometry.cpp.

References exportGeosToWkb(), mDirtyGeos, mDirtyWkb, mGeometry, QgsDebugMsg, QGis::WKBLineString, QGis::WKBLineString25D, QGis::WKBMultiLineString, QGis::WKBMultiLineString25D, QGis::WKBMultiPoint, QGis::WKBMultiPoint25D, QGis::WKBMultiPolygon, QGis::WKBMultiPolygon25D, QGis::WKBPoint, QGis::WKBPoint25D, QGis::WKBPolygon, QGis::WKBPolygon25D, and wkbType().

Referenced by QgsVectorLayerEditUtils::moveVertex().

GEOSGeometry * QgsGeometry::nodeGeometries	(	const GEOSGeometry *	splitLine,
		const GEOSGeometry *	poly
	)

staticprivate

Nodes together a split line and a (multi-) polygon geometry in a multilinestring.

Returns: the noded multiline geometry or 0 in case of error. The calling function takes ownership of the node geometry

Definition at line 5935 of file qgsgeometry.cpp.

Referenced by reshapeLine(), and splitPolygonGeometry().

int QgsGeometry::numberOfGeometries ( GEOSGeometry * g ) const

private

Returns number of single geometry in a geos geometry.

Is save for geos 2 and 3

Definition at line 6071 of file qgsgeometry.cpp.

Referenced by splitPolygonGeometry().

QgsGeometry & QgsGeometry::operator= ( QgsGeometry const & rhs )

assignments will prompt a deep copy of the object

Note: not available in python bindings

Definition at line 554 of file qgsgeometry.cpp.

References mDirtyGeos, mDirtyWkb, mGeometry, mGeometrySize, and mGeos.

bool QgsGeometry::overlaps ( const QgsGeometry * geometry ) const

Test for if geometry overlaps an other (uses GEOS)

Note: added in 1.5

Definition at line 3964 of file qgsgeometry.cpp.

References geosRelOp().

Referenced by fcnOverlaps().

int QgsGeometry::pointContainedInLine	(	const GEOSGeometry *	point,
		const GEOSGeometry *	line
	)

staticprivate

Tests if a point is on a line.

This method works with a very small buffer and is thus less prone to numerical problems as the direct geos functions.

Parameters

point	the point to test
line	line to test

Returns: 0 not contained, 1 if contained, <0 in case of error

Definition at line 5999 of file qgsgeometry.cpp.

References geomInDegrees().

Referenced by reshapeLine().

int QgsGeometry::reshapeGeometry ( const QList< QgsPoint > & reshapeWithLine )

Replaces a part of this geometry with another line.

Returns: 0 in case of success

Note: : this function was added in version 1.3

Definition at line 3386 of file qgsgeometry.cpp.

References createGeosLineString(), exportWkbToGeos(), QGis::Line, mDirtyGeos, mDirtyWkb, mGeos, QGis::Point, reshapeLine(), reshapePolygon(), and type().

GEOSGeometry * QgsGeometry::reshapeLine	(	const GEOSGeometry *	origLine,
		const GEOSGeometry *	reshapeLineGeos
	)

staticprivate

Creates a new line from an original line and a reshape line.

The part of the input line from the first to the last intersection with the reshape line will be replaced. The calling function takes ownership of the result.

Parameters

origLine	the original line
reshapeLineGeos	the reshape line

Returns: the reshaped line or 0 in case of error

Definition at line 5631 of file qgsgeometry.cpp.

References createGeosPoint(), lineContainedInLine(), QgsMessageLog::logMessage(), nodeGeometries(), pointContainedInLine(), tr, and GEOSException::what().

Referenced by reshapeGeometry(), and reshapePolygon().

GEOSGeometry * QgsGeometry::reshapePolygon	(	const GEOSGeometry *	polygon,
		const GEOSGeometry *	reshapeLineGeos
	)

staticprivate

Creates a new polygon replacing the part from the first to the second intersection with the reshape line.

As a polygon ring is always closed, the method keeps the longer part of the existing boundary

Parameters

polygon	geometry to reshape
reshapeLineGeos	the reshape line

Returns: the reshaped polygon or 0 in case of error

Definition at line 5498 of file qgsgeometry.cpp.

References QgsMessageLog::logMessage(), reshapeLine(), tr, and GEOSException::what().

Referenced by reshapeGeometry().

QgsGeometry * QgsGeometry::simplify ( double tolerance )

Returns a simplified version of this geometry using a specified tolerance value.

Definition at line 6440 of file qgsgeometry.cpp.

References CATCH_GEOS, exportWkbToGeos(), fromGeosGeom(), mDirtyGeos, and mGeos.

Referenced by QgsGeometryAnalyzer::simplifyFeature().

int QgsGeometry::splitGeometry	(	const QList< QgsPoint > &	splitLine,
		QList< QgsGeometry * > &	newGeometries,
		bool	topological,
		QList< QgsPoint > &	topologyTestPoints
	)

Splits this geometry according to a given line.

Note that the geometry is only split once. If there are several intersections between geometry and splitLine, only the first one is considered.

Parameters

	splitLine	the line that splits the geometry
[out]	newGeometries	list of new geometries that have been created with the split
	topological	true if topological editing is enabled
[out]	topologyTestPoints	points that need to be tested for topological completeness in the dataset

Returns: 0 in case of success, 1 if geometry has not been split, error else

Definition at line 3307 of file qgsgeometry.cpp.

References CATCH_GEOS, createGeosLineString(), exportGeosToWkb(), exportWkbToGeos(), QGis::Line, mDirtyGeos, mDirtyWkb, mGeos, QGis::Point, QGis::Polygon, splitLinearGeometry(), splitPolygonGeometry(), topologicalTestPointsSplit(), and type().

Referenced by QgsVectorLayerEditUtils::splitFeatures().

int QgsGeometry::splitLinearGeometry	(	GEOSGeometry *	splitLine,
		QList< QgsGeometry * > &	newGeometries
	)

private

Splits line/multiline geometries.

Parameters

splitLine	the line that splits the feature
newGeometries	new geometries if splitting was successful

Returns: 0 in case of success, 1 if geometry has not been split, error else

Definition at line 5312 of file qgsgeometry.cpp.

References exportWkbToGeos(), fromGeosGeom(), mDirtyGeos, mDirtyWkb, mergeGeometriesMultiTypeSplit(), and mGeos.

Referenced by splitGeometry().

int QgsGeometry::splitPolygonGeometry	(	GEOSGeometry *	splitLine,
		QList< QgsGeometry * > &	newGeometries
	)

private

Splits polygon/multipolygon geometries.

Returns: 0 in case of success, 1 if geometry has not been split, error else

Definition at line 5377 of file qgsgeometry.cpp.

References exportWkbToGeos(), fromGeosGeom(), mDirtyGeos, mDirtyWkb, mergeGeometriesMultiTypeSplit(), mGeos, nodeGeometries(), numberOfGeometries(), and QgsDebugMsg.

Referenced by splitGeometry().

double QgsGeometry::sqrDistToVertexAt	(	QgsPoint &	point,
		int	atVertex
	)

Returns the squared cartesian distance between the given point to the given vertex index (vertex at the given position number, ring and item (first number is index 0))

Definition at line 2378 of file qgsgeometry.cpp.

References MathUtils::max(), QgsDebugMsg, QgsPoint::sqrDist(), QgsPoint::toString(), and vertexAt().

QgsGeometry * QgsGeometry::symDifference ( QgsGeometry * geometry )

Returns a Geometry representing the points making up this Geometry that do not make up other.

Definition at line 6615 of file qgsgeometry.cpp.

References CATCH_GEOS, exportWkbToGeos(), fromGeosGeom(), mDirtyGeos, and mGeos.

Referenced by fcnSymDifference().

int QgsGeometry::topologicalTestPointsSplit	(	const GEOSGeometry *	splitLine,
		QList< QgsPoint > &	testPoints
	)		const

private

Finds out the points that need to be tested for topological correctnes if this geometry will be split.

Returns: 0 in case of success

Definition at line 5877 of file qgsgeometry.cpp.

References mGeos.

Referenced by splitGeometry().

bool QgsGeometry::touches ( const QgsGeometry * geometry ) const

Test for if geometry touch an other (uses GEOS)

Note: added in 1.5

Definition at line 3959 of file qgsgeometry.cpp.

References geosRelOp().

Referenced by fcnTouches().

int QgsGeometry::transform ( const QgsCoordinateTransform & ct )

Transform this geometry as described by CoordinateTranasform ct.

Returns: 0 in case of success

Definition at line 3181 of file qgsgeometry.cpp.

References exportGeosToWkb(), mDirtyGeos, mDirtyWkb, mGeometry, QgsDebugMsg, transformVertex(), QGis::WKBLineString, QGis::WKBLineString25D, QGis::WKBMultiLineString, QGis::WKBMultiLineString25D, QGis::WKBMultiPoint, QGis::WKBMultiPoint25D, QGis::WKBMultiPolygon, QGis::WKBMultiPolygon25D, QGis::WKBPoint, QGis::WKBPoint25D, QGis::WKBPolygon, QGis::WKBPolygon25D, and wkbType().

Referenced by QgsVectorFileWriter::exportFeaturesSymbolLevels(), QgsVectorLayerImport::importLayer(), QgsAtlasComposition::prepareForFeature(), QgsHighlight::QgsHighlight(), QgsPalLabeling::registerDiagramFeature(), QgsPalLayerSettings::registerFeature(), and QgsVectorFileWriter::writeAsVectorFormat().

void QgsGeometry::transformVertex	(	int &	wkbPosition,
		const QgsCoordinateTransform &	ct,
		bool	hasZValue
	)

private

Transforms a single vertex by ct.

Parameters

wkbPosition	position in wkb array. Is increased automatically by the function
ct	the QgsCoordinateTransform
hasZValue	25D type?

Definition at line 5287 of file qgsgeometry.cpp.

References mGeometry, and QgsCoordinateTransform::transformInPlace().

Referenced by transform().

int QgsGeometry::translate	(	double	dx,
		double	dy
	)

Translate this geometry by dx, dy.

Returns: 0 in case of success

Definition at line 3055 of file qgsgeometry.cpp.

References exportGeosToWkb(), mDirtyGeos, mDirtyWkb, mGeometry, QgsDebugMsg, translateVertex(), QGis::WKBLineString, QGis::WKBLineString25D, QGis::WKBMultiLineString, QGis::WKBMultiLineString25D, QGis::WKBMultiPoint, QGis::WKBMultiPoint25D, QGis::WKBMultiPolygon, QGis::WKBMultiPolygon25D, QGis::WKBPoint, QGis::WKBPoint25D, QGis::WKBPolygon, QGis::WKBPolygon25D, and wkbType().

Referenced by QgsVectorLayerEditUtils::translateFeature().

void QgsGeometry::translateVertex	(	int &	wkbPosition,
		double	dx,
		double	dy,
		bool	hasZValue
	)

private

Translates a single vertex by dx and dy.

Parameters

wkbPosition	position in wkb array. Is increased automatically by the function
dx	translation of x-coordinate
dy	translation of y-coordinate
hasZValue	25D type?

Definition at line 5265 of file qgsgeometry.cpp.

References mGeometry.

Referenced by translate().

QGis::GeometryType QgsGeometry::type ( )

Returns type of the vector.

Definition at line 658 of file qgsgeometry.cpp.

References exportGeosToWkb(), QGis::Line, mDirtyWkb, QGis::Point, QGis::Polygon, QGis::UnknownGeometry, QGis::WKBLineString, QGis::WKBLineString25D, QGis::WKBMultiLineString, QGis::WKBMultiLineString25D, QGis::WKBMultiPoint, QGis::WKBMultiPoint25D, QGis::WKBMultiPolygon, QGis::WKBMultiPolygon25D, QGis::WKBPoint, QGis::WKBPoint25D, QGis::WKBPolygon, QGis::WKBPolygon25D, and wkbType().