MultiSurface is a class that represents a 2-dimensional GeometryCollection whose elements are surfaces. More...

#include <MultiSurface.h>

Inheritance diagram for te::gm::MultiSurface:

Public Types
typedef void	ReturnType

typedef Visitor	VisitorType

Public Member Functions
virtual ReturnType	accept (VisitorType &guest) const =0
	It call the visit method from the guest object. More...

TE_DEFINE_VISITABLE	MultiSurface (std::size_t nGeom, GeomType t, int srid=0, Envelope *mbr=0)
	It initializes the Geometry with the specified spatial reference system id and envelope. More...

	MultiSurface (const MultiSurface &rhs)
	Copy constructor. More...

virtual MultiSurface &	operator= (const MultiSurface &rhs)
	Assignment operator. More...

virtual	~MultiSurface ()
	Virtual destructor. More...

Re-Implementation from AbstractData
Methods re-Implementated from AbstractData.
virtual te::dt::AbstractData *	clone () const
	It clones the multi surface. More...

MultiSurface Specific Methods
Specific methods for a MultiSurface.
double	getArea () const
	It returns the area of this MultiSurface, as measured in the spatial reference system of this multisurface. More...

Point *	getCentroid () const
	It returns the mathematical centroid for this MultiSurface as a point. More...

Coord2D *	getCentroidCoord () const
	It returns the mathematical centroid for this MultiSurface as a coordinate. More...

Point *	getPointOnSurface () const
	It returns a point guaranteed to be on this MultiSurface. More...

Coord2D *	getCoordOnSurface () const
	It returns a coordinate guaranteed to be on this MultiSurface. More...

double	getPerimeter () const
	It returns the length of the boundary for the surface. More...

Re-Implmentation of methods from Geometry class
Re-Implmentation of basic methods from Geometry class.
Dimensionality	getDimension () const throw ()
	MultiSurface is 2-dimenional. More...

Re-Implmentation of methods from Geometry class
Re-Implmentation of basic methods from Geometry class.
virtual const std::string &	getGeometryType () const throw ()
	The name of the Geometry subtype is: GeometryCollection. More...

void	setSRID (int srid) throw ()
	It sets the Spatial Reference System ID of the geometry collection and all its parts. More...

void	transform (int srid) throw (te::common::Exception)
	It will transform the coordinates of the geometry collection to the new one. More...

void	computeMBR (bool cascade) const throw ()
	It computes the minimum bounding rectangle for the geometry collection. More...

std::size_t	getNPoints () const throw ()
	it returns the number of points (vertexes) in the geometry. More...

GeometryCollection Specific Methods
Specific methods for a GeometryCollection.
const std::vector< Geometry * > &	getGeometries () const
	It returns a reference to the internal list of geometries. More...

std::vector< Geometry * > &	getGeometries ()
	It returns a reference to the internal list of geometries. More...

std::size_t	getNumGeometries () const
	It returns the number of geometries in this GeometryCollection. More...

void	setNumGeometries (std::size_t size)
	It sets the number of geometries in this GeometryCollection. More...

Geometry *	getGeometryN (std::size_t i) const
	It returns the n-th geometry in this GeometryCollection. More...

Geometry *	getGeometryN (std::size_t i)
	It returns the n-th geometry in this GeometryCollection. More...

void	setGeometryN (std::size_t i, Geometry *g)
	It sets the n-th geometry in this geometry collection. More...

void	removeGeometryN (std::size_t i)
	It removes the n-th geometry in this geometry collection. More...

void	add (Geometry *g)
	It adds the geometry into the collection. More...

void	clear ()
	It deletes all the elements of the collection. More...

Basic Geometry Methods
Basic methods on geometric objects.
int	getCoordinateDimension () const _NOEXCEPT_OP(true)
	It returns the number of measurements or axes needed to describe a position in a coordinate system. More...

GeomType	getGeomTypeId () const _NOEXCEPT_OP(true)
	It returns the geometry subclass type identifier. More...

virtual const std::string	get2DGeometryType () const _NOEXCEPT_OP(true)
	It returns the name of 2D geometry subclass. More...

virtual GeomType	get2DGeomTypeId () const _NOEXCEPT_OP(true)
	It returns the 2D geometry subclass type identifier. More...

int	getSRID () const _NOEXCEPT_OP(true)
	It returns the Spatial Reference System ID associated to this geometric object. More...

Geometry *	getEnvelope () const _NOEXCEPT_OP(true)
	It returns the minimum bounding rectangle (MBR) for the geometry. More...

const Envelope *	getMBR () const _NOEXCEPT_OP(true)
	It returns the minimum bounding rectangle for the geometry in an internal representation. More...

std::string	asText () const _NOEXCEPT_OP(true)
	It returns an string with the Well-Known Text Representation for the geometry. More...

char *	asBinary (std::size_t &size) const _NOEXCEPT_OP(false)
	It serializes the geometric object to a Well-known Binary Representation (WKB). More...

std::size_t	getWkbSize () const _NOEXCEPT_OP(true)
	It returns the size required by a WKB representation for this geometric object. More...

void	getWkb (char *wkb, te::common::MachineByteOrder byteOrder) const _NOEXCEPT_OP(false)
	It serializes the geometry to a WKB representation into the specified buffer. More...

virtual bool	isEmpty () const _NOEXCEPT_OP(false)
	It returns true if this geometric object is the empty Geometry. More...

virtual bool	isSimple () const _NOEXCEPT_OP(false)
	It returns true if this geometric object has no anomalous points, such as self intersection or self tangency. More...

virtual bool	isValid () const _NOEXCEPT_OP(false)
	It tells if the geometry is well formed. More...

bool	is3D () const _NOEXCEPT_OP(true)
	It returns true if this geometric object has z coordinate values. More...

bool	isMeasured () const _NOEXCEPT_OP(true)
	It returns true if this geometric object has m coordinate values. More...

bool	isCollection () const _NOEXCEPT_OP(true)
	It returns true if this geometric object is a collection. More...

virtual Geometry *	getBoundary () const _NOEXCEPT_OP(false)
	It returns the geometry boundary. More...

Spatial Relations
Methods for testing spatial relations between geometric objects. Please, see OGC specification for a in depth definition of each spatial operation.
virtual bool	equals (const Geometry *const rhs, const bool exact=false) const _NOEXCEPT_OP(false)
	It returns true if the geometry object is spatially equal to rhs geometry. More...

virtual bool	disjoint (const Geometry *const rhs) const _NOEXCEPT_OP(false)
	It returns true if the geometry object is spatially disjoint from rhs geometry. More...

virtual bool	intersects (const Geometry *const rhs) const _NOEXCEPT_OP(false)
	It returns true if the geometry object spatially intersects rhs geometry. More...

virtual bool	touches (const Geometry *const rhs) const _NOEXCEPT_OP(false)
	It returns true if the geometry object spatially touches rhs geometry. More...

virtual bool	crosses (const Geometry *const rhs) const _NOEXCEPT_OP(false)
	It returns true if the geometry object spatially crosses rhs geometry. More...

virtual bool	within (const Geometry *const rhs) const _NOEXCEPT_OP(false)
	It returns true if the geometry object is spatially within rhs geometry. More...

virtual bool	contains (const Geometry *const rhs) const _NOEXCEPT_OP(false)
	It returns true if this geometry object spatially contains rhs geometry. More...

virtual bool	overlaps (const Geometry *const rhs) const _NOEXCEPT_OP(false)
	It returns true if this geometry object spatially overlaps rhs geometry. More...

virtual bool	relate (const Geometry *const rhs, const std::string &matrix) const _NOEXCEPT_OP(false)
	It returns true if this geometry object is spatially related to rhs geometry according to the pattern expressed by the intersection matrix. More...

virtual std::string	relate (const Geometry *const rhs) const _NOEXCEPT_OP(false)
	It returns the spatial relation between this geometry object and the rhs geometry. More...

virtual bool	covers (const Geometry *const rhs) const _NOEXCEPT_OP(false)
	It returns true if this geometry object spatially covers the rhs geometry. More...

virtual bool	coveredBy (const Geometry *const rhs) const _NOEXCEPT_OP(false)
	It returns true if this geometry object is spatially covered by rhs geometry. More...

virtual Geometry *	locateAlong (const double &mValue) const _NOEXCEPT_OP(false)
	It returns a derived GeometryCollection value according to the specified coordinate value. More...

virtual Geometry *	locateBetween (const double &mStart, const double &mEnd) const _NOEXCEPT_OP(false)
	It returns a derived geometry collection value according to the range of coordinate values inclusively. More...

Spatial Analysis
Methods that support spatial analysis.
virtual double	distance (const Geometry *const rhs) const _NOEXCEPT_OP(false)
	It returns the shortest distance between any two points in the two geometry objects. More...

virtual Geometry *	buffer (const double &distance) const _NOEXCEPT_OP(false)
	This method calculates the buffer of a geometry. More...

virtual Geometry *	buffer (const double &distance, int quadrantSegments) const _NOEXCEPT_OP(false)
	This method calculates the buffer of a geometry. More...

virtual Geometry *	buffer (const double &distance, int quadrantSegments, BufferCapStyle endCapStyle) const _NOEXCEPT_OP(false)
	This method calculates the buffer of a geometry. More...

virtual Geometry *	convexHull () const _NOEXCEPT_OP(false)
	This method calculates the Convex Hull of a geometry. More...

virtual Geometry *	intersection (const Geometry *const rhs) const _NOEXCEPT_OP(false)
	It returns a geometric object that represents the point set intersection with another geometry. More...

virtual Geometry *	Union (const Geometry *const rhs) const _NOEXCEPT_OP(false)
	It returns a geometric object that represents the point set union with another geometry. More...

virtual Geometry *	difference (const Geometry *const rhs) const _NOEXCEPT_OP(false)
	It returns a geometric object that represents the point set difference with another geometry. More...

virtual Geometry *	symDifference (const Geometry *const rhs) const _NOEXCEPT_OP(false)
	It returns a geometric object that represents the point set symetric difference with another geometry. More...

virtual bool	dWithin (const Geometry *const rhs, const double &distance) const _NOEXCEPT_OP(false)
	It returns true if the geometries are within the specified distance. More...

AbstractData Re-implementation
Methods re-implemneted from AbstractData.
int	getTypeCode () const
	It returns the data type code associated to the data value. More...

std::string	toString () const
	It returns the data value in a WKT representation. More...

Static Public Member Functions
Auxiliary Methods
Auxiliary Methods.
static GeomType	getGeomTypeId (const std::string &gtype)
	It returns the TerraLib geometry type id given a type string (the type string must be in capital letters). More...

static std::string	getGeomTypeString (const int &gId)
	It returns the TerraLib geometry type string given a type id. More...

static bool	isGeomType (const std::string &stype)
	It tells if the given string is a geometry data type. More...

static void	loadGeomTypeId ()
	It loads the internal MAP of geometry type names to geometry type ids. More...

Protected Attributes
std::vector< Geometry * >	m_geometries
	The array of geometries that forms the collection. More...

GeomType	m_gType
	Internal geometry type. More...

Envelope *	m_mbr
	The geometry minimum bounding rectangle. More...

int	m_srid
	The Spatial Reference System code associated to the Geometry. More...

Static Protected Attributes
static std::map< std::string, GeomType >	sm_geomTypeMap
	A set of geometry type names (in UPPER CASE). More...

Detailed Description

MultiSurface is a class that represents a 2-dimensional GeometryCollection whose elements are surfaces.

See also: Geometry, Point, Curve, LineString, LinearRing, Surface, Polygon, Triangle, PolyhedralSurface, TIN, GeometryCollection, MultiCurve, MultiPoint, MultiLineString, MultiPolygon

Definition at line 54 of file MultiSurface.h.

Member Typedef Documentation

typedef void te::common::BaseVisitable< Visitor , void >::ReturnType

inherited

Definition at line 58 of file BaseVisitable.h.

typedef Visitor te::common::BaseVisitable< Visitor , void >::VisitorType

inherited

Definition at line 57 of file BaseVisitable.h.

Constructor & Destructor Documentation

te::gm::MultiSurface::MultiSurface	(	std::size_t	nGeom,
		GeomType	t,
		int	srid = `0`,
		Envelope *	mbr = `0`
	)

It initializes the Geometry with the specified spatial reference system id and envelope.

Parameters

nGeom	The number of geometries in the collection.
t	The internal type of the Geometry.
srid	The Spatial Reference System ID associated to the Geometry.
mbr	The minimum bounding rectangle of this geometry (i.e., its envelope).

Note: The Geometry will take the ownership of the given mbr.

Definition at line 33 of file geometry/MultiSurface.cpp.

References operator=().

Referenced by clone().

te::gm::MultiSurface::MultiSurface ( const MultiSurface & rhs )

default

Copy constructor.

Parameters

rhs	The other geometry.

virtual te::gm::MultiSurface::~MultiSurface ( )

inlinevirtual

Virtual destructor.

Definition at line 80 of file MultiSurface.h.

Member Function Documentation

virtual ReturnType te::common::BaseVisitable< Visitor , void >::accept ( VisitorType & guest ) const

pure virtualinherited

It call the visit method from the guest object.

Parameters

guest The guest or visitor.

Returns: Any valid value define by the template type R.

void te::gm::GeometryCollection::add ( Geometry * g )

inherited

It adds the geometry into the collection.

GeometryCollection will take the ownership of the informed geometry.

Parameters

g	The geometry you want to add to the collection.

Note: TerraLib extended method.

Definition at line 206 of file geometry/GeometryCollection.cpp.

References te::gm::Geometry::getSRID(), te::gm::GeometryCollection::m_geometries, and te::gm::Geometry::setSRID().

Referenced by te::edit::Convert2LayerGeomType(), createGeometryCollection(), te::vp::BufferMemory::dissolveMemory(), te::edit::MergeGeometriesTool::editingFinished(), te::rp::GeoMosaic::execute(), te::rp::TiePointsMosaic::execute(), te::rp::SequenceMosaic::execute(), te::gm::FixGeometryTopology::fixSelfIntersection(), GeometryCollection_Add(), te::gm::GetAsMultiLineStringVector(), terralib4::VectorDataSet::getGeometry(), te::vp::GetGeometryUnion(), te::gm::GTFilter::getPt1ConvexHullArea(), te::rp::GetTPConvexHullArea(), LoadIsolines(), te::gm::MultiLineToDefinedType(), te::vp::IntersectionMemory::pairwiseIntersection(), te::gm::PrepareGeometriesToIntersection(), te::mnt::TINGeneration::ReadBreakLines(), te::mnt::ReadPoints(), te::mnt::ReadSamples(), te::vp::GeometricOpMemory::SetAggregByAttribute(), te::vp::GeometricOpMemory::SetAggregObj(), te::vp::GeometricOpMemory::SetAllObjects(), te::vp::Union::setGeomAsMulti(), te::vp::Difference::setGeomAsMulti(), te::vp::SetGeomAsMulti(), te::vp::GeometricOpQuery::SetOutputDSet(), te::vp::MultipartToSinglepart::single2multi(), and te::vp::SplitGeometryCollection().

char * te::gm::Geometry::asBinary ( std::size_t & size ) const

inherited

It serializes the geometric object to a Well-known Binary Representation (WKB).

Parameters

size	The size in bytes of the returned WKB.

Returns: The WKB representation for this object.

Exceptions

Exception It will throw an exception if the operation could not be performed.

Note: The WKB will be on machine byte order.; The caller of this method will take the ownership of the returned wkb. You must use "delete [] pointer" in order to free the memory pointed by returned pointer.

Definition at line 123 of file geometry/Geometry.cpp.

References te::gm::Geometry::getWkb(), te::gm::WKBSize::size(), and te::common::Globals::sm_machineByteOrder.

Referenced by Geometry_AsBinary(), TsGeometry::tcCreateLineString(), TsGeometry::tcCreateLineStringM(), TsGeometry::tcCreateLineStringZ(), TsGeometry::tcCreateLineStringZM(), TsGeometry::tcCreatePoint(), TsGeometry::tcCreatePointM(), TsGeometry::tcCreatePointZ(), and TsGeometry::tcCreatePointZM().

std::string te::gm::Geometry::asText ( ) const

inherited

It returns an string with the Well-Known Text Representation for the geometry.

Returns: The WKT for the Geometry.

Definition at line 112 of file geometry/Geometry.cpp.

References te::gm::WKTWriter::write().

Referenced by ConvertCoordinates(), createGeometries(), Geometry_AsText(), readWkts(), RetrieveUsingSpatialFilter(), setOperationsExamples(), TsGeometry::tcCreateLineString(), TsGeometry::tcCreateLineStringM(), TsGeometry::tcCreateLineStringZ(), TsGeometry::tcCreateLineStringZM(), TsGeometry::tcCreatePoint(), TsGeometry::tcCreatePointM(), TsGeometry::tcCreatePointZ(), TsGeometry::tcCreatePointZM(), TsGeometry::tcCreatePolygon(), and wkbConversionExamples().

te::gm::Geometry * te::gm::Geometry::buffer ( const double & distance ) const

virtualinherited

This method calculates the buffer of a geometry.

Parameters

distance Distance value.

Returns: A geometry representing all points less than or equal to the specified distance.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Note: The caller of this method will take the ownership of the returned geometry.; Performed by GEOS.

Definition at line 621 of file geometry/Geometry.cpp.

References te::gm::CapRoundType, te::gm::Geometry::distance(), and TE_GEOS_DEFAULT_QUADRANT_SEGMENTS.

Referenced by te::gm::Geometry::buffer(), te::gm::FixGeometryTopology::fixSelfIntersection(), and te::vp::BufferMemory::setBuffer().

te::gm::Geometry * te::gm::Geometry::buffer	(	const double &	distance,
		int	quadrantSegments
	)		const

virtualinherited

This method calculates the buffer of a geometry.

Parameters

distance	Distance value.
quadrantSegments	A specified number of segments used to approximate the curves.

Returns: A geometry representing all points less than or equal to the specified distance.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Note: The caller of this method will take the ownership of the returned geometry.; TerraLib extended method.; Performed by GEOS.

Definition at line 630 of file geometry/Geometry.cpp.

References te::gm::Geometry::buffer(), te::gm::CapRoundType, and te::gm::Geometry::distance().

te::gm::Geometry * te::gm::Geometry::buffer	(	const double &	distance,
		int	quadrantSegments,
		BufferCapStyle	endCapStyle
	)		const

virtualinherited

This method calculates the buffer of a geometry.

As in GEOS, the quadrantSegments argument allows controlling the accuracy of the approximation by specifying the number of line segments used to represent a quadrant of a circle.

Parameters

distance	Distance value.
quadrantSegments	A specified number of segments used to approximate the curves.
endCapStyle	It specifies the shape used at the ends of linestrings.

Returns: A geometry representing all points less than or equal to the specified distance.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Note: The caller of this method will take the ownership of the returned Geometry.; TerraLib extended method.; Performed by GEOS.

Definition at line 635 of file geometry/Geometry.cpp.

References te::gm::Geometry::distance(), te::gm::Geometry::m_srid, TE_TR, and te::gm::GEOSWriter::write().

void te::gm::GeometryCollection::clear ( )

inherited

It deletes all the elements of the collection.

After calling this method you can NOT use the setGeometryN method. You will need to call setNumGeometries() again or use add().

Note: TerraLib extended method.

Definition at line 212 of file geometry/GeometryCollection.cpp.

References te::common::FreeContents(), and te::gm::GeometryCollection::m_geometries.

Referenced by te::rp::SequenceMosaic::execute(), and GeometryCollection_Clear().

te::dt::AbstractData * te::gm::MultiSurface::clone ( ) const

virtual

It clones the multi surface.

Returns: A copy of the given multi surface.

Note: The caller of this method will take the ownership of the returned multi surface.; The cloned multi surface will not have the MBR computed. This will save time when you are just cloning a geometry and don't intend to waste time computing the bounding box. If you have another suggestion, please, let me know.

Reimplemented from te::gm::GeometryCollection.

Reimplemented in te::gm::MultiPolygon.

Definition at line 45 of file geometry/MultiSurface.cpp.

References MultiSurface().

void te::gm::GeometryCollection::computeMBR	(	bool	cascade	)	const
throw	(
	)

virtualinherited

It computes the minimum bounding rectangle for the geometry collection.

Parameters

cascade If true, it will update the MBR of its parts.

Note: You can use this method in order to update the MBR of the geometry collection.; TerraLib extended method.

Implements te::gm::Geometry.

Definition at line 126 of file geometry/GeometryCollection.cpp.

References te::gm::Geometry::getMBR(), te::gm::GeometryCollection::m_geometries, te::gm::Geometry::m_mbr, te::gm::Envelope::makeInvalid(), and te::gm::Envelope::Union().

Referenced by te::gm::GeometryCollection::transform().

bool te::gm::Geometry::contains ( const Geometry *const rhs ) const

virtualinherited

It returns true if this geometry object spatially contains rhs geometry.

Parameters

rhs	The other geometry to be compared.

Returns: True if the geometry spatially contains the other geometry.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Warning: Don't call this method for a Heterogeneous GeometryCollection, otherwise, an exception will be thrown.

Note: Performed by GEOS.

Definition at line 436 of file geometry/Geometry.cpp.

References te::gm::Geometry::m_srid, TE_TR, and te::gm::GEOSWriter::write().

Referenced by Geometry_Contains(), te::edit::Repository::getFeature(), te::attributefill::VectorToVectorMemory::getMinimumDistanceFromCentroid(), te::edit::VertexTool::mouseMoveEvent(), te::gm::SatisfySpatialRelation(), spatialRelation(), and te::edit::DeletePartTool::storeFeature().

te::gm::Geometry * te::gm::Geometry::convexHull ( ) const

virtualinherited

This method calculates the Convex Hull of a geometry.

Returns: A geometry representing the convex hull.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Note: The caller of this method will take the ownership of the returned geometry.; Performed by GEOS.

Definition at line 659 of file geometry/Geometry.cpp.

References te::gm::Geometry::m_srid, TE_TR, and te::gm::GEOSWriter::write().

Referenced by Geometry_ConvexHull(), te::gm::GTFilter::getPt1ConvexHullArea(), and te::rp::GetTPConvexHullArea().

bool te::gm::Geometry::coveredBy ( const Geometry *const rhs ) const

virtualinherited

It returns true if this geometry object is spatially covered by rhs geometry.

Parameters

rhs	The other geometry to be compared.

Returns: True if the geometry is spatially covered by the other geometry.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Warning: Don't call this method for a Heterogeneous GeometryCollection, otherwise, an exception will be thrown.

Note: TerraLib extended method.; This is not the same as within. See Max Egenhofer paper on 9-intersection matrix.; Performed by GEOS.

Definition at line 566 of file geometry/Geometry.cpp.

References te::gm::Geometry::m_srid, TE_TR, and te::gm::GEOSWriter::write().

Referenced by Geometry_CoveredBy(), te::gm::SatisfySpatialRelation(), and spatialRelation().

bool te::gm::Geometry::covers ( const Geometry *const rhs ) const

virtualinherited

It returns true if this geometry object spatially covers the rhs geometry.

Parameters

rhs	The other geometry to be compared.

Returns: True if the geometry spatially covers the other geometry.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Warning: Don't call this method for a Heterogeneous GeometryCollection, otherwise, an exception will be thrown.

Note: TerraLib extended method.; This is not the same as contains. See Max Egenhofer paper on 9-intersection matrix.; Performed by GEOS.

Definition at line 541 of file geometry/Geometry.cpp.

References te::gm::Geometry::m_srid, TE_TR, and te::gm::GEOSWriter::write().

Referenced by te::edit::SubtractAreaTool::buildPolygon(), Geometry_Covers(), te::gm::SatisfySpatialRelation(), and spatialRelation().

bool te::gm::Geometry::crosses ( const Geometry *const rhs ) const

virtualinherited

It returns true if the geometry object spatially crosses rhs geometry.

Parameters

rhs	The other geometry to be compared.

Returns: True if the geometry spatially crosses the other geometry.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Warning: Don't call this method for a Heterogeneous GeometryCollection, otherwise, an exception will be thrown.

Note: Performed by GEOS.

Definition at line 386 of file geometry/Geometry.cpp.

References te::gm::Geometry::m_srid, TE_TR, and te::gm::GEOSWriter::write().

Referenced by Geometry_Crosses(), te::edit::Repository::getFeature(), te::gm::SatisfySpatialRelation(), spatialRelation(), and te::edit::DeletePartTool::storeFeature().

te::gm::Geometry * te::gm::Geometry::difference ( const Geometry *const rhs ) const

virtualinherited

It returns a geometric object that represents the point set difference with another geometry.

Parameters

rhs	Another geometry whose difference with this geometry will be calculated.

Returns: A geometry representing the difference between the geometries.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Warning: Don't call this method for a Heterogeneous GeometryCollection, otherwise, an exception will be thrown.

Note: The caller of this method will take the ownership of the returned Geometry.; Performed by GEOS.

Definition at line 739 of file geometry/Geometry.cpp.

References te::gm::Geometry::m_srid, TE_TR, and te::gm::GEOSWriter::write().

Referenced by te::edit::SubtractAreaTool::buildPolygon(), difference(), te::vp::BufferMemory::dissolveMemory(), te::vp::BufferQuery::dissolveQuery(), Geometry_Difference(), and te::vp::BufferMemory::setBuffer().

bool te::gm::Geometry::disjoint ( const Geometry *const rhs ) const

virtualinherited

It returns true if the geometry object is spatially disjoint from rhs geometry.

Parameters

rhs	The other geometry to be compared.

Returns: True if the geometry is spatially disjoint from the other geometry.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Warning: Don't call this method for a Heterogeneous GeometryCollection, otherwise, an exception will be thrown.

Note: Performed by GEOS.

Definition at line 310 of file geometry/Geometry.cpp.

References te::gm::Geometry::m_srid, TE_TR, and te::gm::GEOSWriter::write().

Referenced by Geometry_Disjoint(), te::gm::SatisfySpatialRelation(), spatialRelation(), te::edit::MergeGeometriesTool::spatialRelationDisjoint(), GAP::step3(), GAP::step4(), TsGeometry::tcCreateLineString(), TsGeometry::tcCreateLineStringM(), TsGeometry::tcCreateLineStringZ(), TsGeometry::tcCreateLineStringZM(), TsGeometry::tcCreatePoint(), TsGeometry::tcCreatePointM(), TsGeometry::tcCreatePointZ(), TsGeometry::tcCreatePointZM(), and TsGeometry::tcCreatePolygon().

double te::gm::Geometry::distance ( const Geometry *const rhs ) const

virtualinherited

It returns the shortest distance between any two points in the two geometry objects.

Parameters

rhs	The other geometry.

Returns: The shortest distance between any two points in the two geometries.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Note: Performed by GEOS.

Definition at line 596 of file geometry/Geometry.cpp.

References te::gm::Geometry::m_srid, TE_TR, and te::gm::GEOSWriter::write().

Referenced by te::gm::AdjustSegment(), BOOST_AUTO_TEST_CASE(), te::gm::Geometry::buffer(), te::sa::CalculateDistance(), te::sa::GPMConstructorAdjacencyStrategy::constructStrategy(), te::sa::GPMConstructorDistanceStrategy::constructStrategy(), te::gm::Geometry::dWithin(), te::st::IDWInterpolator::estimate(), Geometry_Distance(), te::gm::GetIntersectionPointsByOperators(), and te::gm::DistanceOrderFunctor::operator()().

bool te::gm::Geometry::dWithin	(	const Geometry *const	rhs,
		const double &	distance
	)		const

virtualinherited

It returns true if the geometries are within the specified distance.

Parameters

rhs	The other geometry whose symetric difference with this geometry will be calculated.
distance	The distance.

Returns: True if the geometries are within the specified distance.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Note: TerraLib extended method.; Performed by GEOS.

Definition at line 797 of file geometry/Geometry.cpp.

References te::gm::Geometry::distance(), te::gm::Geometry::m_srid, TE_TR, and te::gm::GEOSWriter::write().

Referenced by Geometry_DWithin().

bool te::gm::Geometry::equals	(	const Geometry *const	rhs,
		const bool	exact = `false`
	)		const

virtualinherited

It returns true if the geometry object is spatially equal to rhs geometry.

Parameters

rhs	The another geometry to be compared.
exact	If true checks if this geometric object has the same vertexes in the same order of rhs geometry.

Returns: True if the geometry is spatially equal to the other geometry.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Warning: Don't call this method for a Heterogeneous GeometryCollection, otherwise an exception will be thrown.

Note: Performed by GEOS.

Definition at line 282 of file geometry/Geometry.cpp.

References te::gm::Geometry::m_srid, TE_TR, and te::gm::GEOSWriter::write().

const std::string te::gm::Geometry::get2DGeometryType ( ) const

virtualinherited

It returns the name of 2D geometry subclass.

The name of the 2D geometry subclass may be one of the following:

Returns: The name of the geometry subclass type ide.

Definition at line 834 of file geometry/Geometry.cpp.

References te::gm::CircularStringMType, te::gm::CircularStringType, te::gm::CircularStringZMType, te::gm::CircularStringZType, te::gm::CompoundCurveMType, te::gm::CompoundCurveType, te::gm::CompoundCurveZMType, te::gm::CompoundCurveZType, te::gm::CurvePolygonMType, te::gm::CurvePolygonType, te::gm::CurvePolygonZMType, te::gm::CurvePolygonZType, te::gm::GeometryCollectionMType, te::gm::GeometryCollectionType, te::gm::GeometryCollectionZMType, te::gm::GeometryCollectionZType, te::gm::GeometryMType, te::gm::GeometryType, te::gm::GeometryZMType, te::gm::GeometryZType, te::gm::LineStringMType, te::gm::LineStringType, te::gm::LineStringZMType, te::gm::LineStringZType, te::gm::Geometry::m_gType, te::gm::MultiLineStringMType, te::gm::MultiLineStringType, te::gm::MultiLineStringZMType, te::gm::MultiLineStringZType, te::gm::MultiPointMType, te::gm::MultiPointType, te::gm::MultiPointZMType, te::gm::MultiPointZType, te::gm::MultiPolygonMType, te::gm::MultiPolygonType, te::gm::MultiPolygonZMType, te::gm::MultiPolygonZType, te::gm::MultiSurfaceMType, te::gm::MultiSurfaceType, te::gm::MultiSurfaceZMType, te::gm::MultiSurfaceZType, te::gm::PointMType, te::gm::PointType, te::gm::PointZMType, te::gm::PointZType, te::gm::PolygonMType, te::gm::PolygonType, te::gm::PolygonZMType, and te::gm::PolygonZType.

te::gm::GeomType te::gm::Geometry::get2DGeomTypeId ( ) const

virtualinherited

It returns the 2D geometry subclass type identifier.

GeometryType = 0
PointType = 1
LineStringType = 2
PolygonType = 3
MultiPointType = 4
MultiLineStringType = 5
MultiPolygonType = 6
GeometryCollectionType = 7
CircularStringType = 8
CompoundCurveType = 9
CurvePolygonType = 10
MultiSurfaceType = 12

Returns: The 2D geometry subclass type identifier

Note: Please, see GeomType enumeration for possible return values.; TerraLib extended method.

Definition at line 915 of file geometry/Geometry.cpp.

References te::gm::CircularStringMType, te::gm::CircularStringType, te::gm::CircularStringZMType, te::gm::CircularStringZType, te::gm::CompoundCurveMType, te::gm::CompoundCurveType, te::gm::CompoundCurveZMType, te::gm::CompoundCurveZType, te::gm::CurvePolygonMType, te::gm::CurvePolygonType, te::gm::CurvePolygonZMType, te::gm::CurvePolygonZType, te::gm::GeometryCollectionMType, te::gm::GeometryCollectionType, te::gm::GeometryCollectionZMType, te::gm::GeometryCollectionZType, te::gm::GeometryMType, te::gm::GeometryType, te::gm::GeometryZMType, te::gm::GeometryZType, te::gm::LineStringMType, te::gm::LineStringType, te::gm::LineStringZMType, te::gm::LineStringZType, te::gm::Geometry::m_gType, te::gm::MultiLineStringMType, te::gm::MultiLineStringType, te::gm::MultiLineStringZMType, te::gm::MultiLineStringZType, te::gm::MultiPointMType, te::gm::MultiPointType, te::gm::MultiPointZMType, te::gm::MultiPointZType, te::gm::MultiPolygonMType, te::gm::MultiPolygonType, te::gm::MultiPolygonZMType, te::gm::MultiPolygonZType, te::gm::MultiSurfaceMType, te::gm::MultiSurfaceType, te::gm::MultiSurfaceZMType, te::gm::MultiSurfaceZType, te::gm::PointMType, te::gm::PointType, te::gm::PointZMType, te::gm::PointZType, te::gm::PolygonMType, te::gm::PolygonType, te::gm::PolygonZMType, te::gm::PolygonZType, and te::gm::UnknownGeometryType.

Referenced by te::gm::Geometry::isCollection().

double te::gm::MultiSurface::getArea ( ) const

It returns the area of this MultiSurface, as measured in the spatial reference system of this multisurface.

Returns: The area of this multisurface.

Definition at line 50 of file geometry/MultiSurface.cpp.

References te::gm::Surface::getArea(), and te::gm::GeometryCollection::m_geometries.

Referenced by te::vp::GeometricOpMemory::CalculateTabularOp(), te::attributefill::VectorToVectorMemory::getArea(), te::attributefill::GetPercentOfEachClassByArea(), and MultiSurface_GetArea().

te::gm::Geometry * te::gm::Geometry::getBoundary ( ) const

virtualinherited

It returns the geometry boundary.

Returns: The geometry that makes the boundary of this geometry. The caller of this method will take the ownership of the returned geometry.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Note: The caller of this method will take the ownership of the returned Geometry.; Performed by GEOS.

Definition at line 237 of file geometry/Geometry.cpp.

References b, TE_TR, and te::gm::GEOSWriter::write().

Referenced by te::ag::Canvas::draw(), Geometry_GetBoundary(), TsGeometry::tcCreateLineString(), TsGeometry::tcCreateLineStringM(), TsGeometry::tcCreateLineStringZ(), TsGeometry::tcCreateLineStringZM(), TsGeometry::tcCreatePoint(), TsGeometry::tcCreatePointM(), TsGeometry::tcCreatePointZ(), TsGeometry::tcCreatePointZM(), and TsGeometry::tcCreatePolygon().

te::gm::Point * te::gm::MultiSurface::getCentroid ( ) const

It returns the mathematical centroid for this MultiSurface as a point.

Returns: The mathematical centroid for this multisurface.

Note: The caller of this method will take the ownership of the returned point.; The result is not guaranteed to be on this multisurface.

Definition at line 67 of file geometry/MultiSurface.cpp.

Referenced by MultiSurface_GetCentroid().

te::gm::Coord2D * te::gm::MultiSurface::getCentroidCoord ( ) const

It returns the mathematical centroid for this MultiSurface as a coordinate.

Returns: The mathematical centroid for this multisurface.

Note: The caller of this method will take the ownership of the returned coordinate.; The result is not guaranteed to be on this multisurface.; TerraLib extended method.

Definition at line 72 of file geometry/MultiSurface.cpp.

Referenced by MultiSurface_GetCentroidCoord().

int te::gm::Geometry::getCoordinateDimension ( ) const

inherited

It returns the number of measurements or axes needed to describe a position in a coordinate system.

It returns:

2 for a coordinate with x, y;
3 for a coordinate with x, y and z or x, y and m;
4 for a coordinate with x, y, z and m.

Returns: The number of measurements or axes needed to describe a position in a coordinate system.

Note: This is NOT the same as getDimension() method!

Definition at line 94 of file geometry/Geometry.cpp.

References te::gm::GetCoordDimension(), and te::gm::Geometry::m_gType.

Referenced by Geometry_GetCoordinateDimension(), TsGeometry::tcCreateLineString(), TsGeometry::tcCreateLineStringM(), TsGeometry::tcCreateLineStringZ(), TsGeometry::tcCreateLineStringZM(), TsGeometry::tcCreatePoint(), TsGeometry::tcCreatePointM(), TsGeometry::tcCreatePointZ(), TsGeometry::tcCreatePointZM(), TsGeometry::tcCreatePolygon(), TsGeometry::tcMisc(), and te::gm::WKBSize::visit().

te::gm::Coord2D * te::gm::MultiSurface::getCoordOnSurface ( ) const

It returns a coordinate guaranteed to be on this MultiSurface.

Returns: A point guaranteed to be on this MultiSurface.

Note: The caller of this method will take the ownership of the returned coordinate.; TerraLib extended method.

Definition at line 82 of file geometry/MultiSurface.cpp.

Referenced by MultiSurface_GetCoordOnSurface().

te::gm::Dimensionality te::gm::MultiSurface::getDimension	(	)	const
throw	(
	)

virtual

MultiSurface is 2-dimenional.

Returns: 2-dimenional.

Reimplemented from te::gm::GeometryCollection.

Definition at line 104 of file geometry/MultiSurface.cpp.

References te::gm::A.

Referenced by TsGeometry::tcMisc().

te::gm::Geometry * te::gm::Geometry::getEnvelope ( ) const

inherited

It returns the minimum bounding rectangle (MBR) for the geometry.

As one can notice, the mbr is returned as a geometry, actually a polygon defined by the corner points of the bounding box [(MINX, MINY), (MAXX, MINY), (MAXX, MAXY), (MINX, MAXY), (MINX, MINY)].

Returns: The geometry envelope (or mbr).

Note: The caller of this method will take the ownership of the returned geometry.; If the MBR was not computed previously, it will compute it. Successive calls to this method will not compute the mbr anymore.

Definition at line 99 of file geometry/Geometry.cpp.

References te::gm::GetGeomFromEnvelope(), te::gm::Geometry::getMBR(), and te::gm::Geometry::m_srid.

Referenced by Geometry_GetEnvelope(), TsGeometry::tcCreateLineString(), TsGeometry::tcCreateLineStringM(), TsGeometry::tcCreateLineStringZ(), TsGeometry::tcCreateLineStringZM(), TsGeometry::tcCreatePoint(), TsGeometry::tcCreatePointM(), TsGeometry::tcCreatePointZ(), TsGeometry::tcCreatePointZM(), and TsGeometry::tcCreatePolygon().

const std::vector<Geometry*>& te::gm::GeometryCollection::getGeometries ( ) const

inlineinherited

It returns a reference to the internal list of geometries.

Returns: A reference to the internal list of geometries.

Note: This method can be used by database drivers to implement its own geometry wrappers!; TerraLib extended method.

Definition at line 207 of file GeometryCollection.h.

Referenced by te::gm::FixGeometryTopology::closeGeometryRing(), te::cl::ROISet::createROISet(), te::pgis::EWKBReader::getGeometryCollection(), te::vp::GetGeometryUnion(), te::gm::MultiLineToDefinedType(), and te::gm::PrepareGeometriesToIntersection().

std::vector<Geometry*>& te::gm::GeometryCollection::getGeometries ( )

inlineinherited

It returns a reference to the internal list of geometries.

Returns: A reference to the internal list of geometries.

Note: This method can be used by database drivers to implement its own geometry wrappers!; TerraLib extended method.

Definition at line 218 of file GeometryCollection.h.

te::gm::Geometry * te::gm::GeometryCollection::getGeometryN ( std::size_t i ) const

inherited

It returns the n-th geometry in this GeometryCollection.

Parameters

i	The index of the given geometry element.

Returns: The geometry in the indicated position.

Note: It doesn't check the index range.

Definition at line 179 of file geometry/GeometryCollection.cpp.

References te::gm::GeometryCollection::m_geometries.

Referenced by BOOST_AUTO_TEST_SUITE(), CalculateHorizontalLines(), CalculateVerticalLines(), te::edit::Convert2LayerGeomType(), create_ds_memory(), te::qt::widgets::Canvas::draw(), te::ag::Canvas::draw(), te::edit::MergeGeometriesTool::editingFinished(), GeometryCollection_GetGeometryN(), te::attributefill::VectorToVectorMemory::getAllPointsOfGeometry(), te::attributefill::VectorToVectorMemory::getArea(), te::edit::GetCoordinates(), te::vp::PolygonToLineMemory::getLines(), te::edit::GetLines(), te::addressgeocoding::AddressGeocodingOp::getLines(), te::vp::LineToPolygonMemory::getPolygons(), te::rp::Blender::getSegments(), te::attributefill::RasterToVector::getTexture(), te::rp::Blender::getTileIndexers(), te::mnt::CalculateGrid::Initialize(), te::rp::Blender::initialize(), te::mnt::TINGeneration::InsertBreakNodes(), te::mnt::TINGeneration::InsertNodes(), LoadIsolines(), GAP::LoadPolygons(), te::mnt::Tin::LoadTin(), te::mnt::Tin::LoadTinQGIS(), te::edit::MoveGeometry(), te::gm::Multi2Single(), te::gm::MultiLineToDefinedType(), te::mnt::ProfileDialog::onOkPushButtonClicked(), te::mnt::TINGeneration::ReadBreakLines(), te::mnt::ReadPoints(), te::mnt::ReadSamples(), te::mnt::Smooth::run(), te::attributefill::RasterToVector::run(), te::mnt::Profile::runIsolinesProfile(), te::mnt::Profile::runTINProfile(), te::edit::MergeGeometriesTool::spatialRelationDisjoint(), GAP::step3(), te::edit::DeletePartTool::storeFeature(), te::sqlite::EWKBSize::visit(), te::gm::WKBSize::visit(), te::gm::WKBWriter::visit(), te::pgis::EWKBWriter::visit(), and te::gm::WKTWriter::visit().

te::gm::Geometry * te::gm::GeometryCollection::getGeometryN ( std::size_t i )

inherited

It returns the n-th geometry in this GeometryCollection.

Parameters

i	The index of the given geometry element.

Note: It doesn't check the index range.

Definition at line 185 of file geometry/GeometryCollection.cpp.

References te::gm::GeometryCollection::m_geometries.

const std::string & te::gm::GeometryCollection::getGeometryType	(	)	const
throw	(
	)

virtualinherited

The name of the Geometry subtype is: GeometryCollection.

Returns: The name of the Geometry subtype is: GeometryCollection.

Implements te::gm::Geometry.

Reimplemented in te::gm::MultiPolygon, te::gm::MultiPoint, and te::gm::MultiLineString.

Definition at line 91 of file geometry/GeometryCollection.cpp.

References te::gm::GeometryCollection::sm_typeName.

Referenced by TsGeometry::tcMisc().

GeomType te::gm::Geometry::getGeomTypeId ( ) const

inlineinherited

It returns the geometry subclass type identifier.

Returns: The geometry subclass type identifier

Note: Please, see GeomType enumeration for possible return values.; TerraLib extended method.

Definition at line 180 of file geometry/Geometry.h.

References _NOEXCEPT_OP.

te::gm::GeomType te::gm::Geometry::getGeomTypeId ( const std::string & gtype )

staticinherited

It returns the TerraLib geometry type id given a type string (the type string must be in capital letters).

Parameters

gtype The geometry type name.

Returns: The geometry type id equivalent to the string name.

Note: If the type is unknow it returns UnknownGeometryType.

Definition at line 824 of file geometry/Geometry.cpp.

References te::gm::Geometry::sm_geomTypeMap, and te::gm::UnknownGeometryType.

std::string te::gm::Geometry::getGeomTypeString ( const int & gId )

staticinherited

It returns the TerraLib geometry type string given a type id.

Parameters

gId	The geometry type id.

Returns: The geometry type string equivalent to the id.

Note: If the type is unknow it returns UNKNOWGEOMETRYTYPE.

Definition at line 996 of file geometry/Geometry.cpp.

References te::gm::Geometry::sm_geomTypeMap.

Referenced by te::vp::BufferDialog::onLayerComboBoxChanged(), and te::qt::widgets::LayerPropertiesInfo::setLayerVecProperties().

const te::gm::Envelope * te::gm::Geometry::getMBR ( ) const

inherited

It returns the minimum bounding rectangle for the geometry in an internal representation.

The mbr can be constructed when reading a geometry from a database or it can be computed internally. So, if the mbr is not already set it will compute it just when this method is called. Successive calls to this method will not compute the mbr anymore.

Returns: The envelope of this geometry (i.e., the minimum bounding rectangle).

Note: It is supposed to be faster and more useful than getting the box as a polygon geometry.; TerraLib extended method.

Definition at line 104 of file geometry/Geometry.cpp.

References te::gm::Geometry::computeMBR(), and te::gm::Geometry::m_mbr.

std::size_t te::gm::GeometryCollection::getNPoints	(	)	const
throw	(
	)

virtualinherited

it returns the number of points (vertexes) in the geometry.

Returns: The number of points (vertexes) in the geometry.

Note: TerraLib extended method.

Implements te::gm::Geometry.

Definition at line 152 of file geometry/GeometryCollection.cpp.

References te::gm::GeometryCollection::m_geometries.

std::size_t te::gm::GeometryCollection::getNumGeometries ( ) const

inlineinherited

It returns the number of geometries in this GeometryCollection.

Returns: The number of geometries in this GeometryCollection.

Note: If you are using this method for a loop, try to create a temporary "const size_t variable" to keep this value; this can optimize your loop.

Definition at line 228 of file GeometryCollection.h.

Referenced by BOOST_AUTO_TEST_SUITE(), CalculateHorizontalLines(), CalculateVerticalLines(), create_ds_memory(), te::qt::widgets::Canvas::draw(), te::ag::Canvas::draw(), te::edit::MergeGeometriesTool::editingFinished(), GeometryCollection_GetNumGeometries(), te::attributefill::VectorToVectorMemory::getAllPointsOfGeometry(), te::attributefill::VectorToVectorMemory::getArea(), te::edit::GetCoordinates(), te::vp::PolygonToLineMemory::getLines(), te::edit::GetLines(), te::addressgeocoding::AddressGeocodingOp::getLines(), te::vp::LineToPolygonMemory::getPolygons(), te::rp::Blender::getSegments(), te::rp::Blender::getTileIndexers(), te::mnt::CalculateGrid::Initialize(), te::rp::Blender::initialize(), te::mnt::TINGeneration::InsertBreakNodes(), te::mnt::TINGeneration::InsertNodes(), LoadIsolines(), GAP::LoadPolygons(), te::mnt::Tin::LoadTinQGIS(), te::edit::MoveGeometry(), te::gm::Multi2Single(), te::mnt::ProfileDialog::onOkPushButtonClicked(), te::mnt::TINGeneration::ReadBreakLines(), te::mnt::ReadPoints(), te::mnt::ReadSamples(), te::mnt::Smooth::run(), te::mnt::TINGeneration::run(), te::attributefill::RasterToVector::run(), te::mnt::Profile::runIsolinesProfile(), te::mnt::Profile::runTINProfile(), te::vp::GeometricOpMemory::SetAggregByAttribute(), te::vp::GeometricOpMemory::SetAggregObj(), te::vp::GeometricOpMemory::SetAllObjects(), te::vp::GeometricOpQuery::SetOutputDSet(), te::edit::MergeGeometriesTool::spatialRelationDisjoint(), GAP::step3(), te::edit::DeletePartTool::storeFeature(), te::sqlite::EWKBSize::visit(), te::gm::WKBSize::visit(), te::gm::WKBWriter::visit(), te::pgis::EWKBWriter::visit(), and te::gm::WKTWriter::visit().

double te::gm::MultiSurface::getPerimeter ( ) const

It returns the length of the boundary for the surface.

Returns: The length of the boundary for the surface.

Definition at line 87 of file geometry/MultiSurface.cpp.

References te::gm::Surface::getPerimeter(), and te::gm::GeometryCollection::m_geometries.

Referenced by te::vp::GeometricOpMemory::CalculateTabularOp().

te::gm::Point * te::gm::MultiSurface::getPointOnSurface ( ) const

It returns a point guaranteed to be on this MultiSurface.

Returns: A point guaranteed to be on this MultiSurface.

Note: The caller of this method will take the ownership of the returned point.

Definition at line 77 of file geometry/MultiSurface.cpp.

Referenced by MultiSurface_GetPointOnSurface().

int te::gm::Geometry::getSRID ( ) const

inlineinherited

It returns the Spatial Reference System ID associated to this geometric object.

This value can be used to identify the associated Spatial Reference System.

Returns: The Spatial Reference System ID associated to this geometric object.

Note: When not set this value will be -1.

Definition at line 240 of file geometry/Geometry.h.

References _NOEXCEPT_OP.

int te::gm::Geometry::getTypeCode ( ) const

virtualinherited

It returns the data type code associated to the data value.

Returns: The data type code associated to the data value.

Implements te::dt::AbstractData.

Definition at line 1065 of file geometry/Geometry.cpp.

References te::dt::GEOMETRY_TYPE.

void te::gm::Geometry::getWkb	(	char *	wkb,
		te::common::MachineByteOrder	byteOrder
	)		const

inherited

It serializes the geometry to a WKB representation into the specified buffer.

The wkb parameter must have at least getWkbSize() in order to be used. Don't pass a NULL pointer or a buffer smaller than the size needed. Note that the WKB will be on the specified byte order.

Parameters

wkb	The buffer where the Geometry will be serialized.
byteOrder	The byte order used to store/serialize the geometry.

Exceptions

Exception It will throw an exception if the operation could not be performed.

Note: TerraLib extended method.

Definition at line 139 of file geometry/Geometry.cpp.

References te::gm::WKBWriter::write().

Referenced by te::gm::Geometry::asBinary(), te::ado::Convert2Ado(), te::gpkg::Convert2OGR(), te::ogr::Convert2OGR(), Geometry_GetHWkb(), Geometry_GetWkb(), TsWKBReader::tcCreateGeometriesAndApplyReadTests(), TsGEOSWriterReader::tcCreateGeometriesAndApplyReadTests(), TsWKBReader::tcCreateGeomFromWKTAndApplyReadTests(), TsGeometry::tcCreateLineString(), TsGeometry::tcCreateLineStringM(), TsGeometry::tcCreateLineStringZ(), TsGeometry::tcCreateLineStringZM(), TsGeometry::tcCreatePoint(), TsGeometry::tcCreatePointM(), TsGeometry::tcCreatePointZ(), and TsGeometry::tcCreatePointZM().

std::size_t te::gm::Geometry::getWkbSize ( ) const

inherited

It returns the size required by a WKB representation for this geometric object.

This is the preferred method for creating a WKB. First of all, it gives you the possibility to use a pre-allocated buffer. So, this method can be used in conjunction with the getWkb method.

Returns: The size required by a WKB representation for the geometry object.

Note: TerraLib extended method.

Definition at line 134 of file geometry/Geometry.cpp.

References te::gm::WKBSize::size().

te::gm::Geometry * te::gm::Geometry::intersection ( const Geometry *const rhs ) const

virtualinherited

It returns a geometric object that represents the point set intersection with another geometry.

Parameters

rhs	The other Geometry whose intersection with this Geometry will be calculated.

Returns: A Geometry representing the intersection with this Geometry.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Warning: Don't call this method for a Heterogeneous GeometryCollection, otherwise, an exception will be thrown.

Note: The caller of this method will take the ownership of the returned Geometry.; Performed by GEOS.

Definition at line 681 of file geometry/Geometry.cpp.

References te::gm::Geometry::m_srid, TE_TR, and te::gm::GEOSWriter::write().

Referenced by CalculateHorizontalLines(), CalculateVerticalLines(), te::vp::Intersection::executeMemory(), Geometry_Intersection(), intersection(), and te::rst::LineIterator< T >::LineIterator().

bool te::gm::Geometry::intersects ( const Geometry *const rhs ) const

virtualinherited

It returns true if the geometry object spatially intersects rhs geometry.

Parameters

rhs	The other geometry to be compared.

Returns: True if the geometry intersects the other geometry.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Warning: Don't call this method for a Heterogeneous GeometryCollection, otherwise, an exception will be thrown.

Note: Performed by GEOS.

Definition at line 335 of file geometry/Geometry.cpp.

References te::gm::Geometry::m_srid, TE_TR, and te::gm::GEOSWriter::write().

bool te::gm::Geometry::is3D ( ) const

inherited

It returns true if this geometric object has z coordinate values.

Returns: True if this geometric object has z coordinate values.

Definition at line 198 of file geometry/Geometry.cpp.

References te::gm::Geometry::m_gType.

Referenced by Geometry_Is3D(), te::mnt::ReadSamples(), TsGeometry::tcCreateLineString(), TsGeometry::tcCreateLineStringM(), TsGeometry::tcCreateLineStringZ(), TsGeometry::tcCreateLineStringZM(), TsGeometry::tcCreatePoint(), TsGeometry::tcCreatePointM(), TsGeometry::tcCreatePointZ(), TsGeometry::tcCreatePointZM(), and TsGeometry::tcCreatePolygon().

bool te::gm::Geometry::isCollection ( ) const

inherited

It returns true if this geometric object is a collection.

Returns: True if this geometric object is a collection.

Definition at line 220 of file geometry/Geometry.cpp.

References te::gm::GeometryCollectionType, te::gm::Geometry::get2DGeomTypeId(), te::gm::MultiLineStringType, te::gm::MultiPointType, te::gm::MultiPolygonType, and te::gm::MultiSurfaceType.

bool te::gm::Geometry::isEmpty ( ) const

virtualinherited

It returns true if this geometric object is the empty Geometry.

If true, then this geometric object represents the empty point set for the coordinate space.

Returns: True if this geometric object is the empty Geometry.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Note: Performed by GEOS.

Definition at line 144 of file geometry/Geometry.cpp.

References TE_TR, and te::gm::GEOSWriter::write().

Referenced by te::vp::Intersection::executeMemory(), Geometry_IsEmpty(), te::gm::MultiLineToDefinedType(), TsGeometry::tcCreateLineString(), TsGeometry::tcCreateLineStringM(), TsGeometry::tcCreateLineStringZ(), TsGeometry::tcCreateLineStringZM(), TsGeometry::tcCreatePoint(), TsGeometry::tcCreatePointM(), TsGeometry::tcCreatePointZ(), TsGeometry::tcCreatePointZM(), and TsGeometry::tcCreatePolygon().

bool te::gm::Geometry::isGeomType ( const std::string & stype )

staticinherited

It tells if the given string is a geometry data type.

Parameters

stype The geometry type to be checked.

Returns: True if the given string corresponds to a geometry type.

Definition at line 1009 of file geometry/Geometry.cpp.

References te::gm::Geometry::getGeomTypeId(), and te::gm::UnknownGeometryType.

Referenced by te::sqlite::Convert2TerraLib(), and Geometry_IsGeomType().

bool te::gm::Geometry::isMeasured ( ) const

inherited

It returns true if this geometric object has m coordinate values.

Returns: True if this geometric object has m coordinate values.

Definition at line 209 of file geometry/Geometry.cpp.

References te::gm::Geometry::m_gType.

Referenced by Geometry_IsMeasured(), TsGeometry::tcCreateLineString(), TsGeometry::tcCreateLineStringM(), TsGeometry::tcCreateLineStringZ(), TsGeometry::tcCreateLineStringZM(), TsGeometry::tcCreatePoint(), TsGeometry::tcCreatePointM(), TsGeometry::tcCreatePointZ(), TsGeometry::tcCreatePointZM(), and TsGeometry::tcCreatePolygon().

bool te::gm::Geometry::isSimple ( ) const

virtualinherited

It returns true if this geometric object has no anomalous points, such as self intersection or self tangency.

See the ISO and OGC documentation for an explanation about specific conditions of each type of geometry to be considered not simple.

Returns: True if this geometric object has no anomalous geometric points.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Note: Performed by GEOS.

Definition at line 162 of file geometry/Geometry.cpp.

References TE_TR, and te::gm::GEOSWriter::write().

Referenced by Geometry_IsSimple(), te::gm::Curve::isRing(), TsGeometry::tcCreateLineString(), TsGeometry::tcCreateLineStringM(), TsGeometry::tcCreateLineStringZ(), TsGeometry::tcCreateLineStringZM(), TsGeometry::tcCreatePoint(), TsGeometry::tcCreatePointM(), TsGeometry::tcCreatePointZ(), TsGeometry::tcCreatePointZM(), and TsGeometry::tcCreatePolygon().

bool te::gm::Geometry::isValid ( ) const

virtualinherited

It tells if the geometry is well formed.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Note: TerraLib extended method.; Performed by GEOS.

Definition at line 180 of file geometry/Geometry.cpp.

References TE_TR, and te::gm::GEOSWriter::write().

void te::gm::Geometry::loadGeomTypeId ( )

staticinherited

It loads the internal MAP of geometry type names to geometry type ids.

Warning: Ths method will be automatically called when geometry module is initialized!

Definition at line 1014 of file geometry/Geometry.cpp.

Referenced by te::gm::Module::initialize().

virtual Geometry* te::gm::Geometry::locateAlong ( const double & mValue ) const

inlinevirtualinherited

It returns a derived GeometryCollection value according to the specified coordinate value.

Parameters

mValue The coordinate value.

Returns: A GeometryCollection value.

Exceptions

Exception It will throw an exception if the operation could not be performed.

Note: The caller of this method will take the ownership of the returned geometry.; This method only applies to Point and Line geometries, including homogeneu collections of points or lines. For polygons this will return a NULL value.

Definition at line 678 of file geometry/Geometry.h.

References _NOEXCEPT_OP, difference(), intersection(), and Union().

te::gm::Geometry * te::gm::Geometry::locateBetween	(	const double &	mStart,
		const double &	mEnd
	)		const

virtualinherited

It returns a derived geometry collection value according to the range of coordinate values inclusively.

Parameters

mStart	The initial coordinate value.
mEnd	The final coordinate value.

Returns: A GeometryCollection value.

Exceptions

Exception It will throw an exception if the operation could not be performed.

Note: This method only applies to Point and Line geometries, including homogeneous collections of points or lines. For polygons this will return a NULL value.; The caller of this method will take the ownership of the returned Geometry.

Reimplemented in te::gm::LineString, te::gm::CircularString, te::gm::CompoundCurve, te::gm::MultiPoint, and te::gm::MultiLineString.

Definition at line 591 of file geometry/Geometry.cpp.

te::gm::MultiSurface & te::gm::MultiSurface::operator= ( const MultiSurface & rhs )

virtualdefault

Assignment operator.

Parameters

rhs	The other geometry.

Returns: A reference for this.

Referenced by MultiSurface().

bool te::gm::Geometry::overlaps ( const Geometry *const rhs ) const

virtualinherited

It returns true if this geometry object spatially overlaps rhs geometry.

Parameters

rhs	The other geometry to be compared.

Returns: True if the geometry spatially overlaps the other geometry.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Warning: Don't call this method for a Heterogeneous GeometryCollection, otherwise, an exception will be thrown.

Note: Performed by GEOS.

Definition at line 461 of file geometry/Geometry.cpp.

References te::gm::Geometry::m_srid, TE_TR, and te::gm::GEOSWriter::write().

Referenced by Geometry_Overlaps(), te::gm::SatisfySpatialRelation(), and spatialRelation().

bool te::gm::Geometry::relate	(	const Geometry *const	rhs,
		const std::string &	matrix
	)		const

virtualinherited

It returns true if this geometry object is spatially related to rhs geometry according to the pattern expressed by the intersection matrix.

It does this by testing for intersections between the interior, boundary and exterior of the two geometric objects as specified by the values in the matrix.

Parameters

rhs	The other geometry to be compared.
matrix	The intersection matrix.

Returns: True if the geometry is spatially related to the other geometry according to the pattern expressed by the intersection matrix.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Warning: Don't call this method for a Heterogeneous GeometryCollection, otherwise, an exception will be thrown.

Note: Performed by GEOS.

Definition at line 486 of file geometry/Geometry.cpp.

References te::gm::Geometry::m_srid, TE_TR, and te::gm::GEOSWriter::write().

Referenced by Geometry_Relate().

std::string te::gm::Geometry::relate ( const Geometry *const rhs ) const

virtualinherited

It returns the spatial relation between this geometry object and the rhs geometry.

Parameters

rhs	The another geometry to be compared.

Returns: A string where each byte is a intersection in the pattern intersection matrix of the relationship of the two objects.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Warning: Don't call this method for a Heterogeneous GeometryCollection, otherwise, an exception will be thrown.

Note: TerraLib extended method.; This method will be handy when you don't know the spatial relation in advance.; Performed by GEOS.

Definition at line 514 of file geometry/Geometry.cpp.

References te::gm::Geometry::m_srid, TE_TR, and te::gm::GEOSWriter::write().

void te::gm::GeometryCollection::removeGeometryN ( std::size_t i )

inherited

It removes the n-th geometry in this geometry collection.

Parameters

i	The index of the geometry element we want to remove.

Note: It doesn't check the index range.; TerraLib extended method.

Definition at line 199 of file geometry/GeometryCollection.cpp.

References te::gm::GeometryCollection::m_geometries.

Referenced by te::edit::MergeGeometriesTool::editingFinished(), GeometryCollection_RemoveGeometryN(), and te::edit::DeletePartTool::storeFeature().

void te::gm::GeometryCollection::setGeometryN	(	std::size_t	i,
		Geometry *	g
	)

inherited

It sets the n-th geometry in this geometry collection.

GeometryCollection will take the ownership of the informed geometry. If there is a geometry in the given position it will be released before stting the new one.

Parameters

i	The index of the given geometry element.
g	The geometry that will be placed on the position indicated by index.

Note: It doesn't check the index range.; Geometry collection will take the ownership of the informed geometry.; TerraLib extended method.

Definition at line 191 of file geometry/GeometryCollection.cpp.

References te::gm::Geometry::getSRID(), te::gm::GeometryCollection::m_geometries, and te::gm::Geometry::setSRID().

Referenced by te::gm::WKTActions::buildGeometryCollection(), te::gm::WKTActions::buildMultiLineString(), te::gm::WKTActions::buildMultiPoint(), te::gm::WKTActions::buildMultiPolygon(), te::gm::WKTActions::buildMultiSurface(), GeometryCollection_SetGeometryN(), te::gm::WKBReader::getGeometryCollection(), and te::vp::GetGeometryUnion().

void te::gm::GeometryCollection::setNumGeometries ( std::size_t size )

inherited

It sets the number of geometries in this GeometryCollection.

Parameters

size	The new number of geometries for the GeometryCollection.

Note: If size is smaller than the current GeometryCollection size, the content is reduced to its first size elements, the rest being just dropped (the deallocation of geometries is done automatically).; If size is greater than the current GeometryCollection size, the content is expanded by inserting at the end NULL pointers to geometries as needed.; You must assure that all nGeom geometries are set before calling any other method (like getMBR).; TerraLib extended method.

Definition at line 167 of file geometry/GeometryCollection.cpp.

References te::gm::GeometryCollection::m_geometries.

Referenced by GeometryCollection_SetNumGeometries().

void te::gm::GeometryCollection::setSRID	(	int	srid	)
throw	(
	)

virtualinherited

It sets the Spatial Reference System ID of the geometry collection and all its parts.

Parameters

srid	The Spatial Reference System ID to be associated to the geometric object.

Note: TerraLib extended method.

Implements te::gm::Geometry.

Definition at line 96 of file geometry/GeometryCollection.cpp.

References te::gm::GeometryCollection::m_geometries, and te::gm::Geometry::m_srid.

Referenced by create_ds_memory(), te::rp::SequenceMosaic::execute(), te::vp::MultipartToSinglepart::single2multi(), and TesteGEOS().

te::gm::Geometry * te::gm::Geometry::symDifference ( const Geometry *const rhs ) const

virtualinherited

It returns a geometric object that represents the point set symetric difference with another geometry.

Parameters

rhs	The other geometry whose symetric difference with this geometry will be calculated.

Returns: A geometry representing the symetric difference with this geometry.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Warning: Don't call this method for a Heterogeneous GeometryCollection, otherwise, an exception will be thrown.

Note: The caller of this method will take the ownership of the returned Geometry.; Performed by GEOS.

Definition at line 768 of file geometry/Geometry.cpp.

References te::gm::Geometry::m_srid, TE_TR, and te::gm::GEOSWriter::write().

Referenced by Geometry_SymDifference(), and te::gm::Validate().

std::string te::gm::Geometry::toString ( void ) const

inlinevirtualinherited

It returns the data value in a WKT representation.

Returns: The data value in a WKT representation.

Implements te::dt::AbstractData.

Definition at line 936 of file geometry/Geometry.h.

Referenced by PrintCoverageSeriesInfo(), PrintTimeSeriesInfo(), PrintTrajectory(), PrintTrajectoryPatch(), and VectorizeRaster().

bool te::gm::Geometry::touches ( const Geometry *const rhs ) const

virtualinherited

It returns true if the geometry object spatially touches rhs geometry.

Parameters

rhs	The other geometry to be compared.

Returns: True if the geometry spatially touches the other geometry.

Exceptions

std::exception It will throw an exception if the operation could not be performed.

Warning: Don't call this method for a Heterogeneous GeometryCollection, otherwise, an exception will be thrown.

Note: Performed by GEOS.

Definition at line 361 of file geometry/Geometry.cpp.

References te::gm::Geometry::m_srid, TE_TR, and te::gm::GEOSWriter::write().

Referenced by Geometry_Touches(), te::gm::SatisfySpatialRelation(), spatialRelation(), TsGeometry::tcCreateLineString(), TsGeometry::tcCreateLineStringM(), TsGeometry::tcCreateLineStringZ(), TsGeometry::tcCreateLineStringZM(), TsGeometry::tcCreatePoint(), TsGeometry::tcCreatePointM(), TsGeometry::tcCreatePointZ(), TsGeometry::tcCreatePointZM(), and TsGeometry::tcCreatePolygon().

void te::gm::GeometryCollection::transform	(	int	srid	)
throw	(	te::common::Exception
	)

virtualinherited

It will transform the coordinates of the geometry collection to the new one.

After calling this method the geometry collection will be associated to the new SRID.

Parameters

srid	The new Spatial Reference System ID used to transform the coordinates of the geometry collection.

Exceptions

Exception It will throw an exception if it can not do the transformation.

Note: The geometry collection must be associated to a valid SRID before calling this method.; If the geometry collection already has an associated MBR, it will automatically update it (i. e. automatically recompute it).; TerraLib extended method.

Implements te::gm::Geometry.

Definition at line 106 of file geometry/GeometryCollection.cpp.

References te::gm::GeometryCollection::computeMBR(), te::gm::GeometryCollection::m_geometries, te::gm::Geometry::m_mbr, te::gm::Geometry::m_srid, and TE_TR.

te::gm::Geometry * te::gm::Geometry::Union ( const Geometry *const rhs ) const