LuciadCPillar 2024.0.04
luciad::CircularArcBy3Points Class Referencefinal

A circular arc that is defined by a start point, end point, and a third point on the arc. More...

#include <luciad/geometries/CircularArcBy3Points.h>

Inheritance diagram for luciad::CircularArcBy3Points:
luciad::Curve luciad::Geometry

Public Member Functions

 ~CircularArcBy3Points () override
 
luciad::Coordinate computePoint (double parameter) const override
 Computes a point of the curve, defined by the given parameter. More...
 
Bounds getBounds () const override
 Returns the bounds for the geometry object. More...
 
luciad::Coordinate getEndPoint () const
 Returns the end point of this arc. More...
 
luciad::Coordinate getIntermediatePoint () const
 Returns the intermediate point of this arc. More...
 
double getLength2D () const override
 Returns the length of the curve. More...
 
std::shared_ptr< luciad::CoordinateReferencegetReference () const override
 Returns the coordinate reference of the geometry. More...
 
luciad::Coordinate getStartPoint () const
 Returns the start point of this arc. More...
 
virtual Coordinate computePoint (double parameter) const =0
 Computes a point of the curve, defined by the given parameter. More...
 
virtual double getLength2D () const =0
 Returns the length of the curve. More...
 
- Public Member Functions inherited from luciad::Geometry
virtual ~Geometry ()=default
 
virtual Bounds getBounds () const =0
 Returns the bounds for the geometry object. More...
 
virtual std::shared_ptr< CoordinateReferencegetReference () const =0
 Returns the coordinate reference of the geometry. More...
 

Protected Member Functions

size_t getHash () const override
 Returns the hash value for this geometry. More...
 
virtual size_t getHash () const =0
 Returns the hash value for this geometry. More...
 

Detailed Description

A circular arc that is defined by a start point, end point, and a third point on the arc.

A circular arc-by-3-points where the start, end and intermediate point coincide represents an arc on a circle with these points as its center and a radius of 0.

A circular arc-by-3-points where 2 out of 3 points coincide represents an arc on a circle with its center located in the middle between the 2 coinciding points and the other point. If the start and end point coincide, a full circle is drawn, otherwise, the arc is interpreted as half a circle in counterclockwise direction from start to end point.

See also
GeometryFactory::createCircularArcBy3Points

Constructor & Destructor Documentation

◆ ~CircularArcBy3Points()

luciad::CircularArcBy3Points::~CircularArcBy3Points ( )
override

Member Function Documentation

◆ computePoint()

luciad::Coordinate luciad::CircularArcBy3Points::computePoint ( double  parameter) const
overridevirtual

Computes a point of the curve, defined by the given parameter.

  1. At parameter 0, the point is the start point of the curve.
  2. At parameter 1, the point is the end point of the curve.
Parameters
parameterthe parameter value, within [0,1], to compute the point location for.
Returns
the computed point location.
Exceptions
luciad::InvalidArgumentExceptionif parameter is not within [0,1], or if the point could not be computed. For example, when the curve is defined by invalid points.

Implements luciad::Curve.

◆ getBounds()

Bounds luciad::CircularArcBy3Points::getBounds ( ) const
overridevirtual

Returns the bounds for the geometry object.

Returns
the bounds for the geometry object.
Exceptions
luciad::InvalidArgumentExceptionif the bounds could not be computed. For example, when the geometry is defined by invalid points.

Implements luciad::Geometry.

◆ getEndPoint()

luciad::Coordinate luciad::CircularArcBy3Points::getEndPoint ( ) const

Returns the end point of this arc.

Returns
the end point of this arc.

◆ getHash()

size_t luciad::CircularArcBy3Points::getHash ( ) const
overrideprotectedvirtual

Returns the hash value for this geometry.

Returns
the hash value for this geometry.

Implements luciad::Geometry.

◆ getIntermediatePoint()

luciad::Coordinate luciad::CircularArcBy3Points::getIntermediatePoint ( ) const

Returns the intermediate point of this arc.

Returns
the intermediate point of this arc.

◆ getLength2D()

double luciad::CircularArcBy3Points::getLength2D ( ) const
overridevirtual

Returns the length of the curve.

Returns
the length of the curve.
Exceptions
luciad::InvalidArgumentExceptionif the length could not be computed. For example, when the curve is defined by invalid points.

Implements luciad::Curve.

◆ getReference()

std::shared_ptr< luciad::CoordinateReference > luciad::CircularArcBy3Points::getReference ( ) const
overridevirtual

Returns the coordinate reference of the geometry.

Returns
the coordinate reference of the geometry.

Implements luciad::Geometry.

◆ getStartPoint()

luciad::Coordinate luciad::CircularArcBy3Points::getStartPoint ( ) const

Returns the start point of this arc.

Returns
the start point of this arc.