52 Q_PROPERTY(
double x READ x WRITE setX )
53 Q_PROPERTY(
double y READ y WRITE setY )
54 Q_PROPERTY(
double z READ z WRITE setZ )
55 Q_PROPERTY(
double m READ m WRITE setM )
86 QgsPoint(
double x = std::numeric_limits<double>::quiet_NaN(),
double y = std::numeric_limits<double>::quiet_NaN(),
double z = std::numeric_limits<double>::quiet_NaN(),
double m = std::numeric_limits<double>::quiet_NaN(),
Qgis::WkbType wkbType =
Qgis::WkbType::Unknown );
88 QgsPoint( SIP_PYOBJECT x
SIP_TYPEHINT( Optional[Union[
QgsPoint, QPointF,
float]] ) = Py_None, SIP_PYOBJECT y
SIP_TYPEHINT( Optional[
float] ) = Py_None, SIP_PYOBJECT z
SIP_TYPEHINT( Optional[
float] ) = Py_None, SIP_PYOBJECT m
SIP_TYPEHINT( Optional[
float] ) = Py_None, SIP_PYOBJECT wkbType
SIP_TYPEHINT( Optional[
int] ) = Py_None ) [(
double x = 0.0,
double y = 0.0,
double z = 0.0,
double m = 0.0,
Qgis::WkbType wkbType =
Qgis::WkbType::Unknown )];
90 if ( sipCanConvertToType( a0, sipType_QgsPointXY, SIP_NOT_NONE ) && a1 == Py_None && a2 == Py_None && a3 == Py_None && a4 == Py_None )
95 QgsPointXY *p =
reinterpret_cast<QgsPointXY *
>( sipConvertToType( a0, sipType_QgsPointXY, 0, SIP_NOT_NONE, &state, &sipIsErr ) );
98 sipCpp =
new sipQgsPoint(
QgsPoint( *p ) );
100 sipReleaseType( p, sipType_QgsPointXY, state );
102 else if ( sipCanConvertToType( a0, sipType_QPointF, SIP_NOT_NONE ) && a1 == Py_None && a2 == Py_None && a3 == Py_None && a4 == Py_None )
107 QPointF *p =
reinterpret_cast<QPointF *
>( sipConvertToType( a0, sipType_QPointF, 0, SIP_NOT_NONE, &state, &sipIsErr ) );
110 sipCpp =
new sipQgsPoint(
QgsPoint( *p ) );
112 sipReleaseType( p, sipType_QPointF, state );
115 ( a0 == Py_None || PyFloat_AsDouble( a0 ) != -1.0 || !PyErr_Occurred() ) &&
116 ( a1 == Py_None || PyFloat_AsDouble( a1 ) != -1.0 || !PyErr_Occurred() ) &&
117 ( a2 == Py_None || PyFloat_AsDouble( a2 ) != -1.0 || !PyErr_Occurred() ) &&
118 ( a3 == Py_None || PyFloat_AsDouble( a3 ) != -1.0 || !PyErr_Occurred() ) )
120 double x = a0 == Py_None ? std::numeric_limits<double>::quiet_NaN() : PyFloat_AsDouble( a0 );
121 double y = a1 == Py_None ? std::numeric_limits<double>::quiet_NaN() : PyFloat_AsDouble( a1 );
122 double z = a2 == Py_None ? std::numeric_limits<double>::quiet_NaN() : PyFloat_AsDouble( a2 );
123 double m = a3 == Py_None ? std::numeric_limits<double>::quiet_NaN() : PyFloat_AsDouble( a3 );
125 sipCpp =
new sipQgsPoint(
QgsPoint( x, y, z, m, wkbType ) );
129 PyErr_SetString( PyExc_TypeError, QStringLiteral(
"Invalid type in constructor arguments." ).toUtf8().constData() );
150 explicit QgsPoint(
Qgis::WkbType wkbType,
double x = std::numeric_limits<double>::quiet_NaN(),
double y = std::numeric_limits<double>::quiet_NaN(),
double z = std::numeric_limits<double>::quiet_NaN(),
double m = std::numeric_limits<double>::quiet_NaN() )
SIP_SKIP;
154 bool fuzzyHelper(
double epsilon,
158 std::function<
bool(
double,
double,
double,
double,
double,
double,
double,
double,
double )> comparator3DMeasure,
159 std::function<
bool(
double,
double,
double,
double,
double,
double,
double )> comparator3D,
160 std::function<
bool(
double,
double,
double,
double,
double,
double,
double )> comparatorMeasure,
161 std::function<
bool(
double,
double,
double,
double,
double )> comparator2D )
const
163 const QgsPoint *pt = qgsgeometry_cast< const QgsPoint * >( &other );
172 if ( is3DFlag && isMeasureFlag )
174 return comparator3DMeasure( epsilon, mX, mY, mZ, mM, pt->
x(), pt->
y(), pt->
z(), pt->
m() );
178 return comparator3D( epsilon, mX, mY, mZ, pt->
x(), pt->
y(), pt->
z() );
180 else if ( isMeasureFlag )
182 return comparatorMeasure( epsilon, mX, mY, mM, pt->
x(), pt->
y(), pt->
m() );
184 return comparator2D( epsilon, mX, mY, pt->
x(), pt->
y() );
196 [](
double epsilon,
double x1,
double y1,
double z1,
double m1,
197 double x2,
double y2,
double z2,
double m2 )
201 [](
double epsilon,
double x1,
double y1,
double z1,
202 double x2,
double y2,
double z2 )
206 [](
double epsilon,
double x1,
double y1,
double m1,
207 double x2,
double y2,
double m2 )
211 [](
double epsilon,
double x1,
double y1,
212 double x2,
double y2 )
225 [](
double epsilon,
double x1,
double y1,
double z1,
double m1,
226 double x2,
double y2,
double z2,
double m2 )
230 [](
double epsilon,
double x1,
double y1,
double z1,
231 double x2,
double y2,
double z2 )
235 [](
double epsilon,
double x1,
double y1,
double m1,
236 double x2,
double y2,
double m2 )
240 [](
double epsilon,
double x1,
double y1,
241 double x2,
double y2 )
378 return QPointF( mX, mY );
433 if (
is3D() || !std::isnan( z ) )
463 if (
is3D() || !std::isnan( z ) )
525 QgsPoint project(
double distance,
double azimuth,
double inclination = 90.0 ) const
SIP_HOLDGIL;
559 QgsPoint *snappedToGrid(
double hSpacing,
double vSpacing,
double dSpacing = 0,
double mSpacing = 0,
bool removeRedundantPoints = false ) const override
SIP_FACTORY;
561 bool removeDuplicateNodes(
double epsilon = 4 * std::numeric_limits<
double>::epsilon(),
bool useZValues = false ) override;
562 void clear() override;
564 bool fromWkt( const QString &wkt ) override;
567 QString asWkt(
int precision = 17 ) const override;
571 QString asKml(
int precision = 17 ) const override;
572 void draw( QPainter &p ) const override;
573 QPainterPath asQPainterPath() const override;
575 void transform( const QTransform &t,
double zTranslate = 0.0,
double zScale = 1.0,
double mTranslate = 0.0,
double mScale = 1.0 ) override;
578 int vertexNumberFromVertexId(
QgsVertexId id ) const override;
580 bool isValid( QString &error
SIP_OUT,
Qgis::GeometryValidityFlags flags =
Qgis::GeometryValidityFlags() ) const override
SIP_HOLDGIL;
585 bool deleteVertex(
QgsVertexId position ) override;
596 double vertexAngle(
QgsVertexId vertex ) const override;
598 int vertexCount(
int = 0,
int = 0 ) const override;
599 int ringCount(
int = 0 ) const override;
600 int partCount() const override;
603 double segmentLength(
QgsVertexId startVertex ) const override;
607 bool addZValue(
double zValue = 0 ) override;
608 bool addMValue(
double mValue = 0 ) override;
609 bool dropZValue() override;
610 bool dropMValue() override;
611 void swapXy() override;
612 bool convertTo(
Qgis::WkbType type ) override;
630 return static_cast<const QgsPoint *
>( geom );
638 SIP_PYOBJECT __repr__();
640 QString str = QStringLiteral(
"<QgsPoint: %1>" ).arg( sipCpp->asWkt() );
641 sipRes = PyUnicode_FromString( str.toUtf8().constData() );
The Qgis class provides global constants for use throughout the application.
WkbType
The WKB type describes the number of dimensions a geometry has.
Abstract base class for all geometries.
virtual QgsPoint childPoint(int index) const
Returns point at index (for geometries without child geometries - i.e.
bool isMeasure() const
Returns true if the geometry contains m values.
virtual int childCount() const
Returns number of child geometries (for geometries with child geometries) or child points (for geomet...
virtual void transformVertices(const std::function< QgsPoint(const QgsPoint &) > &transform)
Transforms the vertices from the geometry in place, applying the transform function to every vertex.
bool is3D() const
Returns true if the geometry is 3D and contains a z-value.
virtual QgsAbstractGeometry * createEmptyWithSameType() const =0
Creates a new geometry with the same class and same WKB type as the original and transfers ownership.
virtual void clearCache() const
Clears any cached parameters associated with the geometry, e.g., bounding boxes.
Qgis::WkbType wkbType() const
Returns the WKB type of the geometry.
virtual bool fuzzyEqual(const QgsAbstractGeometry &other, double epsilon=1e-8) const =0
Performs fuzzy comparison between this geometry and other using an epsilon.
virtual void normalize()=0
Reorganizes the geometry into a normalized form (or "canonical" form).
virtual void filterVertices(const std::function< bool(const QgsPoint &) > &filter)
Filters the vertices from the geometry in place, removing any which do not return true for the filter...
virtual int compareToSameClass(const QgsAbstractGeometry *other) const =0
Compares to an other geometry of the same class, and returns a integer for sorting of the two geometr...
A 3-dimensional box composed of x, y, z coordinates.
Custom exception class for Coordinate Reference System related exceptions.
Base class for feedback objects to be used for cancellation of something running in a worker thread.
static double sqrDistance2D(double x1, double y1, double x2, double y2)
Returns the squared 2D distance between (x1, y1) and (x2, y2).
static double distance2D(double x1, double y1, double x2, double y2)
Returns the 2D distance between (x1, y1) and (x2, y2).
static bool fuzzyEqual(T epsilon, const Args &... args) noexcept
Performs fuzzy comparison between pairs of values within a specified epsilon.
static double distance3D(double x1, double y1, double z1, double x2, double y2, double z2)
Returns the 3D distance between (x1, y1, z1) and (x2, y2, z2).
static double sqrDistance3D(double x1, double y1, double z1, double x2, double y2, double z2)
Returns the squared 3D distance between (x1, y1, z1) and (x2, y2, z2).
static bool fuzzyDistanceEqual(T epsilon, const Args &... args) noexcept
Compare equality between multiple pairs of values with a specified epsilon.
A class to represent a 2D point.
Point geometry type, with support for z-dimension and m-values.
double z() const
Returns the point's z-coordinate.
bool fuzzyDistanceEqual(const QgsAbstractGeometry &other, double epsilon=1e-8) const override
Performs fuzzy distance comparison between this geometry and other using an epsilon.
void setY(double y)
Sets the point's y-coordinate.
bool operator==(const QgsAbstractGeometry &other) const override
double distance3D(const QgsPoint &other) const
Returns the Cartesian 3D distance between this point and another point.
QgsPoint operator-(QgsVector v) const
Subtracts a vector from this point.
double & rx()
Returns a reference to the x-coordinate of this point.
QgsPoint operator+(QgsVector v) const
Adds a vector to this point.
double distanceSquared3D(const QgsPoint &other) const
Returns the Cartesian 3D squared distance between this point and another point.
void setX(double x)
Sets the point's x-coordinate.
QgsPoint & operator+=(QgsVector v)
Adds a vector to this point in place.
static const QgsPoint * cast(const QgsAbstractGeometry *geom)
Cast the geom to a QgsPoint.
QPointF toQPointF() const
Returns the point as a QPointF.
double distance(const QgsPoint &other) const
Returns the Cartesian 2D distance between this point and another point.
double distance3D(double x, double y, double z) const
Returns the Cartesian 3D distance between this point and a specified x, y, z coordinate.
double distanceSquared3D(double x, double y, double z) const
Returns the Cartesian 3D squared distance between this point and a specified x, y,...
void setM(double m)
Sets the point's m-value.
double y() const
Returns the point's y-coordinate.
QgsPoint & operator-=(QgsVector v)
Subtracts a vector from this point in place.
bool fuzzyEqual(const QgsAbstractGeometry &other, double epsilon=1e-8) const override
Performs fuzzy comparison between this geometry and other using an epsilon.
double distanceSquared(const QgsPoint &other) const
Returns the Cartesian 2D squared distance between this point another point.
double distance(double x, double y) const
Returns the Cartesian 2D distance between this point and a specified x, y coordinate.
double m() const
Returns the point's m value.
double & ry()
Returns a reference to the y-coordinate of this point.
void setZ(double z)
Sets the point's z-coordinate.
double distanceSquared(double x, double y) const
Returns the Cartesian 2D squared distance between this point a specified x, y coordinate.
bool operator!=(const QgsAbstractGeometry &other) const override
double & rz()
Returns a reference to the z-coordinate of this point.
double & rm()
Returns a reference to the m value of this point.
double x() const
Returns the point's x-coordinate.
A rectangle specified with double values.
A class to represent a vector.
static Qgis::WkbType flatType(Qgis::WkbType type)
Returns the flat type for a WKB type.
#define SIP_TYPEHINT(type)
#define SIP_THROW(name,...)
QVector< QgsRingSequence > QgsCoordinateSequence
double closestSegment(const QgsPolylineXY &pl, const QgsPointXY &pt, int &vertexAfter, double epsilon)
Utility class for identifying a unique vertex within a geometry.