org.tinfour.common

Class SimpleTriangle

java.lang.Object

org.tinfour.common.SimpleTriangle

public class SimpleTriangle
extends Object

Provides methods and elements for a simple representation of a triangle based on IQuadEdge edges.

Constructor Summary

Constructors

Constructor and Description
SimpleTriangle(IIncrementalTin tin, IQuadEdge a, IQuadEdge b, IQuadEdge c) Construct a simple triangle from the specified edges.

Method Summary

Modifier and Type	Method and Description
double	getArea() Gets the area of the triangle.
IConstraint	getContainingRegion() Gets the polygon-based constraint that contains this triangle, if any.
IQuadEdge	getEdgeA() Get edge A from the triangle
IQuadEdge	getEdgeB() Get edge B from the triangle
IQuadEdge	getEdgeC() Get edge C from the triangle

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleTriangle

public SimpleTriangle(IIncrementalTin tin,
                      IQuadEdge a,
                      IQuadEdge b,
                      IQuadEdge c)

Construct a simple triangle from the specified edges. For efficiency purposes, this constructor is very lean and does not perform sanity checking on the inputs.

Parameters:

tin - a reference to the TIN that was used to create this triangle.

a - a valid edge

b - a valid edge

c - a valid edge

Method Detail

getEdgeA

public IQuadEdge getEdgeA()

Get edge A from the triangle

Returns:

a valid edge

getEdgeB

public IQuadEdge getEdgeB()

Get edge B from the triangle

Returns:

a valid edge

getEdgeC

public IQuadEdge getEdgeC()

Get edge C from the triangle

Returns:

a valid edge

getArea

public double getArea()

Gets the area of the triangle. This value is positive if the traingle is given in counterclockwise order and negative if it is given in clockwise order. A value of zero indicates a degenerate triangle.

Returns:

a valid floating point number.

getContainingRegion

public IConstraint getContainingRegion()

Gets the polygon-based constraint that contains this triangle, if any.

Under ConstructionThis method is not yet complete. Because the Tinfour implementation does not yet record which side of an edge an region-based constraint lies on, there are cases involving constraint borders that will not be accurately detected. It can only reliably report membership when a triangle has at least one edge that is entirely inside a constraint area

Returns:

if the triangle is enclosed by a constraint, a valid instance; otherwise, a null.