QGIS API Documentation 4.3.0-Master (4a47d6a9bb1)
Loading...
Searching...
No Matches
qgstriangulation.h
Go to the documentation of this file.
1/***************************************************************************
2 Triangulation.h - description
3 -------------------
4 copyright : (C) 2004 by Marco Hugentobler
5 email : mhugent@geo.unizh.ch
6 ***************************************************************************/
7
8/***************************************************************************
9 * *
10 * This program is free software; you can redistribute it and/or modify *
11 * it under the terms of the GNU General Public License as published by *
12 * the Free Software Foundation; either version 2 of the License, or *
13 * (at your option) any later version. *
14 * *
15 ***************************************************************************/
16
17#ifndef TRIANGULATION_H
18#define TRIANGULATION_H
19
21#include "qgis.h"
22#include "qgis_analysis.h"
23#include "qgis_sip.h"
24#include "qgsinterpolator.h"
25#include "qgsmeshdataprovider.h"
26
27#include <QList>
28#include <QPainter>
29
30#define SIP_NO_FILE
31
32class QgsFeatureSink;
33class QgsFields;
34class QgsFeedback;
35
36
44class ANALYSIS_EXPORT QgsTriangulation
45{
46 public:
49 {
50 SnappingTypeVertex,
51 DeleteFirst,
52 InsertVertex
53 };
54 virtual ~QgsTriangulation() = default;
55
60 virtual void addLine( const QgsPointSequence &points, Qgis::InterpolationSourceType lineType ) = 0;
61
67 virtual int addPoint( const QgsPoint &point ) = 0;
68
73 virtual bool calcNormal( double x, double y, QgsPoint &result SIP_OUT ) = 0;
74
76 virtual void performConsistencyTest() = 0;
77
82 virtual bool calcPoint( double x, double y, QgsPoint &result SIP_OUT ) = 0;
83
85 virtual QgsPoint *point( int i ) const = 0;
86
91 virtual bool triangleVertices( double x, double y, QgsPoint &p1 SIP_OUT, int &n1 SIP_OUT, QgsPoint &p2 SIP_OUT, int &n2 SIP_OUT, QgsPoint &p3 SIP_OUT, int &n3 SIP_OUT ) = 0;
92
94 virtual bool triangleVertices( double x, double y, QgsPoint &p1 SIP_OUT, QgsPoint &p2 SIP_OUT, QgsPoint &p3 SIP_OUT ) = 0;
95
102 virtual int oppositePoint( int p1, int p2 ) = 0;
103
105 virtual double xMax() const = 0;
106
108 virtual double xMin() const = 0;
109
111 virtual double yMax() const = 0;
112
114 virtual double yMin() const = 0;
115
117 virtual int pointsCount() const = 0;
118
125 virtual QList<int> surroundingTriangles( int pointno ) = 0;
126
133 virtual QList<int> pointsAroundEdge( double x, double y ) = 0;
134
136 //virtual void draw(QPainter* p, double xlowleft, double ylowleft, double xupright, double yupright, double width, double height) const=0;
137
140
142 virtual void setTriangleInterpolator( TriangleInterpolator *interpolator ) = 0;
143
146
148 virtual void ruppertRefinement() = 0;
149
151 virtual bool pointInside( double x, double y ) = 0;
152
154 //virtual bool readFromTAFF(QString fileName)=0;
155
157 //virtual bool saveToTAFF(QString fileName) const=0;
158
160 virtual bool swapEdge( double x, double y ) = 0;
161
169
180 virtual bool saveTriangulation( QgsFeatureSink *sink, QgsFeedback *feedback = nullptr ) const = 0;
181
187 virtual QgsMesh triangulationToMesh( QgsFeedback *feedback = nullptr ) const = 0;
188};
189
190#endif
InterpolationSourceType
Interpolation source types.
Definition qgis.h:6639
An interface for objects which accept features via addFeature(s) methods.
Base class for feedback objects to be used for cancellation of something running in a worker thread.
Definition qgsfeedback.h:44
Container of fields for a vector layer.
Definition qgsfields.h:45
Point geometry type, with support for z-dimension and m-values.
Definition qgspoint.h:53
Interface for Triangulation classes.
virtual bool calcNormal(double x, double y, QgsPoint &result)=0
Calculates the normal at a point on the surface and assigns it to 'result'.
virtual double yMax() const =0
Returns the largest y-coordinate value of the bounding box.
ForcedCrossBehavior
Enumeration describing the behavior, if two forced lines cross.
virtual QgsMesh triangulationToMesh(QgsFeedback *feedback=nullptr) const =0
Returns a QgsMesh corresponding to the triangulation.
virtual void eliminateHorizontalTriangles()=0
Eliminates the horizontal triangles by swapping.
virtual void performConsistencyTest()=0
Performs a consistency check, remove this later.
virtual void ruppertRefinement()=0
Adds points to make the triangles better shaped (algorithm of ruppert).
virtual int pointsCount() const =0
Returns the number of points.
virtual double xMax() const =0
Returns the largest x-coordinate value of the bounding box.
virtual double yMin() const =0
Returns the smallest x-coordinate value of the bounding box.
virtual bool triangleVertices(double x, double y, QgsPoint &p1, QgsPoint &p2, QgsPoint &p3)=0
Finds out, in which triangle the point with coordinates x and y is and assigns the points at the vert...
static QgsFields triangulationFields()
Returns the fields output by features when calling saveTriangulation().
virtual bool saveTriangulation(QgsFeatureSink *sink, QgsFeedback *feedback=nullptr) const =0
Saves the triangulation features to a feature sink.
virtual QgsPoint * point(int i) const =0
Returns a pointer to the point with number i.
virtual QList< int > pointsAroundEdge(double x, double y)=0
Returns a value list with the numbers of the four points, which would be affected by an edge swap.
virtual bool calcPoint(double x, double y, QgsPoint &result)=0
Calculates x-, y and z-value of the point on the surface and assigns it to 'result'.
virtual int oppositePoint(int p1, int p2)=0
Returns the number of the point opposite to the triangle points p1, p2 (which have to be on a halfedg...
virtual int addPoint(const QgsPoint &point)=0
Adds a point to the triangulation.
virtual ~QgsTriangulation()=default
virtual bool swapEdge(double x, double y)=0
Reads the content of a taff-file.
virtual void addLine(const QgsPointSequence &points, Qgis::InterpolationSourceType lineType)=0
Adds a line (e.g.
virtual void setTriangleInterpolator(TriangleInterpolator *interpolator)=0
Sets an interpolator object.
virtual bool triangleVertices(double x, double y, QgsPoint &p1, int &n1, QgsPoint &p2, int &n2, QgsPoint &p3, int &n3)=0
Finds out in which triangle the point with coordinates x and y is and assigns the numbers of the vert...
virtual double xMin() const =0
Returns the smallest x-coordinate value of the bounding box.
virtual QList< int > surroundingTriangles(int pointno)=0
Returns a value list with the information of the triangles surrounding (counterclockwise) a point.
virtual void setForcedCrossBehavior(QgsTriangulation::ForcedCrossBehavior b)=0
Draws the points, edges and the forced lines.
virtual bool pointInside(double x, double y)=0
Returns true, if the point with coordinates x and y is inside the convex hull and false otherwise.
An interface for interpolator classes for triangulations.
#define SIP_MONKEYPATCH_SCOPEENUM_UNNEST(OUTSIDE_CLASS, FORMERNAME)
Definition qgis_sip.h:265
#define SIP_OUT
Definition qgis_sip.h:57
QVector< QgsPoint > QgsPointSequence
Mesh - vertices, edges and faces.