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 QColor	colorFromOgcFill (const QDomElement &fillElement)
	Parse XML with OGC fill into QColor.
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 30 of file qgsogcutils.h.

Member Function Documentation

QColor QgsOgcUtils::colorFromOgcFill ( const QDomElement &  fillElement )

static

Parse XML with OGC fill into QColor.

Definition at line 1400 of file qgsogcutils.cpp.

Referenced by QgsVectorLayer::readSldLabeling().

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 1347 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 1371 of file qgsogcutils.cpp.

References qgsDoubleToString().

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

staticprivate

Definition at line 1940 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 2035 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 1439 of file qgsogcutils.cpp.

References QgsExpression::boConcat, QgsExpression::dump(), QgsExpression::mExp, 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 2126 of file qgsogcutils.cpp.

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

Referenced by expressionNodeToOgcFilter().

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

staticprivate

Definition at line 2044 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 2009 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 1889 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 1870 of file qgsogcutils.cpp.

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

Referenced by QgsSymbolLayerV2Utils::createFunctionElement().

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

staticprivate

Definition at line 1913 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 81 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 20 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 148 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 434 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 336 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 580 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 93 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 209 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 1053 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 1342 of file qgsogcutils.cpp.

References geometryToGML().

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

staticprivate

handle a generic binary operator

Definition at line 1584 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 1779 of file qgsogcutils.cpp.

Referenced by nodeFromOgcFilter().

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

staticprivate

handle a generic sub-expression

Definition at line 1534 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 1673 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 1791 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 1712 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 1655 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 1847 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 1620 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 785 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 866 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 830 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 917 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 996 of file qgsogcutils.cpp.

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

Referenced by expressionFunctionToOgcFilter().

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

static

Exports the rectangle to GML2 Envelope.

Returns

QDomElement

Definition at line 1024 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.2.0+wheezy1/src/core/qgsogcutils.h
• /tmp/buildd/qgis-2.2.0+wheezy1/src/core/qgsogcutils.cpp