QGIS API Documentation  3.0.2-Girona (307d082)
Public Member Functions | Static Public Member Functions | List of all members
QgsCircle Class Reference

Circle geometry type. More...

#include <qgscircle.h>

Inheritance diagram for QgsCircle:
Inheritance graph
[legend]

Public Member Functions

 QgsCircle ()
 
 QgsCircle (const QgsPoint &center, double radius, double azimuth=0)
 Constructs a circle by defining all the members. More...
 
double area () const override
 The area of the ellipse. More...
 
QgsRectangle boundingBox () const override
 Returns the minimal bounding box for the ellipse. More...
 
bool contains (const QgsPoint &point, double epsilon=1E-8) const
 Returns true if the circle contains the point. More...
 
QVector< QgsPointnorthQuadrant () const
 The four quadrants of the ellipse. More...
 
double perimeter () const override
 The circumference of the ellipse using first approximation of Ramanujan. More...
 
double radius () const
 Returns the radius of the circle. More...
 
void setRadius (double radius)
 Set the radius of the circle. More...
 
void setSemiMajorAxis (const double semiMajorAxis) override
 Inherited method. More...
 
void setSemiMinorAxis (const double semiMinorAxis) override
 Inherited method. More...
 
QgsCircularStringtoCircularString (bool oriented=false) const
 Returns a circular string from the circle. More...
 
QString toString (int pointPrecision=17, int radiusPrecision=17, int azimuthPrecision=2) const override
 returns a string representation of the ellipse. More...
 
- Public Member Functions inherited from QgsEllipse
 QgsEllipse ()=default
 Constructor for QgsEllipse. More...
 
 QgsEllipse (const QgsPoint &center, const double semiMajorAxis, const double semiMinorAxis, const double azimuth=90)
 Constructs an ellipse by defining all the members. More...
 
virtual ~QgsEllipse ()=default
 
double azimuth () const
 Returns the azimuth. More...
 
QgsPoint center () const
 Returns the center point. More...
 
virtual double eccentricity () const
 The eccentricity of the ellipse. More...
 
virtual QVector< QgsPointfoci () const
 Two foci of the ellipse. More...
 
virtual double focusDistance () const
 The distance between the center and each foci. More...
 
virtual bool isEmpty () const
 An ellipse is empty if axes are equal to 0. More...
 
virtual bool operator!= (const QgsEllipse &elp) const
 
virtual bool operator== (const QgsEllipse &elp) const
 
virtual QgsPolygonorientedBoundingBox () const
 Returns the oriented minimal bounding box for the ellipse. More...
 
virtual QgsPointSequence points (unsigned int segments=36) const
 Returns a list of points with segmentation from segments. More...
 
virtual QVector< QgsPointquadrant () const
 The four quadrants of the ellipse. More...
 
QgsPointrcenter ()
 Returns a reference to the center point of this ellipse. More...
 
double semiMajorAxis () const
 Returns the semi-major axis. More...
 
double semiMinorAxis () const
 Returns the semi-minor axis. More...
 
void setAzimuth (const double azimuth)
 Sets the azimuth (orientation). More...
 
void setCenter (const QgsPoint &center)
 Sets the center point. More...
 
virtual QgsLineStringtoLineString (unsigned int segments=36) const
 Returns a segmented linestring. More...
 
virtual QgsPolygontoPolygon (unsigned int segments=36) const
 Returns a segmented polygon. More...
 

Static Public Member Functions

static QgsCircle from2Points (const QgsPoint &pt1, const QgsPoint &pt2)
 Constructs a circle by 2 points on the circle. More...
 
static QgsCircle from3Points (const QgsPoint &pt1, const QgsPoint &pt2, const QgsPoint &pt3, double epsilon=1E-8)
 Constructs a circle by 3 points on the circle. More...
 
static QgsCircle from3Tangents (const QgsPoint &pt1_tg1, const QgsPoint &pt2_tg1, const QgsPoint &pt1_tg2, const QgsPoint &pt2_tg2, const QgsPoint &pt1_tg3, const QgsPoint &pt2_tg3, double epsilon=1E-8)
 Constructs a circle by 3 tangents on the circle (aka inscribed circle of a triangle). More...
 
static QgsCircle fromCenterDiameter (const QgsPoint &center, double diameter, double azimuth=0)
 Constructs a circle by a center point and a diameter. More...
 
static QgsCircle fromCenterPoint (const QgsPoint &center, const QgsPoint &pt1)
 Constructs a circle by a center point and another point. More...
 
static QgsCircle fromExtent (const QgsPoint &pt1, const QgsPoint &pt2)
 Constructs a circle by an extent (aka bounding box / QgsRectangle). More...
 
static QgsCircle minimalCircleFrom3Points (const QgsPoint &pt1, const QgsPoint &pt2, const QgsPoint &pt3, double epsilon=1E-8)
 Constructs the smallest circle from 3 points. More...
 
- Static Public Member Functions inherited from QgsEllipse
static QgsEllipse fromCenter2Points (const QgsPoint &ptc, const QgsPoint &pt1, const QgsPoint &pt2)
 Constructs an ellipse by a central point and two other points. More...
 
static QgsEllipse fromCenterPoint (const QgsPoint &ptc, const QgsPoint &pt1)
 Constructs an ellipse by a center point and a another point. More...
 
static QgsEllipse fromExtent (const QgsPoint &pt1, const QgsPoint &pt2)
 Constructs an ellipse by an extent (aka bounding box / QgsRectangle). More...
 
static QgsEllipse fromFoci (const QgsPoint &pt1, const QgsPoint &pt2, const QgsPoint &pt3)
 Constructs an ellipse by foci (pt1 and pt2) and a point pt3. More...
 

Additional Inherited Members

- Protected Attributes inherited from QgsEllipse
double mAzimuth = 90.0
 
QgsPoint mCenter
 
double mSemiMajorAxis = 0.0
 
double mSemiMinorAxis = 0.0
 

Detailed Description

Circle geometry type.

A circle is defined by a center point with a radius and an azimuth. The azimuth is the north angle to the semi-major axis, in degrees. By default, the semi-major axis is oriented to the north (0 degrees).

Since
QGIS 3.0

Definition at line 42 of file qgscircle.h.

Constructor & Destructor Documentation

◆ QgsCircle() [1/2]

QgsCircle::QgsCircle ( )

Definition at line 25 of file qgscircle.cpp.

◆ QgsCircle() [2/2]

QgsCircle::QgsCircle ( const QgsPoint center,
double  radius,
double  azimuth = 0 
)

Constructs a circle by defining all the members.

Parameters
centerThe center of the circle.
radiusThe radius of the circle.
azimuthAngle in degrees started from the North to the first quadrant.

Definition at line 31 of file qgscircle.cpp.

Member Function Documentation

◆ area()

double QgsCircle::area ( ) const
overridevirtual

The area of the ellipse.

Reimplemented from QgsEllipse.

Definition at line 254 of file qgscircle.cpp.

◆ boundingBox()

QgsRectangle QgsCircle::boundingBox ( ) const
overridevirtual

Returns the minimal bounding box for the ellipse.

Reimplemented from QgsEllipse.

Definition at line 315 of file qgscircle.cpp.

◆ contains()

bool QgsCircle::contains ( const QgsPoint point,
double  epsilon = 1E-8 
) const

Returns true if the circle contains the point.

Definition at line 310 of file qgscircle.cpp.

◆ from2Points()

QgsCircle QgsCircle::from2Points ( const QgsPoint pt1,
const QgsPoint pt2 
)
static

Constructs a circle by 2 points on the circle.

The center point can have m value which is the result from the midpoint operation between pt1 and pt2. Z dimension is also supported and is retrieved from the first 3D point amongst pt1 and pt2. The radius is calculated from the 2D distance between pt1 and pt2. The azimuth is the angle between pt1 and pt2.

Parameters
pt1First point.
pt2Second point.

Definition at line 37 of file qgscircle.cpp.

◆ from3Points()

QgsCircle QgsCircle::from3Points ( const QgsPoint pt1,
const QgsPoint pt2,
const QgsPoint pt3,
double  epsilon = 1E-8 
)
static

Constructs a circle by 3 points on the circle.

M value is dropped for the center point. Z dimension is supported and is retrieved from the first 3D point amongst pt1, pt2 and pt3. The azimuth always takes the default value. If the points are colinear an empty circle is returned.

Parameters
pt1First point.
pt2Second point.
pt3Third point.
epsilonValue used to compare point.

Definition at line 83 of file qgscircle.cpp.

◆ from3Tangents()

QgsCircle QgsCircle::from3Tangents ( const QgsPoint pt1_tg1,
const QgsPoint pt2_tg1,
const QgsPoint pt1_tg2,
const QgsPoint pt2_tg2,
const QgsPoint pt1_tg3,
const QgsPoint pt2_tg3,
double  epsilon = 1E-8 
)
static

Constructs a circle by 3 tangents on the circle (aka inscribed circle of a triangle).

Z and m values are dropped for the center point. The azimuth always takes the default value.

Parameters
pt1_tg1First point of the first tangent.
pt2_tg1Second point of the first tangent.
pt1_tg2First point of the second tangent.
pt2_tg2Second point of the second tangent.
pt1_tg3First point of the third tangent.
pt2_tg3Second point of the third tangent.
epsilonValue used to compare point.

Definition at line 191 of file qgscircle.cpp.

◆ fromCenterDiameter()

QgsCircle QgsCircle::fromCenterDiameter ( const QgsPoint center,
double  diameter,
double  azimuth = 0 
)
static

Constructs a circle by a center point and a diameter.

The center point keeps z and m values from center.

Parameters
centerCenter point.
diameterDiameter of the circle.
azimuthAzimuth of the circle.

Definition at line 176 of file qgscircle.cpp.

◆ fromCenterPoint()

QgsCircle QgsCircle::fromCenterPoint ( const QgsPoint center,
const QgsPoint pt1 
)
static

Constructs a circle by a center point and another point.

The center point keeps z and m values from center. Axes are calculated from the 2D distance between center and pt1. The azimuth is the angle between center and pt1.

Parameters
centerCenter point.
pt1A point on the circle.

Definition at line 181 of file qgscircle.cpp.

◆ fromExtent()

QgsCircle QgsCircle::fromExtent ( const QgsPoint pt1,
const QgsPoint pt2 
)
static

Constructs a circle by an extent (aka bounding box / QgsRectangle).

The center point can have m value which is the result from the midpoint operation between pt1 and pt2. Z dimension is also supported and is retrieved from the first 3D point amongst pt1 and pt2. Axes are calculated from the 2D distance between pt1 and pt2. The azimuth always takes the default value.

Parameters
pt1First corner.
pt2Second corner.

Definition at line 239 of file qgscircle.cpp.

◆ minimalCircleFrom3Points()

QgsCircle QgsCircle::minimalCircleFrom3Points ( const QgsPoint pt1,
const QgsPoint pt2,
const QgsPoint pt3,
double  epsilon = 1E-8 
)
static

Constructs the smallest circle from 3 points.

Z and m values are dropped for the center point. The azimuth always takes the default value. If the points are colinear an empty circle is returned.

Parameters
pt1First point.
pt2Second point.
pt3Third point.
epsilonValue used to compare point.

Definition at line 223 of file qgscircle.cpp.

◆ northQuadrant()

QVector< QgsPoint > QgsCircle::northQuadrant ( ) const

The four quadrants of the ellipse.

They are oriented and started from North.

Returns
quadrants defined by four points.
See also
quadrant()

Definition at line 276 of file qgscircle.cpp.

◆ perimeter()

double QgsCircle::perimeter ( ) const
overridevirtual

The circumference of the ellipse using first approximation of Ramanujan.

Reimplemented from QgsEllipse.

Definition at line 259 of file qgscircle.cpp.

◆ radius()

double QgsCircle::radius ( ) const
inline

Returns the radius of the circle.

Definition at line 165 of file qgscircle.h.

◆ setRadius()

void QgsCircle::setRadius ( double  radius)
inline

Set the radius of the circle.

Definition at line 167 of file qgscircle.h.

◆ setSemiMajorAxis()

void QgsCircle::setSemiMajorAxis ( const double  semiMajorAxis)
overridevirtual

Inherited method.

Use setRadius instead.

See also
radius()
setRadius()

Reimplemented from QgsEllipse.

Definition at line 264 of file qgscircle.cpp.

◆ setSemiMinorAxis()

void QgsCircle::setSemiMinorAxis ( const double  semiMinorAxis)
overridevirtual

Inherited method.

Use setRadius instead.

See also
radius()
setRadius()

Reimplemented from QgsEllipse.

Definition at line 270 of file qgscircle.cpp.

◆ toCircularString()

QgsCircularString * QgsCircle::toCircularString ( bool  oriented = false) const

Returns a circular string from the circle.

Parameters
orientedIf oriented is true the start point is from azimuth instead from north.

Definition at line 287 of file qgscircle.cpp.

◆ toString()

QString QgsCircle::toString ( int  pointPrecision = 17,
int  axisPrecision = 17,
int  azimuthPrecision = 2 
) const
overridevirtual

returns a string representation of the ellipse.

Members will be truncated to the specified precision.

Reimplemented from QgsEllipse.

Definition at line 320 of file qgscircle.cpp.


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