Navigation: Up   Table of Contents   Package Overview   Bibliography   Index   Title   Acknowledging CGAL

CGAL::Circular_arc_3<SphericalKernel>

#include <CGAL/Circular_arc_3.h>

Is Model for the Concepts

SphericalKernel::CircularArc_3

Creation

Circular_arc_3<SphericalKernel> ca ( Circle_3<SphericalKernel> c);
Constructs an arc from a full circle.


Circular_arc_3<SphericalKernel> ca ( Circle_3<SphericalKernel> c, Circular_arc_point_3 pt);
Constructs an arc from a full circle, using pt as source and target.


Circular_arc_3<SphericalKernel> ca ( Circle_3<SphericalKernel> c,
Circular_arc_point_3<SphericalKernel> p,
Circular_arc_point_3<SphericalKernel> q);
Constructs the circular arc supported by c, whose source and target are p and q, respectively.
Precondition: p and q lie on c and are different.

The circular arc constructed from a circle, a source, and a target, is defined as the set of points of the circle that lie between the source p1 and the target p2, when traversing the circle counterclockwise seen from the side of the plane of the circle pointed by its positive normal vectors.

In this definition, we say that a normal vector (a,b,c) is positive if (a,b,c)>(0,0,0) (i.e. (a>0) || (a==0) && (b>0) || (a==0)&&(b==0)&&(c>0)).

Circular_arc_3<SphericalKernel> ca ( Point_3<SphericalKernel> p, Point_3<SphericalKernel> q, Point_3<SphericalKernel> r);
Constructs an arc that is supported by the circle of type Circle_3<SphericalKernel> passing through the points p, q and r. The source and target are respectively p and r, when traversing the supporting circle in the counterclockwise direction seen from the side of the plane containing the circle pointed by its positive normal vectors. Note that, depending on the orientation of the point triple (p,q,r), q may not lie on the arc.
Precondition: p, q, and r are not collinear.

Access Functions

Circle_3<SphericalKernel> ca.supporting_circle ()

Point_3<SphericalKernel> ca.center () returns the center of the supporting circle.
SphericalKernel::FT ca.squared_radius () returns the squared radius of the supporting circle.

Plane_3<SphericalKernel> ca.supporting_plane ()
Sphere_3<SphericalKernel> ca.diametral_sphere ()

Circular_arc_point_3<SphericalKernel>
ca.source ()
Circular_arc_point_3<SphericalKernel>
ca.target ()

When the methods source and target return the same point, then the arc is in fact a full circle.

When the arc was constructed from its (full) underlying circle, then source and target both return the smallest x-extremal point of the circle if the circle is not contained in a plane x=A, and the smallest y-extremal point otherwise.

Operations

bool a1 == a2 Test for equality. Two arcs are equal, iff their non-oriented supporting planes are equal, and the centers and squared radii of their respective supporting circles are equal, and their sources and targets are equal.

bool a1 != a2 Test for nonequality.

I/O

istream& std::istream& is >> Circular_arc_3 & ca
ostream& std::ostream& os << Circular_arc_3 ca

The input/output format of a circular arc consists of the supporting circle represented as a Circle_3 object followed by the source and target points of the arc represented as two Circular_arc_point_3 objects. The defined arc is the unique arc constructed from such three objects.

See Also

CGAL::Circular_arc_point_3<SphericalKernel>
CGAL::Line_arc_3<SphericalKernel>

Next: Circle_type
Navigation: Up   Table of Contents   Package Overview   Bibliography   Index   Title   Acknowledging CGAL
CGAL Open Source Project. Release 3.5. 1 October 2009.