QGIS API Documentation  3.24.2-Tisler (13c1a02865)
Public Types | Public Member Functions | Protected Slots | Protected Member Functions | List of all members
QgsTracer Class Reference

Utility class that construct a planar graph from the input vector layers and provides shortest path search for tracing of existing features. More...

#include <qgstracer.h>

Inheritance diagram for QgsTracer:
Inheritance graph
[legend]

Public Types

enum  PathError {
  ErrNone , ErrTooManyFeatures , ErrPoint1 , ErrPoint2 ,
  ErrNoPath
}
 Possible errors that may happen when calling findShortestPath() More...
 

Public Member Functions

 QgsTracer ()
 Constructor for QgsTracer. More...
 
 ~QgsTracer () override
 
QgsCoordinateReferenceSystem destinationCrs () const
 Returns the CRS used for tracing. More...
 
QgsRectangle extent () const
 Gets extent to which graph's features will be limited (empty extent means no limit) More...
 
QVector< QgsPointXYfindShortestPath (const QgsPointXY &p1, const QgsPointXY &p2, PathError *error=nullptr)
 Given two points, find the shortest path and return points on the way. More...
 
bool hasTopologyProblem () const
 Whether there was an error during graph creation due to noding exception, indicating some input data topology problems. More...
 
bool init ()
 Build the internal data structures. More...
 
bool isInitialized () const
 Whether the internal data structures have been initialized. More...
 
bool isPointSnapped (const QgsPointXY &pt)
 Find out whether the point is snapped to a vertex or edge (i.e. it can be used for tracing start/stop) More...
 
QList< QgsVectorLayer * > layers () const
 Gets layers used for tracing. More...
 
int maxFeatureCount () const
 Gets maximum possible number of features in graph. If the number is exceeded, graph is not created. More...
 
double offset () const
 Gets offset in map units that should be applied to the traced paths returned from findShortestPath(). More...
 
void offsetParameters (int &quadSegments, int &joinStyle, double &miterLimit)
 Gets extra parameters for offset curve algorithm (used when offset is non-zero) More...
 
void setDestinationCrs (const QgsCoordinateReferenceSystem &crs, const QgsCoordinateTransformContext &context)
 Sets the crs and transform context used for tracing. More...
 
void setExtent (const QgsRectangle &extent)
 Sets extent to which graph's features will be limited (empty extent means no limit) More...
 
void setLayers (const QList< QgsVectorLayer * > &layers)
 Sets layers used for tracing. More...
 
void setMaxFeatureCount (int count)
 Gets maximum possible number of features in graph. If the number is exceeded, graph is not created. More...
 
void setOffset (double offset)
 Set offset in map units that should be applied to the traced paths returned from findShortestPath(). More...
 
void setOffsetParameters (int quadSegments, int joinStyle, double miterLimit)
 Set extra parameters for offset curve algorithm (used when offset is non-zero) More...
 
void setRenderContext (const QgsRenderContext *renderContext)
 Sets the renderContext used for tracing only on visible features. More...
 

Protected Slots

void invalidateGraph ()
 Destroy the existing graph structure if any (de-initialize) More...
 

Protected Member Functions

virtual void configure ()
 Allows derived classes to setup the settings just before the tracer is initialized. More...
 

Detailed Description

Utility class that construct a planar graph from the input vector layers and provides shortest path search for tracing of existing features.

Since
QGIS 2.14

Definition at line 44 of file qgstracer.h.

Member Enumeration Documentation

◆ PathError

Possible errors that may happen when calling findShortestPath()

Enumerator
ErrNone 

No error.

ErrTooManyFeatures 

Max feature count threshold was reached while reading features.

ErrPoint1 

Start point cannot be joined to the graph.

ErrPoint2 

End point cannot be joined to the graph.

ErrNoPath 

Points are not connected in the graph.

Definition at line 137 of file qgstracer.h.

Constructor & Destructor Documentation

◆ QgsTracer()

QgsTracer::QgsTracer ( )
default

Constructor for QgsTracer.

◆ ~QgsTracer()

QgsTracer::~QgsTracer ( )
override

Definition at line 597 of file qgstracer.cpp.

Member Function Documentation

◆ configure()

virtual void QgsTracer::configure ( )
inlineprotectedvirtual

Allows derived classes to setup the settings just before the tracer is initialized.

This allows the configuration to be set in a lazy way only when it is really necessary. Default implementation does nothing.

Reimplemented in QgsMapCanvasTracer.

Definition at line 163 of file qgstracer.h.

◆ destinationCrs()

QgsCoordinateReferenceSystem QgsTracer::destinationCrs ( ) const
inline

Returns the CRS used for tracing.

See also
setDestinationCrs()

Definition at line 64 of file qgstracer.h.

◆ extent()

QgsRectangle QgsTracer::extent ( ) const
inline

Gets extent to which graph's features will be limited (empty extent means no limit)

Definition at line 79 of file qgstracer.h.

◆ findShortestPath()

QVector< QgsPointXY > QgsTracer::findShortestPath ( const QgsPointXY p1,
const QgsPointXY p2,
PathError error = nullptr 
)

Given two points, find the shortest path and return points on the way.

The optional "error" argument may receive error code (PathError enum) if it is not nullptr

Returns
array of points - trace of linestrings of other features (empty array one error)

Definition at line 736 of file qgstracer.cpp.

◆ hasTopologyProblem()

bool QgsTracer::hasTopologyProblem ( ) const
inline

Whether there was an error during graph creation due to noding exception, indicating some input data topology problems.

Since
QGIS 2.16

Definition at line 134 of file qgstracer.h.

◆ init()

bool QgsTracer::init ( )

Build the internal data structures.

This may take some time depending on how big the input layers are. It is not necessary to call this method explicitly - it will be called by findShortestPath() if necessary.

Definition at line 675 of file qgstracer.cpp.

◆ invalidateGraph

void QgsTracer::invalidateGraph ( )
protectedslot

Destroy the existing graph structure if any (de-initialize)

Definition at line 687 of file qgstracer.cpp.

◆ isInitialized()

bool QgsTracer::isInitialized ( ) const
inline

Whether the internal data structures have been initialized.

Definition at line 127 of file qgstracer.h.

◆ isPointSnapped()

bool QgsTracer::isPointSnapped ( const QgsPointXY pt)

Find out whether the point is snapped to a vertex or edge (i.e. it can be used for tracing start/stop)

Definition at line 803 of file qgstracer.cpp.

◆ layers()

QList<QgsVectorLayer *> QgsTracer::layers ( ) const
inline

Gets layers used for tracing.

Definition at line 56 of file qgstracer.h.

◆ maxFeatureCount()

int QgsTracer::maxFeatureCount ( ) const
inline

Gets maximum possible number of features in graph. If the number is exceeded, graph is not created.

Definition at line 114 of file qgstracer.h.

◆ offset()

double QgsTracer::offset ( ) const
inline

Gets offset in map units that should be applied to the traced paths returned from findShortestPath().

Positive offset for right side, negative offset for left side.

Since
QGIS 3.0

Definition at line 88 of file qgstracer.h.

◆ offsetParameters()

void QgsTracer::offsetParameters ( int &  quadSegments,
int &  joinStyle,
double &  miterLimit 
)

Gets extra parameters for offset curve algorithm (used when offset is non-zero)

Since
QGIS 3.0

Definition at line 661 of file qgstracer.cpp.

◆ setDestinationCrs()

void QgsTracer::setDestinationCrs ( const QgsCoordinateReferenceSystem crs,
const QgsCoordinateTransformContext context 
)

Sets the crs and transform context used for tracing.

See also
destinationCrs()

Definition at line 634 of file qgstracer.cpp.

◆ setExtent()

void QgsTracer::setExtent ( const QgsRectangle extent)

Sets extent to which graph's features will be limited (empty extent means no limit)

Definition at line 647 of file qgstracer.cpp.

◆ setLayers()

void QgsTracer::setLayers ( const QList< QgsVectorLayer * > &  layers)

Sets layers used for tracing.

Definition at line 602 of file qgstracer.cpp.

◆ setMaxFeatureCount()

void QgsTracer::setMaxFeatureCount ( int  count)
inline

Gets maximum possible number of features in graph. If the number is exceeded, graph is not created.

Definition at line 116 of file qgstracer.h.

◆ setOffset()

void QgsTracer::setOffset ( double  offset)

Set offset in map units that should be applied to the traced paths returned from findShortestPath().

Positive offset for right side, negative offset for left side.

Since
QGIS 3.0

Definition at line 656 of file qgstracer.cpp.

◆ setOffsetParameters()

void QgsTracer::setOffsetParameters ( int  quadSegments,
int  joinStyle,
double  miterLimit 
)

Set extra parameters for offset curve algorithm (used when offset is non-zero)

Since
QGIS 3.0

Definition at line 668 of file qgstracer.cpp.

◆ setRenderContext()

void QgsTracer::setRenderContext ( const QgsRenderContext renderContext)

Sets the renderContext used for tracing only on visible features.

Since
QGIS 3.4

Definition at line 641 of file qgstracer.cpp.


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