QgsOgcUtils Class Reference

The QgsOgcUtils class provides various utility functions for conversion between OGC (Open Geospatial Consortium) standards and QGIS internal representations. More...

#include <qgsogcutils.h>

Static Public Member Functions
static QgsGeometry *	geometryFromGML (const QString &xmlString)
	static method that creates geometry from GML
static QgsGeometry *	geometryFromGML (const QDomNode &geometryNode)
	static method that creates geometry from GML
static QgsRectangle	rectangleFromGMLBox (const QDomNode &boxNode)
	read rectangle from GML2 Box
static QgsRectangle	rectangleFromGMLEnvelope (const QDomNode &envelopeNode)
	read rectangle from GML3 Envelope
static QDomElement	geometryToGML (QgsGeometry *geometry, QDomDocument &doc, QString format)
	Exports the geometry to GML2 or GML3.
static QDomElement	geometryToGML (QgsGeometry *geometry, QDomDocument &doc)
	Exports the geometry to GML2.
static QDomElement	rectangleToGMLBox (QgsRectangle *box, QDomDocument &doc)
	Exports the rectangle to GML2 Box.
static QDomElement	rectangleToGMLEnvelope (QgsRectangle *env, QDomDocument &doc)
	Exports the rectangle to GML2 Envelope.
static QgsExpression *	expressionFromOgcFilter (const QDomElement &element)
	Parse XML with OGC filter into QGIS expression.
static QDomElement	expressionToOgcFilter (const QgsExpression &exp, QDomDocument &doc, QString *errorMessage=0)
	Creates OGC filter XML element.

Static Private Member Functions
static QgsGeometry *	geometryFromGMLPoint (const QDomElement &geometryElement)
	static method that creates geometry from GML Point
static QgsGeometry *	geometryFromGMLLineString (const QDomElement &geometryElement)
	static method that creates geometry from GML LineString
static QgsGeometry *	geometryFromGMLPolygon (const QDomElement &geometryElement)
	static method that creates geometry from GML Polygon
static QgsGeometry *	geometryFromGMLMultiPoint (const QDomElement &geometryElement)
	static method that creates geometry from GML MultiPoint
static QgsGeometry *	geometryFromGMLMultiLineString (const QDomElement &geometryElement)
	static method that creates geometry from GML MultiLineString
static QgsGeometry *	geometryFromGMLMultiPolygon (const QDomElement &geometryElement)
	static method that creates geometry from GML MultiPolygon
static bool	readGMLCoordinates (QgsPolyline &coords, const QDomElement elem)
	Reads the.
static bool	readGMLPositions (QgsPolyline &coords, const QDomElement elem)
	Reads the.
static QDomElement	createGMLCoordinates (const QgsPolyline &points, QDomDocument &doc)
	Create a GML coordinates element from a point list.
static QDomElement	createGMLPositions (const QgsPolyline &points, QDomDocument &doc)
	Create a GML pos or posList element from a point list.
static QgsExpression::Node *	nodeFromOgcFilter (QDomElement &element, QString &errorMessage)
	handle a generic sub-expression
static QgsExpression::NodeBinaryOperator *	nodeBinaryOperatorFromOgcFilter (QDomElement &element, QString &errorMessage)
	handle a generic binary operator
static QgsExpression::NodeFunction *	nodeSpatialOperatorFromOgcFilter (QDomElement &element, QString &errorMessage)
	handles various spatial operation tags (
static QgsExpression::NodeUnaryOperator *	nodeNotFromOgcFilter (QDomElement &element, QString &errorMessage)
	handle
static QgsExpression::NodeFunction *	nodeFunctionFromOgcFilter (QDomElement &element, QString &errorMessage)
	handles
static QgsExpression::Node *	nodeLiteralFromOgcFilter (QDomElement &element, QString &errorMessage)
	handles
static QgsExpression::NodeColumnRef *	nodeColumnRefFromOgcFilter (QDomElement &element, QString &errorMessage)
	handles
static QgsExpression::Node *	nodeIsBetweenFromOgcFilter (QDomElement &element, QString &errorMessage)
	handles
static QgsExpression::NodeBinaryOperator *	nodePropertyIsNullFromOgcFilter (QDomElement &element, QString &errorMessage)
	handles
static QDomElement	expressionNodeToOgcFilter (const QgsExpression::Node *node, QDomDocument &doc, QString &errorMessage)
static QDomElement	expressionUnaryOperatorToOgcFilter (const QgsExpression::NodeUnaryOperator *node, QDomDocument &doc, QString &errorMessage)
static QDomElement	expressionBinaryOperatorToOgcFilter (const QgsExpression::NodeBinaryOperator *node, QDomDocument &doc, QString &errorMessage)
static QDomElement	expressionLiteralToOgcFilter (const QgsExpression::NodeLiteral *node, QDomDocument &doc, QString &errorMessage)
static QDomElement	expressionColumnRefToOgcFilter (const QgsExpression::NodeColumnRef *node, QDomDocument &doc, QString &errorMessage)
static QDomElement	expressionInOperatorToOgcFilter (const QgsExpression::NodeInOperator *node, QDomDocument &doc, QString &errorMessage)
static QDomElement	expressionFunctionToOgcFilter (const QgsExpression::NodeFunction *node, QDomDocument &doc, QString &errorMessage)

Detailed Description

The QgsOgcUtils class provides various utility functions for conversion between OGC (Open Geospatial Consortium) standards and QGIS internal representations.

Currently supported standards:

• GML2 - Geography Markup Language (import, export)

Note

added in 2.0

Definition at line 29 of file qgsogcutils.h.

Member Function Documentation

QDomElement QgsOgcUtils::createGMLCoordinates ( const QgsPolyline &  points, QDomDocument &  doc  )

staticprivate

Create a GML coordinates element from a point list.

Parameters

points	list of data points
doc	the GML document

Returns

QDomElement

Definition at line 1365 of file qgsogcutils.cpp.

References qgsDoubleToString().

QDomElement QgsOgcUtils::createGMLPositions ( const QgsPolyline &  points, QDomDocument &  doc  )

staticprivate

Create a GML pos or posList element from a point list.

Parameters

points	list of data points
doc	the GML document

Returns

QDomElement

Definition at line 1389 of file qgsogcutils.cpp.

References qgsDoubleToString().

QDomElement QgsOgcUtils::expressionBinaryOperatorToOgcFilter ( const QgsExpression::NodeBinaryOperator *  node, QDomDocument &  doc, QString &  errorMessage  )

staticprivate

Definition at line 1917 of file qgsogcutils.cpp.

References QgsExpression::BinaryOperatorText, binaryOperatorToTagName(), QgsExpression::boEQ, QgsExpression::boILike, QgsExpression::boIs, QgsExpression::boIsNot, QgsExpression::boLike, QgsExpression::boNE, expressionNodeToOgcFilter(), QgsExpression::Node::nodeType(), QgsExpression::ntLiteral, QgsExpression::NodeBinaryOperator::op(), QgsExpression::NodeBinaryOperator::opLeft(), QgsExpression::NodeBinaryOperator::opRight(), and QgsExpression::NodeLiteral::value().

Referenced by expressionNodeToOgcFilter().

QDomElement QgsOgcUtils::expressionColumnRefToOgcFilter ( const QgsExpression::NodeColumnRef *  node, QDomDocument &  doc, QString &  errorMessage  )

staticprivate

Definition at line 2012 of file qgsogcutils.cpp.

References QgsExpression::NodeColumnRef::name().

Referenced by expressionNodeToOgcFilter().

QgsExpression * QgsOgcUtils::expressionFromOgcFilter ( const QDomElement &  element )

static

Parse XML with OGC filter into QGIS expression.

Definition at line 1419 of file qgsogcutils.cpp.

References QgsExpression::boConcat, QgsExpression::mParserErrorString, QgsExpression::mRootNode, and nodeFromOgcFilter().

Referenced by QgsRuleBasedRendererV2::Rule::createFromSld(), and QgsSymbolLayerV2Utils::functionFromSldElement().

QDomElement QgsOgcUtils::expressionFunctionToOgcFilter ( const QgsExpression::NodeFunction *  node, QDomDocument &  doc, QString &  errorMessage  )

staticprivate

Definition at line 2081 of file qgsogcutils.cpp.

References QgsExpression::NodeFunction::args(), expressionNodeToOgcFilter(), QgsExpression::NodeFunction::fnIndex(), QgsGeometry::fromWkt(), QgsExpression::Functions(), geometryToGML(), isBinarySpatialOperator(), isGeometryColumn(), QgsExpression::NodeList::list(), QgsExpression::Function::name(), QgsExpression::Node::nodeType(), QgsExpression::ntFunction, QgsExpression::ntLiteral, QgsExpression::Function::params(), and tagNameForSpatialOperator().

Referenced by expressionNodeToOgcFilter().

QDomElement QgsOgcUtils::expressionInOperatorToOgcFilter ( const QgsExpression::NodeInOperator *  node, QDomDocument &  doc, QString &  errorMessage  )

staticprivate

Definition at line 2021 of file qgsogcutils.cpp.

References expressionNodeToOgcFilter(), QgsExpression::NodeList::list(), QgsExpression::NodeInOperator::list(), and QgsExpression::NodeInOperator::node().

Referenced by expressionNodeToOgcFilter().

QDomElement QgsOgcUtils::expressionLiteralToOgcFilter ( const QgsExpression::NodeLiteral *  node, QDomDocument &  doc, QString &  errorMessage  )

staticprivate

Definition at line 1986 of file qgsogcutils.cpp.

References QgsExpression::NodeLiteral::value().

Referenced by expressionNodeToOgcFilter().

QDomElement QgsOgcUtils::expressionNodeToOgcFilter ( const QgsExpression::Node *  node, QDomDocument &  doc, QString &  errorMessage  )

staticprivate

Definition at line 1866 of file qgsogcutils.cpp.

References expressionBinaryOperatorToOgcFilter(), expressionColumnRefToOgcFilter(), expressionFunctionToOgcFilter(), expressionInOperatorToOgcFilter(), expressionLiteralToOgcFilter(), expressionUnaryOperatorToOgcFilter(), QgsExpression::Node::nodeType(), QgsExpression::ntBinaryOperator, QgsExpression::ntColumnRef, QgsExpression::ntFunction, QgsExpression::ntInOperator, QgsExpression::ntLiteral, and QgsExpression::ntUnaryOperator.

Referenced by expressionBinaryOperatorToOgcFilter(), expressionFunctionToOgcFilter(), expressionInOperatorToOgcFilter(), expressionToOgcFilter(), and expressionUnaryOperatorToOgcFilter().

QDomElement QgsOgcUtils::expressionToOgcFilter ( const QgsExpression &  exp, QDomDocument &  doc, QString *  errorMessage = 0  )

static

Creates OGC filter XML element.

Supports minimum standard filter according to the OGC filter specs (=,!=,<,>,<=,>=,AND,OR,NOT)

Returns

valid

<Filter> 

QDomElement on success, otherwise null QDomElement

Definition at line 1847 of file qgsogcutils.cpp.

References expressionNodeToOgcFilter(), and QgsExpression::rootNode().

Referenced by QgsSymbolLayerV2Utils::createFunctionElement().

QDomElement QgsOgcUtils::expressionUnaryOperatorToOgcFilter ( const QgsExpression::NodeUnaryOperator *  node, QDomDocument &  doc, QString &  errorMessage  )

staticprivate

Definition at line 1890 of file qgsogcutils.cpp.

References expressionNodeToOgcFilter(), QgsExpression::NodeUnaryOperator::op(), QgsExpression::NodeUnaryOperator::operand(), QgsExpression::UnaryOperatorText, QgsExpression::uoMinus, and QgsExpression::uoNot.

Referenced by expressionNodeToOgcFilter().

QgsGeometry * QgsOgcUtils::geometryFromGML ( const QString &  xmlString )

static

static method that creates geometry from GML

Parameters

xmlString

xml representation of the geometry. GML elements are expected to be in default namespace ( {<Point>...</Point> ) or in "gml" namespace ( <gml:Point>...</gml:Point> )

Definition at line 79 of file qgsogcutils.cpp.

References GML_NAMESPACE.

Referenced by fcnGeomFromGML().

QgsGeometry * QgsOgcUtils::geometryFromGML ( const QDomNode &  geometryNode )

static

static method that creates geometry from GML

Definition at line 18 of file qgsogcutils.cpp.

References QgsGeometry::fromRect(), geometryFromGMLLineString(), geometryFromGMLMultiLineString(), geometryFromGMLMultiPoint(), geometryFromGMLMultiPolygon(), geometryFromGMLPoint(), geometryFromGMLPolygon(), rectangleFromGMLBox(), and rectangleFromGMLEnvelope().

QgsGeometry * QgsOgcUtils::geometryFromGMLLineString ( const QDomElement &  geometryElement )

staticprivate

static method that creates geometry from GML LineString

Definition at line 146 of file qgsogcutils.cpp.

References QgsGeometry::fromWkb(), GML_NAMESPACE, readGMLCoordinates(), readGMLPositions(), size, and QGis::WKBLineString.

Referenced by geometryFromGML().

QgsGeometry * QgsOgcUtils::geometryFromGMLMultiLineString ( const QDomElement &  geometryElement )

staticprivate

static method that creates geometry from GML MultiLineString

Definition at line 432 of file qgsogcutils.cpp.

References QgsGeometry::fromWkb(), GML_NAMESPACE, readGMLCoordinates(), readGMLPositions(), size, QGis::WKBLineString, and QGis::WKBMultiLineString.

Referenced by geometryFromGML().

QgsGeometry * QgsOgcUtils::geometryFromGMLMultiPoint ( const QDomElement &  geometryElement )

staticprivate

static method that creates geometry from GML MultiPoint

Definition at line 334 of file qgsogcutils.cpp.

References QgsGeometry::fromWkb(), GML_NAMESPACE, readGMLCoordinates(), readGMLPositions(), size, QGis::WKBMultiPoint, and QGis::WKBPoint.

Referenced by geometryFromGML().

QgsGeometry * QgsOgcUtils::geometryFromGMLMultiPolygon ( const QDomElement &  geometryElement )

staticprivate

static method that creates geometry from GML MultiPolygon

Definition at line 578 of file qgsogcutils.cpp.

References QgsGeometry::fromWkb(), GML_NAMESPACE, readGMLCoordinates(), readGMLPositions(), size, QGis::WKBMultiPolygon, and QGis::WKBPolygon.

Referenced by geometryFromGML().

QgsGeometry * QgsOgcUtils::geometryFromGMLPoint ( const QDomElement &  geometryElement )

staticprivate

static method that creates geometry from GML Point

Definition at line 91 of file qgsogcutils.cpp.

References QgsGeometry::fromWkb(), GML_NAMESPACE, readGMLCoordinates(), readGMLPositions(), size, and QGis::WKBPoint.

Referenced by geometryFromGML().

QgsGeometry * QgsOgcUtils::geometryFromGMLPolygon ( const QDomElement &  geometryElement )

staticprivate

static method that creates geometry from GML Polygon

Definition at line 207 of file qgsogcutils.cpp.

References QgsGeometry::fromWkb(), GML_NAMESPACE, readGMLCoordinates(), readGMLPositions(), size, and QGis::WKBPolygon.

Referenced by geometryFromGML().

QDomElement QgsOgcUtils::geometryToGML ( QgsGeometry *  geometry, QDomDocument &  doc, QString  format  )

static

Exports the geometry to GML2 or GML3.

Returns

QDomELement

Definition at line 1051 of file qgsogcutils.cpp.

References QgsGeometry::asWkb(), 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 QgsGeometry::wkbType().

Referenced by expressionFunctionToOgcFilter(), and geometryToGML().

QDomElement QgsOgcUtils::geometryToGML ( QgsGeometry *  geometry, QDomDocument &  doc  )

static

Exports the geometry to GML2.

Returns

QDomElement

Definition at line 1360 of file qgsogcutils.cpp.

References geometryToGML().

QgsExpression::NodeBinaryOperator * QgsOgcUtils::nodeBinaryOperatorFromOgcFilter ( QDomElement &  element, QString &  errorMessage  )

staticprivate

handle a generic binary operator

Definition at line 1561 of file qgsogcutils.cpp.

References binaryOperatorFromTagName(), and nodeFromOgcFilter().

Referenced by nodeFromOgcFilter().

QgsExpression::NodeColumnRef * QgsOgcUtils::nodeColumnRefFromOgcFilter ( QDomElement &  element, QString &  errorMessage  )

staticprivate

handles

<PropertyName> 

tag

Definition at line 1756 of file qgsogcutils.cpp.

Referenced by nodeFromOgcFilter().

QgsExpression::Node * QgsOgcUtils::nodeFromOgcFilter ( QDomElement &  element, QString &  errorMessage  )

staticprivate

handle a generic sub-expression

Definition at line 1511 of file qgsogcutils.cpp.

References isBinaryOperator(), isSpatialOperator(), nodeBinaryOperatorFromOgcFilter(), nodeColumnRefFromOgcFilter(), nodeFunctionFromOgcFilter(), nodeIsBetweenFromOgcFilter(), nodeLiteralFromOgcFilter(), nodeNotFromOgcFilter(), nodePropertyIsNullFromOgcFilter(), and nodeSpatialOperatorFromOgcFilter().

Referenced by expressionFromOgcFilter(), nodeBinaryOperatorFromOgcFilter(), nodeFunctionFromOgcFilter(), nodeIsBetweenFromOgcFilter(), nodeLiteralFromOgcFilter(), nodeNotFromOgcFilter(), and nodePropertyIsNullFromOgcFilter().

QgsExpression::NodeFunction * QgsOgcUtils::nodeFunctionFromOgcFilter ( QDomElement &  element, QString &  errorMessage  )

staticprivate

handles

<Function> 

tag

Definition at line 1650 of file qgsogcutils.cpp.

References QgsExpression::NodeList::append(), QgsExpression::Functions(), QgsExpression::Function::name(), and nodeFromOgcFilter().

Referenced by nodeFromOgcFilter().

QgsExpression::Node * QgsOgcUtils::nodeIsBetweenFromOgcFilter ( QDomElement &  element, QString &  errorMessage  )

staticprivate

handles

<PropertyIsBetween> 

tag

Definition at line 1768 of file qgsogcutils.cpp.

References QgsExpression::boAnd, QgsExpression::boGE, QgsExpression::boLE, and nodeFromOgcFilter().

Referenced by nodeFromOgcFilter().

QgsExpression::Node * QgsOgcUtils::nodeLiteralFromOgcFilter ( QDomElement &  element, QString &  errorMessage  )

staticprivate

handles

<Literal> 

tag

Definition at line 1689 of file qgsogcutils.cpp.

References QgsExpression::boConcat, and nodeFromOgcFilter().

Referenced by nodeFromOgcFilter().

QgsExpression::NodeUnaryOperator * QgsOgcUtils::nodeNotFromOgcFilter ( QDomElement &  element, QString &  errorMessage  )

staticprivate

handle

<Not> 

tag

Definition at line 1632 of file qgsogcutils.cpp.

References nodeFromOgcFilter(), and QgsExpression::uoNot.

Referenced by nodeFromOgcFilter().

QgsExpression::NodeBinaryOperator * QgsOgcUtils::nodePropertyIsNullFromOgcFilter ( QDomElement &  element, QString &  errorMessage  )

staticprivate

handles

<PropertyIsNull> 

tag

Definition at line 1824 of file qgsogcutils.cpp.

References QgsExpression::boIs, and nodeFromOgcFilter().

Referenced by nodeFromOgcFilter().

QgsExpression::NodeFunction * QgsOgcUtils::nodeSpatialOperatorFromOgcFilter ( QDomElement &  element, QString &  errorMessage  )

staticprivate

handles various spatial operation tags (

<Intersects> 

,

<Touches> 

etc.)

Definition at line 1597 of file qgsogcutils.cpp.

References QgsExpression::NodeList::append(), and QgsExpression::functionIndex().

Referenced by nodeFromOgcFilter().

bool QgsOgcUtils::readGMLCoordinates ( QgsPolyline &  coords, const QDomElement  elem  )

staticprivate

Reads the.

<gml:coordinates> 

element and extracts the coordinates as points

Parameters

coords	list where the found coordinates are appended
elem	the <gml:coordinates> element

Returns

boolean for success

Definition at line 783 of file qgsogcutils.cpp.

Referenced by geometryFromGMLLineString(), geometryFromGMLMultiLineString(), geometryFromGMLMultiPoint(), geometryFromGMLMultiPolygon(), geometryFromGMLPoint(), and geometryFromGMLPolygon().

bool QgsOgcUtils::readGMLPositions ( QgsPolyline &  coords, const QDomElement  elem  )

staticprivate

Reads the.

<gml:pos> 

or

<gml:posList> 

and extracts the coordinates as points

Parameters

coords	list where the found coordinates are appended
elem	the <gml:pos> or <gml:posList> element

Returns

boolean for success

Definition at line 864 of file qgsogcutils.cpp.

Referenced by geometryFromGMLLineString(), geometryFromGMLMultiLineString(), geometryFromGMLMultiPoint(), geometryFromGMLMultiPolygon(), geometryFromGMLPoint(), and geometryFromGMLPolygon().

QgsRectangle QgsOgcUtils::rectangleFromGMLBox ( const QDomNode &  boxNode )

static

read rectangle from GML2 Box

Definition at line 828 of file qgsogcutils.cpp.

References QgsRectangle::normalize().

Referenced by geometryFromGML().

QgsRectangle QgsOgcUtils::rectangleFromGMLEnvelope ( const QDomNode &  envelopeNode )

static

read rectangle from GML3 Envelope

Definition at line 915 of file qgsogcutils.cpp.

References GML_NAMESPACE, and QgsRectangle::normalize().

Referenced by geometryFromGML().

QDomElement QgsOgcUtils::rectangleToGMLBox ( QgsRectangle *  box, QDomDocument &  doc  )

static

Exports the rectangle to GML2 Box.

Returns

QDomElement

Definition at line 994 of file qgsogcutils.cpp.

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

QDomElement QgsOgcUtils::rectangleToGMLEnvelope ( QgsRectangle *  env, QDomDocument &  doc  )

static

Exports the rectangle to GML2 Envelope.

Returns

QDomElement

Definition at line 1022 of file qgsogcutils.cpp.

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

---

The documentation for this class was generated from the following files:

• /tmp/buildd/qgis-2.0.1/src/core/qgsogcutils.h
• /tmp/buildd/qgis-2.0.1/src/core/qgsogcutils.cpp