ProGAL.geom3d

Class Circle

java.lang.Object

ProGAL.geom3d.Circle

All Implemented Interfaces:

Shape

public class Circle
extends java.lang.Object
implements Shape

A circle in (x,y,z)-space represented by a center-point, a radius and a normal-vector.

Constructor Summary

Constructors

Constructor and Description
Circle(Point center, double radius, Vector normal)
Circle(Point p0, Point p1, Point p2) Circle in the plane through p0, p1, p2
Circle(Point center, Point through, Vector normal) A circle with given center through a given point and with specified normal vector

Method Summary

Modifier and Type	Method and Description
Point	getCenter() Get the center of the circle.
double	getClosestDistance(Circle cb)
Point	getClosestPoint(Point p) returns the point on the circle closets to the query point p.
double	getDistance(Point p)
double	getDistanceSquared(Point p)
static Circle	getEquilateralCircle(Point a, Point b) Create the equilateral circle of two points.
Point	getFarthestPoint(Point p) returns the point on the circle farthest from the query point p.
java.lang.Double	getFirstIntersection(Circle c, Point p, Vector dir) returns the smallest rotation angle (direction determined by vector dir) needed to bring point p on this circle to be on the circle c as well.
java.lang.Double	getFirstIntersection(Line line, Point p, Vector dir) returns the smallest rotation angle (direction determined by vector dir) needed to bring point p on this circle to be on the line l as well.
static LineSegment	getFurthestDistance_bruteForce(Circle c1, Circle c2)
static LineSegment	getFurthestDistance_centers(Circle c1, Circle c2)
static Point	getFurthestPoint_bruteForce(Circle c, Point p)
Point[]	getIntersection(Circle c) Intersection of 2 circles in the same plane
Vector	getNormal()
Vector	getNormalVector() Get the normal of the circle.
Plane	getPlane() returns plane through this circle
Point	getPoint() return a point on the circle
double	getRadius() Get the radius of the circle.
void	setCenter(Point p) Sets the center of the circle
void	toConsole() Writes this circle to System.out with 2 decimals precision.
void	toConsole(int dec) Writes this circle to System.out with dec decimals precision.
java.lang.String	toString() Returns a string-representation of this circle formatted with two decimals precision.
java.lang.String	toString(int dec) Returns a string-representation of this circle formatted with dec decimals precision.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Circle

public Circle(Point center,
              double radius,
              Vector normal)

Circle

public Circle(Point center,
              Point through,
              Vector normal)

A circle with given center through a given point and with specified normal vector

Circle

public Circle(Point p0,
              Point p1,
              Point p2)

Circle in the plane through p0, p1, p2

Method Detail

getCenter

public Point getCenter()

Get the center of the circle.

Specified by:

getCenter in interface Shape

getRadius

public double getRadius()

Get the radius of the circle.

getNormalVector

public Vector getNormalVector()

Get the normal of the circle.

getNormal

public Vector getNormal()

setCenter

public void setCenter(Point p)

Sets the center of the circle

getPoint

public Point getPoint()

return a point on the circle

getPlane

public Plane getPlane()

returns plane through this circle

getClosestPoint

public Point getClosestPoint(Point p)

returns the point on the circle closets to the query point p. If p is equidistant to all points on the circle, an arbitrary point of the circle is returned.

getFarthestPoint

public Point getFarthestPoint(Point p)

returns the point on the circle farthest from the query point p. If p is equidistant to all points on the circle, an arbitrary point of the circle is returned.

getClosestDistance

public double getClosestDistance(Circle cb)

getEquilateralCircle

public static Circle getEquilateralCircle(Point a,
                                          Point b)

Create the equilateral circle of two points.

toString

public java.lang.String toString()

Returns a string-representation of this circle formatted with two decimals precision.

Overrides:

toString in class java.lang.Object

toString

public java.lang.String toString(int dec)

Returns a string-representation of this circle formatted with dec decimals precision.

toConsole

public void toConsole()

Writes this circle to System.out with 2 decimals precision.

toConsole

public void toConsole(int dec)

Writes this circle to System.out with dec decimals precision.

getIntersection

public Point[] getIntersection(Circle c)

Intersection of 2 circles in the same plane

getFirstIntersection

public java.lang.Double getFirstIntersection(Line line,
                                             Point p,
                                             Vector dir)

returns the smallest rotation angle (direction determined by vector dir) needed to bring point p on this circle to be on the line l as well. Returns null if there is no intersection or just one intersection.

Returns:

getDistanceSquared

public double getDistanceSquared(Point p)

getDistance

public double getDistance(Point p)

getFirstIntersection

public java.lang.Double getFirstIntersection(Circle c,
                                             Point p,
                                             Vector dir)

returns the smallest rotation angle (direction determined by vector dir) needed to bring point p on this circle to be on the circle c as well. Returns null if there is no intersection or just one intersection.

Returns:

getFurthestDistance_centers

public static LineSegment getFurthestDistance_centers(Circle c1,
                                                      Circle c2)

getFurthestPoint_bruteForce

public static Point getFurthestPoint_bruteForce(Circle c,
                                                Point p)

getFurthestDistance_bruteForce

public static LineSegment getFurthestDistance_bruteForce(Circle c1,
                                                         Circle c2)