jdsl.geomobj.api
Interface ThreeArgsGeomTests2D

All Known Subinterfaces:
GeomTester2D
All Known Implementing Classes:
IntRatRatGeomTests2D, IntIntIntGeomTests2D, RatRatRatGeomTests2D, RatIntIntGeomTests2D, IntIntRatGeomTests2D, RatIntRatGeomTests2D

public interface ThreeArgsGeomTests2D

A collection of geometric tests taking three arguments. The parameters of the methods are interfaces.

Version:
$Id: ThreeArgsGeomTests2D.java,v 1.2 2000/04/03 18:00:51 lv Exp $
Author:
Luca Vismara (lv)

Method Summary
 int compareDistances(Point2D q, Point2D p1, Point2D p2)
           
 int leftRightTurn(Point2D p1, Point2D q, Point2D p2)
           
 

Method Detail

leftRightTurn

public int leftRightTurn(Point2D p1,
                         Point2D q,
                         Point2D p2)
                  throws InvalidPointException
Parameters:
p1 - a point
q - a point
p2 - a point
Returns:
whether (p1,q,p2) form a GeomTester2D.LEFT_TURN, are GeomTester2D.COLLINEAR, or form a GeomTester2D.RIGHT_TURN
Throws:
InvalidPointException - if either p1, or q, or p2 is Point2D.INFINITE

compareDistances

public int compareDistances(Point2D q,
                            Point2D p1,
                            Point2D p2)
                     throws InvalidPointException
Parameters:
q - a point
p1 - a point
p2 - a point
Returns:
whether the distance between q and p1 is GeomTester2D.LESSER than, GeomTester2D.EQUAL to, or GeomTester2D.GREATER than the distance between q and p2
Throws:
InvalidPointException - if q is Point2D.INFINITE