fr.lri.swingstates.gestures

Class GestureUtils

java.lang.Object

fr.lri.swingstates.gestures.GestureUtils

public class GestureUtils
extends java.lang.Object

A class containing utility methods for sets of points.

Author:

Caroline Appert

Constructor Summary

Constructors

Constructor and Description
GestureUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static CPolyLine	asPolyLine(java.util.Vector<java.awt.geom.Point2D> points)
static java.awt.geom.Rectangle2D	boundingBox(java.util.Vector<java.awt.geom.Point2D> points)
static java.awt.geom.Point2D	centroid(java.util.Vector<java.awt.geom.Point2D> points)
static double	distanceAtBestAngle(java.util.Vector<java.awt.geom.Point2D> points, java.util.Vector<java.awt.geom.Point2D> gesturePoints, double thetaA, double thetaB, double deltaTheta)
static double	pathDistance(java.util.Vector<java.awt.geom.Point2D> pointsA, java.util.Vector<java.awt.geom.Point2D> pointsB)
static double	pathLength(java.util.Vector<java.awt.geom.Point2D> points)
static void	resample(java.util.Vector<java.awt.geom.Point2D> points, int n, java.util.Vector<java.awt.geom.Point2D> newPoints)
static void	rotateBy(java.util.Vector<java.awt.geom.Point2D> points, double theta, java.util.Vector<java.awt.geom.Point2D> newPoints)
static void	rotateToZero(java.util.Vector<java.awt.geom.Point2D> points, java.util.Vector<java.awt.geom.Point2D> newPoints)
static void	scaleToSquare(java.util.Vector<java.awt.geom.Point2D> points, double size, java.util.Vector<java.awt.geom.Point2D> newPoints)
static CShape	showArrowPreview(Canvas canvas, CPolyLine polyline, int x, int y, int sizeBoundingBox, int sizeSpan, double sizeStartPoint) Displays a polyline of a gesture example in a bounding box in a SwingStates Canvas.
static CShape	showPreview(Canvas canvas, CPolyLine polyline, int x, int y, int sizeBoundingBox, int sizeSpan, double sizeStartPoint) Displays a polyline of a gesture example in a bounding box in a SwingStates Canvas.
static void	translateToOrigin(java.util.Vector<java.awt.geom.Point2D> points, java.util.Vector<java.awt.geom.Point2D> newPoints)

Methods inherited from class java.lang.Object

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

Constructor Detail

GestureUtils

public GestureUtils()

Method Detail

pathLength

public static double pathLength(java.util.Vector<java.awt.geom.Point2D> points)

resample

public static void resample(java.util.Vector<java.awt.geom.Point2D> points,
            int n,
            java.util.Vector<java.awt.geom.Point2D> newPoints)

centroid

public static java.awt.geom.Point2D centroid(java.util.Vector<java.awt.geom.Point2D> points)

rotateToZero

public static void rotateToZero(java.util.Vector<java.awt.geom.Point2D> points,
                java.util.Vector<java.awt.geom.Point2D> newPoints)

rotateBy

public static void rotateBy(java.util.Vector<java.awt.geom.Point2D> points,
            double theta,
            java.util.Vector<java.awt.geom.Point2D> newPoints)

Parameters:

points - the points to rotate

theta - the angle in radians

newPoints - the points where to store rotated points

boundingBox

public static java.awt.geom.Rectangle2D boundingBox(java.util.Vector<java.awt.geom.Point2D> points)

scaleToSquare

public static void scaleToSquare(java.util.Vector<java.awt.geom.Point2D> points,
                 double size,
                 java.util.Vector<java.awt.geom.Point2D> newPoints)

translateToOrigin

public static void translateToOrigin(java.util.Vector<java.awt.geom.Point2D> points,
                     java.util.Vector<java.awt.geom.Point2D> newPoints)

distanceAtBestAngle

public static double distanceAtBestAngle(java.util.Vector<java.awt.geom.Point2D> points,
                         java.util.Vector<java.awt.geom.Point2D> gesturePoints,
                         double thetaA,
                         double thetaB,
                         double deltaTheta)

pathDistance

public static double pathDistance(java.util.Vector<java.awt.geom.Point2D> pointsA,
                  java.util.Vector<java.awt.geom.Point2D> pointsB)

asPolyLine

public static CPolyLine asPolyLine(java.util.Vector<java.awt.geom.Point2D> points)

Parameters:

points - The vector of points.

Returns:

a graphical representation of a vector of points as a CPolyLine.

showArrowPreview

public static CShape showArrowPreview(Canvas canvas,
                      CPolyLine polyline,
                      int x,
                      int y,
                      int sizeBoundingBox,
                      int sizeSpan,
                      double sizeStartPoint)

Displays a polyline of a gesture example in a bounding box in a SwingStates Canvas. The gesture is displayed with a red circle at its start point and an orange arrow head at its end point.

Parameters:

canvas - The SwingStates Canvas.

polyline - The polyline of gesture example.

x - The x-coordinate of the bounding box upper left corner in canvas coordinate system.

y - The y-coordinate of the bounding box upper left corner in canvas coordinate system.

sizeBoundingBox - The size of the bounding box side of this gesture example.

sizeSpan - The blank space between bounding box and this gesture.

sizeStartPoint - The size of the red starting circle.

Returns:

the polyline for this gesture example that has been added to the canvas.

showPreview

public static CShape showPreview(Canvas canvas,
                 CPolyLine polyline,
                 int x,
                 int y,
                 int sizeBoundingBox,
                 int sizeSpan,
                 double sizeStartPoint)

Displays a polyline of a gesture example in a bounding box in a SwingStates Canvas. The gesture is displayed with a red circle at its start point.

Parameters:

canvas - The SwingStates Canvas.

polyline - The polyline of gesture example.

x - The x-coordinate of the bounding box upper left corner in canvas coordinate system.

y - The y-coordinate of the bounding box upper left corner in canvas coordinate system.

sizeBoundingBox - The size of the bounding box side of this gesture example.

sizeSpan - The blank space between bounding box and this gesture.

sizeStartPoint - The size of the red starting circle.

Returns:

the polyline for this gesture example that has been added to the canvas.