QGIS API Documentation 3.99.0-Master (a5475b57e34)
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
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_analysis.h"
22#include "qgis_sip.h"
23#include "qgsinterpolator.h"
24#include "qgsmeshdataprovider.h"
25
26#include <QList>
27#include <QPainter>
28
29#define SIP_NO_FILE
30
31class QgsFeatureSink;
32class QgsFields;
33class QgsFeedback;
34
35
43class ANALYSIS_EXPORT QgsTriangulation
44{
45 public:
48 {
49 SnappingTypeVertex,
50 DeleteFirst,
51 InsertVertex
52 };
53 virtual ~QgsTriangulation() = default;
54
59 virtual void addLine( const QgsPointSequence &points, QgsInterpolator::SourceType lineType ) = 0;
60
66 virtual int addPoint( const QgsPoint &point ) = 0;
67
72 virtual bool calcNormal( double x, double y, QgsPoint &result SIP_OUT ) = 0;
73
75 virtual void performConsistencyTest() = 0;
76
81 virtual bool calcPoint( double x, double y, QgsPoint &result SIP_OUT ) = 0;
82
84 virtual QgsPoint *point( int i ) const = 0;
85
90 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;
91
93 virtual bool triangleVertices( double x, double y, QgsPoint &p1 SIP_OUT, QgsPoint &p2 SIP_OUT, QgsPoint &p3 SIP_OUT ) = 0;
94
101 virtual int oppositePoint( int p1, int p2 ) = 0;
102
104 virtual double xMax() const = 0;
105
107 virtual double xMin() const = 0;
108
110 virtual double yMax() const = 0;
111
113 virtual double yMin() const = 0;
114
116 virtual int pointsCount() const = 0;
117
124 virtual QList<int> surroundingTriangles( int pointno ) = 0;
125
132 virtual QList<int> pointsAroundEdge( double x, double y ) = 0;
133
135 //virtual void draw(QPainter* p, double xlowleft, double ylowleft, double xupright, double yupright, double width, double height) const=0;
136
139
141 virtual void setTriangleInterpolator( TriangleInterpolator *interpolator ) = 0;
142
145
147 virtual void ruppertRefinement() = 0;
148
150 virtual bool pointInside( double x, double y ) = 0;
151
153 //virtual bool readFromTAFF(QString fileName)=0;
154
156 //virtual bool saveToTAFF(QString fileName) const=0;
157
159 virtual bool swapEdge( double x, double y ) = 0;
160
168
179 virtual bool saveTriangulation( QgsFeatureSink *sink, QgsFeedback *feedback = nullptr ) const = 0;
180
186 virtual QgsMesh triangulationToMesh( QgsFeedback *feedback = nullptr ) const = 0;
187};
188
189#endif
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:46
SourceType
Describes the type of input data.
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 void addLine(const QgsPointSequence &points, QgsInterpolator::SourceType lineType)=0
Adds a line (e.g.
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 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:267
#define SIP_OUT
Definition qgis_sip.h:57
QVector< QgsPoint > QgsPointSequence
Mesh - vertices, edges and faces.