org.gvsig.fmap.geom.generalpath.gputils

Class DefaultGeneralPathX

java.lang.Object

org.gvsig.fmap.geom.primitive.GeneralPathX

org.gvsig.fmap.geom.generalpath.gputils.DefaultGeneralPathX

All Implemented Interfaces:

Shape, Serializable, Cloneable, IGeneralPathX

Deprecated.

use the geometry methods

public class DefaultGeneralPathX
extends GeneralPathX
implements Shape, Cloneable, Serializable

The GeneralPathX class represents a geometric path constructed from straight lines, and quadratic and cubic (Bézier) curves. It can contain multiple subpaths.

The winding rule specifies how the interior of a path is determined. There are two types of winding rules: EVEN_ODD and NON_ZERO.

An EVEN_ODD winding rule means that enclosed regions of the path alternate between interior and exterior areas as traversed from the outside of the path towards a point inside the region.

A NON_ZERO winding rule means that if a ray is drawn in any direction from a given point to infinity and the places where the path intersects the ray are examined, the point is inside of the path if and only if the number of times that the path crosses the ray from left to right does not equal the number of times that the path crosses the ray from right to left.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected static GeometryManager	geomManager Deprecated.

Fields inherited from class org.gvsig.fmap.geom.primitive.GeneralPathX

INIT_SIZE

Fields inherited from interface org.gvsig.fmap.geom.primitive.IGeneralPathX

curvesize, SEG_CLOSE, SEG_CUBICTO, SEG_LINETO, SEG_MOVETO, SEG_QUADTO, WIND_EVEN_ODD, WIND_NON_ZERO

Constructor Summary

Constructors

Constructor and Description
DefaultGeneralPathX(int rule) Deprecated. Constructs a new GeneralPathX object with the specified winding rule to control operations that require the interior of the path to be defined.
DefaultGeneralPathX(PathIterator piter) Deprecated. Constructs a new GeneralPathX object from an arbitrary Shape object.

Method Summary

Modifier and Type	Method and Description
void	addSegment(Point[] segment) Deprecated.
void	append(GeneralPathX gp) Deprecated.
void	append(PathIterator pi, boolean connect) Deprecated. Appends the geometry of the specified PathIterator object to the path, possibly connecting the new geometry to the existing path segments with a line segment.
Object	clone() Deprecated. Creates a new object of the same class as this object.
void	closePath() Deprecated. Closes the current subpath by drawing a straight line back to the coordinates of the last moveTo.
boolean	contains(double x, double y) Deprecated. Tests if the specified coordinates are inside the boundary of this Shape.
boolean	contains(double x, double y, double w, double h) Deprecated. Tests if the specified rectangular area is inside the boundary of this Shape.
boolean	contains(Point2D p) Deprecated. Tests if the specified Point2D is inside the boundary of this Shape.
boolean	contains(Rectangle2D r) Deprecated. Tests if the specified Rectangle2D is inside the boundary of this Shape.
Shape	createTransformedShape(AffineTransform at) Deprecated. Returns a new transformed Shape.
void	curveTo(double x1, double y1, double x2, double y2, double x3, double y3) Deprecated. use curveTo(Point, Point, Point)
void	curveTo(Point point1, Point point2, Point point3) Deprecated.
void	ensureCapacity(int capacity) Deprecated.
void	flip() Deprecated. Convertimos el path a puntos y luego le damos la vuelta.
double[]	get3DCoordinatesAt(int index) Deprecated.
Rectangle	getBounds() Deprecated. Return the bounding box of the path.
Rectangle2D	getBounds2D() Deprecated. Returns the bounding box of the path.
double[]	getCoordinatesAt(int index) Deprecated.
Point2D	getCurrentPoint() Deprecated. Returns the coordinates most recently added to the end of the path as a Point2D object.
int	getNumCoords() Deprecated.
int	getNumTypes() Deprecated.
PathIterator	getPathIterator(AffineTransform at) Deprecated. Returns a PathIterator object that iterates along the boundary of this Shape and provides access to the geometry of the outline of this Shape.
PathIterator	getPathIterator(AffineTransform at, double flatness) Deprecated. Returns a PathIterator object that iterates along the boundary of the flattened Shape and provides access to the geometry of the outline of the Shape.
Point	getPointAt(int index) Deprecated.
double[]	getPointCoords() Deprecated. use the geometry methods.
byte[]	getPointTypes() Deprecated. use the geometry methods.
byte	getTypeAt(int index) Deprecated.
int	getWindingRule() Deprecated. Returns the fill style winding rule.
boolean	intersects(double x, double y, double w, double h) Deprecated. Tests if the interior of this Shape intersects the interior of a specified set of rectangular coordinates.
boolean	intersects(Rectangle2D r) Deprecated. Tests if the interior of this Shape intersects the interior of a specified Rectangle2D.
boolean	isCCW() Deprecated. Check if the first part is CCW.
boolean	isClosed() Deprecated. Check if the first part is closed.
boolean	isSimple() Deprecated.
void	lineTo(double x, double y) Deprecated. use lineTo(Point)
void	lineTo(Point point) Deprecated.
void	moveTo(double x, double y) Deprecated. use moveTo(Point)
void	moveTo(Point point) Deprecated.
void	quadTo(double x1, double y1, double x2, double y2) Deprecated. use quadTo(Point, Point)
void	quadTo(Point point1, Point point2) Deprecated.
void	reProject(ICoordTrans ct) Deprecated.
void	reset() Deprecated. Resets the path to empty.
int	setNumCoords(int numCoords) Deprecated.
void	setNumTypes(int numTypes) Deprecated.
void	setPointCoords(double[] pointCoords) Deprecated. use the geometry methods.
void	setPointTypes(byte[] pointTypes) Deprecated. use the geometry methods.
void	setWindingRule(int rule) Deprecated. Sets the winding rule for this path to the specified value.
void	transform(AffineTransform at) Deprecated. Transforms the geometry of this path using the specified AffineTransform.

Methods inherited from class java.lang.Object

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

Field Detail

geomManager

protected static GeometryManager geomManager

Deprecated.

Constructor Detail

DefaultGeneralPathX

public DefaultGeneralPathX(int rule)

Deprecated.

Constructs a new GeneralPathX object with the specified winding rule to control operations that require the interior of the path to be defined.

Parameters:

rule - the winding rule

See Also:

IGeneralPathX.WIND_EVEN_ODD, IGeneralPathX.WIND_NON_ZERO

DefaultGeneralPathX

public DefaultGeneralPathX(PathIterator piter)

Deprecated.

Constructs a new GeneralPathX object from an arbitrary Shape object. All of the initial geometry and the winding rule for this path are taken from the specified Shape object.

Parameters:

s - the specified Shape object

Method Detail

moveTo

public void moveTo(double x,
                   double y)

Deprecated. use moveTo(Point)

Adds a point to the path by moving to the specified coordinates.

Specified by:

moveTo in interface IGeneralPathX

Overrides:

moveTo in class GeneralPathX

Parameters:

x - , y the specified coordinates

moveTo

public void moveTo(Point point)

Deprecated.

Specified by:

moveTo in interface IGeneralPathX

Overrides:

moveTo in class GeneralPathX

lineTo

public void lineTo(double x,
                   double y)

Deprecated. use lineTo(Point)

Adds a point to the path by drawing a straight line from the current coordinates to the new specified coordinates.

Specified by:

lineTo in interface IGeneralPathX

Overrides:

lineTo in class GeneralPathX

Parameters:

x - , y the specified coordinates

lineTo

public void lineTo(Point point)

Deprecated.

Specified by:

lineTo in interface IGeneralPathX

Overrides:

lineTo in class GeneralPathX

addSegment

public void addSegment(Point[] segment)

Deprecated.

Specified by:

addSegment in interface IGeneralPathX

Overrides:

addSegment in class GeneralPathX

quadTo

public void quadTo(double x1,
                   double y1,
                   double x2,
                   double y2)

Deprecated. use quadTo(Point, Point)

Adds a curved segment, defined by two new points, to the path by drawing a Quadratic curve that intersects both the current coordinates and the coordinates (x2, y2), using the specified point (x1, y1) as a quadratic parametric control point.

Specified by:

quadTo in interface IGeneralPathX

Overrides:

quadTo in class GeneralPathX

Parameters:

x1 - , y1 the coordinates of the first quadratic control point

x2 - , y2 the coordinates of the final endpoint

quadTo

public void quadTo(Point point1,
                   Point point2)

Deprecated.

Specified by:

quadTo in interface IGeneralPathX

Overrides:

quadTo in class GeneralPathX

curveTo

public void curveTo(double x1,
                    double y1,
                    double x2,
                    double y2,
                    double x3,
                    double y3)

Deprecated. use curveTo(Point, Point, Point)

Adds a curved segment, defined by three new points, to the path by drawing a Bézier curve that intersects both the current coordinates and the coordinates (x3, y3), using the specified points (x1, y1) and (x2, y2) as Bézier control points.

Specified by:

curveTo in interface IGeneralPathX

Overrides:

curveTo in class GeneralPathX

Parameters:

x1 - , y1 the coordinates of the first Béezier control point

x2 - , y2 the coordinates of the second Bézier control point

x3 - , y3 the coordinates of the final endpoint

curveTo

public void curveTo(Point point1,
                    Point point2,
                    Point point3)

Deprecated.

Specified by:

curveTo in interface IGeneralPathX

Overrides:

curveTo in class GeneralPathX

closePath

public void closePath()

Deprecated.

Closes the current subpath by drawing a straight line back to the coordinates of the last moveTo. If the path is already closed then this method has no effect.

Specified by:

closePath in interface IGeneralPathX

Overrides:

closePath in class GeneralPathX

isClosed

public boolean isClosed()

Deprecated.

Check if the first part is closed.

Specified by:

isClosed in interface IGeneralPathX

Overrides:

isClosed in class GeneralPathX

Returns:

append

public void append(PathIterator pi,
                   boolean connect)

Deprecated.

Appends the geometry of the specified PathIterator object to the path, possibly connecting the new geometry to the existing path segments with a line segment. If the connect parameter is true and the path is not empty then any initial moveTo in the geometry of the appended Shape is turned into a lineTo segment. If the destination coordinates of such a connecting lineTo segment match the ending coordinates of a currently open subpath then the segment is omitted as superfluous. The winding rule of the specified Shape is ignored and the appended geometry is governed by the winding rule specified for this path.

Specified by:

append in interface IGeneralPathX

Overrides:

append in class GeneralPathX

Parameters:

pi - the PathIterator whose geometry is appended to this path

connect - a boolean to control whether or not to turn an initial moveTo segment into a lineTo segment to connect the new geometry to the existing path

append

public void append(GeneralPathX gp)

Deprecated.

Specified by:

append in interface IGeneralPathX

Overrides:

append in class GeneralPathX

getWindingRule

public int getWindingRule()

Deprecated.

Returns the fill style winding rule.

Specified by:

getWindingRule in interface IGeneralPathX

Overrides:

getWindingRule in class GeneralPathX

Returns:

an integer representing the current winding rule.

See Also:

IGeneralPathX.WIND_EVEN_ODD, IGeneralPathX.WIND_NON_ZERO, setWindingRule(int)

setWindingRule

public void setWindingRule(int rule)

Deprecated.

Sets the winding rule for this path to the specified value.

Specified by:

setWindingRule in interface IGeneralPathX

Overrides:

setWindingRule in class GeneralPathX

Parameters:

rule - an integer representing the specified winding rule

Throws:

IllegalArgumentException - if rule is not either WIND_EVEN_ODD or WIND_NON_ZERO

See Also:

IGeneralPathX.WIND_EVEN_ODD, IGeneralPathX.WIND_NON_ZERO, getWindingRule()

getCurrentPoint

public Point2D getCurrentPoint()

Deprecated.

Returns the coordinates most recently added to the end of the path as a Point2D object.

Specified by:

getCurrentPoint in interface IGeneralPathX

Overrides:

getCurrentPoint in class GeneralPathX

Returns:

a Point2D object containing the ending coordinates of the path or null if there are no points in the path.

reset

public void reset()

Deprecated.

Resets the path to empty. The append position is set back to the beginning of the path and all coordinates and point types are forgotten.

Specified by:

reset in interface IGeneralPathX

Overrides:

reset in class GeneralPathX

transform

public void transform(AffineTransform at)

Deprecated.

Transforms the geometry of this path using the specified AffineTransform. The geometry is transformed in place, which permanently changes the boundary defined by this object.

Specified by:

transform in interface IGeneralPathX

Overrides:

transform in class GeneralPathX

Parameters:

at - the AffineTransform used to transform the area

reProject

public void reProject(ICoordTrans ct)

Deprecated.

Specified by:

reProject in interface IGeneralPathX

Overrides:

reProject in class GeneralPathX

createTransformedShape

public Shape createTransformedShape(AffineTransform at)

Deprecated.

Returns a new transformed Shape.

Specified by:

createTransformedShape in interface IGeneralPathX

Overrides:

createTransformedShape in class GeneralPathX

Parameters:

at - the AffineTransform used to transform a new Shape.

Returns:

a new Shape, transformed with the specified AffineTransform.

getBounds

public Rectangle getBounds()

Deprecated.

Return the bounding box of the path.

Specified by:

getBounds in interface Shape

Specified by:

getBounds in interface IGeneralPathX

Overrides:

getBounds in class GeneralPathX

Returns:

a Rectangle object that bounds the current path.

getBounds2D

public Rectangle2D getBounds2D()

Deprecated.

Returns the bounding box of the path.

Specified by:

getBounds2D in interface Shape

Specified by:

getBounds2D in interface IGeneralPathX

Overrides:

getBounds2D in class GeneralPathX

Returns:

a Rectangle2D object that bounds the current path.

contains

public boolean contains(double x,
                        double y)

Deprecated.

Tests if the specified coordinates are inside the boundary of this Shape.

Specified by:

contains in interface Shape

Specified by:

contains in interface IGeneralPathX

Overrides:

contains in class GeneralPathX

Parameters:

x - , y the specified coordinates

Returns:

true if the specified coordinates are inside this Shape; false otherwise

contains

public boolean contains(Point2D p)

Deprecated.

Tests if the specified Point2D is inside the boundary of this Shape.

Specified by:

contains in interface Shape

Specified by:

contains in interface IGeneralPathX

Overrides:

contains in class GeneralPathX

Parameters:

p - the specified Point2D

Returns:

true if this Shape contains the specified Point2D, false otherwise.

contains

public boolean contains(double x,
                        double y,
                        double w,
                        double h)

Deprecated.

Tests if the specified rectangular area is inside the boundary of this Shape.

Specified by:

contains in interface Shape

Specified by:

contains in interface IGeneralPathX

Overrides:

contains in class GeneralPathX

Parameters:

x - , y the specified coordinates

w - the width of the specified rectangular area

h - the height of the specified rectangular area

Returns:

true if this Shape contains the specified rectangluar area; false otherwise.

contains

public boolean contains(Rectangle2D r)

Deprecated.

Tests if the specified Rectangle2D is inside the boundary of this Shape.

Specified by:

contains in interface Shape

Specified by:

contains in interface IGeneralPathX

Overrides:

contains in class GeneralPathX

Parameters:

r - a specified Rectangle2D

Returns:

true if this Shape bounds the specified Rectangle2D; false otherwise.

intersects

public boolean intersects(double x,
                          double y,
                          double w,
                          double h)

Deprecated.

Tests if the interior of this Shape intersects the interior of a specified set of rectangular coordinates.

Specified by:

intersects in interface Shape

Specified by:

intersects in interface IGeneralPathX

Overrides:

intersects in class GeneralPathX

Parameters:

x - , y the specified coordinates

w - the width of the specified rectangular coordinates

h - the height of the specified rectangular coordinates

Returns:

true if this Shape and the interior of the specified set of rectangular coordinates intersect each other; false otherwise.

intersects

public boolean intersects(Rectangle2D r)

Deprecated.

Tests if the interior of this Shape intersects the interior of a specified Rectangle2D.

Specified by:

intersects in interface Shape

Specified by:

intersects in interface IGeneralPathX

Overrides:

intersects in class GeneralPathX

Parameters:

r - the specified Rectangle2D

Returns:

true if this Shape and the interior of the specified Rectangle2D intersect each other; false otherwise.

getPathIterator

public PathIterator getPathIterator(AffineTransform at)

Deprecated.

Returns a PathIterator object that iterates along the boundary of this Shape and provides access to the geometry of the outline of this Shape. The iterator for this class is not multi-threaded safe, which means that this GeneralPathX class does not guarantee that modifications to the geometry of this GeneralPathX object do not affect any iterations of that geometry that are already in process.

Specified by:

getPathIterator in interface Shape

Specified by:

getPathIterator in interface IGeneralPathX

Overrides:

getPathIterator in class GeneralPathX

Parameters:

at - an AffineTransform

Returns:

a new PathIterator that iterates along the boundary of this Shape and provides access to the geometry of this Shape's outline

getPathIterator

public PathIterator getPathIterator(AffineTransform at,
                                    double flatness)

Deprecated.

Returns a PathIterator object that iterates along the boundary of the flattened Shape and provides access to the geometry of the outline of the Shape. The iterator for this class is not multi-threaded safe, which means that this GeneralPathX class does not guarantee that modifications to the geometry of this GeneralPathX object do not affect any iterations of that geometry that are already in process.

Specified by:

getPathIterator in interface Shape

Specified by:

getPathIterator in interface IGeneralPathX

Overrides:

getPathIterator in class GeneralPathX

Parameters:

at - an AffineTransform

flatness - the maximum distance that the line segments used to approximate the curved segments are allowed to deviate from any point on the original curve

Returns:

a new PathIterator that iterates along the flattened Shape boundary.

clone

public Object clone()

Deprecated.

Creates a new object of the same class as this object.

Specified by:

clone in interface IGeneralPathX

Overrides:

clone in class GeneralPathX

Returns:

a clone of this instance.

Throws:

OutOfMemoryError - if there is not enough memory.

Since:

1.2

See Also:

Cloneable

setNumTypes

public void setNumTypes(int numTypes)

Deprecated.

Specified by:

setNumTypes in interface IGeneralPathX

Overrides:

setNumTypes in class GeneralPathX

getNumTypes

public int getNumTypes()

Deprecated.

Specified by:

getNumTypes in interface IGeneralPathX

Overrides:

getNumTypes in class GeneralPathX

setNumCoords

public int setNumCoords(int numCoords)

Deprecated.

Specified by:

setNumCoords in interface IGeneralPathX

Overrides:

setNumCoords in class GeneralPathX

getNumCoords

public int getNumCoords()

Deprecated.

Specified by:

getNumCoords in interface IGeneralPathX

Overrides:

getNumCoords in class GeneralPathX

getTypeAt

public byte getTypeAt(int index)

Deprecated.

Specified by:

getTypeAt in interface IGeneralPathX

Overrides:

getTypeAt in class GeneralPathX

setPointTypes

public void setPointTypes(byte[] pointTypes)

Deprecated. use the geometry methods.

Specified by:

setPointTypes in interface IGeneralPathX

Overrides:

setPointTypes in class GeneralPathX

getPointTypes

public byte[] getPointTypes()

Deprecated. use the geometry methods.

Specified by:

getPointTypes in interface IGeneralPathX

Overrides:

getPointTypes in class GeneralPathX

setPointCoords

public void setPointCoords(double[] pointCoords)

Deprecated. use the geometry methods.

Specified by:

setPointCoords in interface IGeneralPathX

Overrides:

setPointCoords in class GeneralPathX

Parameters:

pointCoords -

getPointCoords

public double[] getPointCoords()

Deprecated. use the geometry methods.

Specified by:

getPointCoords in interface IGeneralPathX

Overrides:

getPointCoords in class GeneralPathX

getPointAt

public Point getPointAt(int index)

Deprecated.

Specified by:

getPointAt in interface IGeneralPathX

Overrides:

getPointAt in class GeneralPathX

getCoordinatesAt

public double[] getCoordinatesAt(int index)

Deprecated.

Specified by:

getCoordinatesAt in interface IGeneralPathX

Overrides:

getCoordinatesAt in class GeneralPathX

get3DCoordinatesAt

public double[] get3DCoordinatesAt(int index)

Deprecated.

Specified by:

get3DCoordinatesAt in interface IGeneralPathX

Overrides:

get3DCoordinatesAt in class GeneralPathX

flip

public void flip()

Deprecated.

Convertimos el path a puntos y luego le damos la vuelta.

Specified by:

flip in interface IGeneralPathX

Overrides:

flip in class GeneralPathX

isCCW

public boolean isCCW()

Deprecated.

Check if the first part is CCW.

Specified by:

isCCW in interface IGeneralPathX

Overrides:

isCCW in class GeneralPathX

Returns:

isSimple

public boolean isSimple()

Deprecated.

Specified by:

isSimple in interface IGeneralPathX

Overrides:

isSimple in class GeneralPathX

Returns:

the isSimple

ensureCapacity

public void ensureCapacity(int capacity)

Deprecated.