FileDocCategorySizeDatePackage
LineIterator.javaAPI DocJava SE 5 API3589Fri Aug 26 14:56:52 BST 2005java.awt.geom

LineIterator

public class LineIterator extends Object implements PathIterator
A utility class to iterate over the path segments of a line segment through the PathIterator interface.
version
1.10, 12/19/03
author
Jim Graham

Fields Summary
Line2D
line
AffineTransform
affine
int
index
Constructors Summary
LineIterator(Line2D l, AffineTransform at)

	this.line = l;
	this.affine = at;
    
Methods Summary
public intcurrentSegment(float[] coords)
Returns the coordinates and type of the current path segment in the iteration. The return value is the path segment type: SEG_MOVETO, SEG_LINETO, SEG_QUADTO, SEG_CUBICTO, or SEG_CLOSE. A float array of length 6 must be passed in and may be used to store the coordinates of the point(s). Each point is stored as a pair of float x,y coordinates. SEG_MOVETO and SEG_LINETO types will return one point, SEG_QUADTO will return two points, SEG_CUBICTO will return 3 points and SEG_CLOSE will not return any points.

see
#SEG_MOVETO
see
#SEG_LINETO
see
#SEG_QUADTO
see
#SEG_CUBICTO
see
#SEG_CLOSE

	if (isDone()) {
	    throw new NoSuchElementException("line iterator out of bounds");
	}
	int type;
	if (index == 0) {
	    coords[0] = (float) line.getX1();
	    coords[1] = (float) line.getY1();
	    type = SEG_MOVETO;
	} else {
	    coords[0] = (float) line.getX2();
	    coords[1] = (float) line.getY2();
	    type = SEG_LINETO;
	}
	if (affine != null) {
	    affine.transform(coords, 0, coords, 0, 1);
	}
	return type;
    
public intcurrentSegment(double[] coords)
Returns the coordinates and type of the current path segment in the iteration. The return value is the path segment type: SEG_MOVETO, SEG_LINETO, SEG_QUADTO, SEG_CUBICTO, or SEG_CLOSE. A double array of length 6 must be passed in and may be used to store the coordinates of the point(s). Each point is stored as a pair of double x,y coordinates. SEG_MOVETO and SEG_LINETO types will return one point, SEG_QUADTO will return two points, SEG_CUBICTO will return 3 points and SEG_CLOSE will not return any points.

see
#SEG_MOVETO
see
#SEG_LINETO
see
#SEG_QUADTO
see
#SEG_CUBICTO
see
#SEG_CLOSE

	if (isDone()) {
	    throw new NoSuchElementException("line iterator out of bounds");
	}
	int type;
	if (index == 0) {
	    coords[0] = line.getX1();
	    coords[1] = line.getY1();
	    type = SEG_MOVETO;
	} else {
	    coords[0] = line.getX2();
	    coords[1] = line.getY2();
	    type = SEG_LINETO;
	}
	if (affine != null) {
	    affine.transform(coords, 0, coords, 0, 1);
	}
	return type;
    
public intgetWindingRule()
Return the winding rule for determining the insideness of the path.

see
#WIND_EVEN_ODD
see
#WIND_NON_ZERO

	return WIND_NON_ZERO;
    
public booleanisDone()
Tests if there are more points to read.

return
true if there are more points to read

	return (index > 1);
    
public voidnext()
Moves the iterator to the next segment of the path forwards along the primary direction of traversal as long as there are more points in that direction.

	index++;