org.josef.science.math.geometry

Class CTriangle

java.lang.Object

org.josef.science.math.geometry.CTriangle

All Implemented Interfaces:

Serializable

@ThreadSafety(level=IMMUTABLE)
public class CTriangle
extends Object
implements Serializable

Abstraction of a triangle in two dimensions.

Version:

1.0 $Revision: 6488 $

Author:

Kees Schotanus

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
CTriangle(CPoint pointA, CPoint pointB, CPoint pointC) Creates this triangle from the supplied points.

Method Summary

Modifier and Type	Method and Description
double	getArea() Gets the area of this CTriangle.
CLine	getLineAtoB() Gets the line from point A to point B.
CLine	getLineBtoC() Gets the line from point B to point C.
CLine	getLineCtoA() Gets the line from point C to point A.
double	getPerimeter() Gets the perimeter of this CTriangle.
CPoint	getPointA() Gets the pointA of this CTriangle.
CPoint	getPointB() Gets the pointB of this CTriangle.
CPoint	getPointC() Gets the pointC of this CTriangle.
boolean	isEquilateral() Determines whether this triangle is equilateral, which is the case when all lines of the triangle have equal length.
boolean	isIsosceles() Determines whether this triangle is isosceles, which is the case when two lines of the triangle have equal length.
String	toString() Creates a String representation of this CTriangle.

Methods inherited from class java.lang.Object

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

Constructor Detail

CTriangle

public CTriangle(CPoint pointA,
                 CPoint pointB,
                 CPoint pointC)

Creates this triangle from the supplied points.

Parameters:

pointA - Point A of this Triangle.

pointB - Point B of this Triangle.

pointC - Point C of this Triangle.

Throws:

NullPointerException - When one of the supplied points is null.

ArithmeticException - When 2 of the supplied points are equal to each other.

Method Detail

getPointA

public CPoint getPointA()

Gets the pointA of this CTriangle.

Returns:

The pointA of this CTriangle.

getPointB

public CPoint getPointB()

Gets the pointB of this CTriangle.

Returns:

The pointB of this CTriangle.

getPointC

public CPoint getPointC()

Gets the pointC of this CTriangle.

Returns:

The pointC of this CTriangle.

getLineAtoB

public CLine getLineAtoB()

Gets the line from point A to point B.

Returns:

The line from point A to point B.

getLineBtoC

public CLine getLineBtoC()

Gets the line from point B to point C.

Returns:

The line from point B to point C.

getLineCtoA

public CLine getLineCtoA()

Gets the line from point C to point A.

Returns:

The line from point C to point A.

getArea

public double getArea()

Gets the area of this CTriangle.
The area is calculated using Heron's formula which states:
A = √(s(s-a)(s-b)(s-c))
Where s = (a + b + c) / 2

Returns:

The area of this CTriangle.

getPerimeter

public double getPerimeter()

Gets the perimeter of this CTriangle.

Returns:

The perimeter of this CTriangle.

isIsosceles

public boolean isIsosceles()

Determines whether this triangle is isosceles, which is the case when two lines of the triangle have equal length.

Returns:

True when isosceles, otherwise false.

isEquilateral

public boolean isEquilateral()

Determines whether this triangle is equilateral, which is the case when all lines of the triangle have equal length.

Returns:

True when isosceles, otherwise false.

toString

public String toString()

Creates a String representation of this CTriangle.
The format of the returned String is: CTriangle:A=(x,y), B=(x,y), C=(x,y)

Overrides:

toString in class Object

Returns:

A String representation of this CTriangle.