math.geom2d.point
Class PointArray2D

java.lang.Object
  math.geom2d.point.PointArray2D

All Implemented Interfaces:

Serializable, Cloneable, Iterable<Point2D>, CirculinearShape2D, PointSet2D, PointShape2D, Shape2D

public class PointArray2D
extends Object
implements PointSet2D, CirculinearShape2D, Cloneable

Represent the union of a finite number of Point2D.

Author:

dlegland

See Also:

Serialized Form

Field Summary

protected ArrayList<Point2D>

points The inner collection of points composing the set.

Fields inherited from interface math.geom2d.Shape2D

ACCURACY

Constructor Summary

PointArray2D()
Creates a new PointArray2D without any points.

PointArray2D(Collection<? extends Point2D> points)
Points must be a collection of java.awt.Point.

PointArray2D(int n)
Creates a new empty PointArray2D, but preallocates the memory for storing a given amount of points.

PointArray2D(Point2D[] points)
Instances of Point2D are directly added, other Point are converted to Point2D with the same location.

Method Summary

void	addPoint(Point2D point) Add a new point to the set of point.
void	addPoints(Collection<? extends Point2D> points) Add a series of points
void	addPoints(Point2D[] points) Add a series of points
void	clearPoints() remove all points of the set.
PointArray2D	clip(Box2D box) Returns a new point set containing only points located within the box.
PointArray2D	clone()
boolean	contains(double x, double y) Checks if the shape contains the planar point defined by (x,y).
boolean	contains(Point2D point) Checks if the shape contains the given point.
static PointSet2D	create(Collection<? extends Point2D> points)
static PointSet2D	create(int size)
static PointSet2D	create(Point2D[] points)
void	draw(Graphics2D g2) Draws the point set on the specified Graphics2D, using default radius equal to 1.
void	draw(Graphics2D g2, double r) Draws the point set on the specified Graphics2D, by filling a disc with a given radius.
boolean	equals(Object obj)
Box2D	getBoundingBox() Returns the bounding box of the shape.
CirculinearDomain2D	getBuffer(double dist) Computes the buffer of the shape, formed by the set of points located at a distance from the shape that is lower or equal to d.
double	getDistance(double x, double y) get the distance of the shape to the given point, specified by x and y, or the distance of point to the frontier of the shape in the case of a plain (i.e.
double	getDistance(Point2D p) Return distance to the closest point of the collection
int	getPointNumber() Returns the number of points in the set.
Collection<Point2D>	getPoints() return an iterator on the internal point collection.
boolean	isBounded() always return true.
boolean	isEmpty() Returns true if the shape does not contain any point.
Iterator<Point2D>	iterator()
PointArray2D	transform(AffineTransform2D trans) Transforms the point set by returning a new point set containing each transformed point.
PointArray2D	transform(CircleInversion2D inv) Transforms the shape by a circle inversion.

Methods inherited from class java.lang.Object

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

Field Detail

points

protected ArrayList<Point2D> points

The inner collection of points composing the set.

Constructor Detail

PointArray2D

public PointArray2D()

Creates a new PointArray2D without any points.

PointArray2D

public PointArray2D(int n)

Creates a new empty PointArray2D, but preallocates the memory for storing a given amount of points.

Parameters:

n - the expected number of points in the PointArray2D.

PointArray2D

public PointArray2D(Point2D[] points)

Instances of Point2D are directly added, other Point are converted to Point2D with the same location.

PointArray2D

public PointArray2D(Collection<? extends Point2D> points)

Points must be a collection of java.awt.Point. Instances of Point2D are directly added, other Point are converted to Point2D with the same location.

Parameters:

points -

Method Detail

create

public static final PointSet2D create(Collection<? extends Point2D> points)

create

public static final PointSet2D create(Point2D[] points)

create

public static final PointSet2D create(int size)

addPoint

public void addPoint(Point2D point)

Add a new point to the set of point. If point is not an instance of Point2D, a Point2D with same location is added instead of point.

Specified by:

addPoint in interface PointSet2D

Parameters:

point -

addPoints

public void addPoints(Point2D[] points)

Add a series of points

Parameters:

points - an array of points

addPoints

public void addPoints(Collection<? extends Point2D> points)

Description copied from interface: PointSet2D

Add a series of points

Specified by:

addPoints in interface PointSet2D

Parameters:

points - an array of points

getPoints

public Collection<Point2D> getPoints()

return an iterator on the internal point collection.

Specified by:

getPoints in interface PointSet2D

Specified by:

getPoints in interface PointShape2D

Returns:

the collection of points

clearPoints

public void clearPoints()

remove all points of the set.

getPointNumber

public int getPointNumber()

Returns the number of points in the set.

Specified by:

getPointNumber in interface PointSet2D

Specified by:

getPointNumber in interface PointShape2D

Returns:

the number of points

getBuffer

public CirculinearDomain2D getBuffer(double dist)

Description copied from interface: CirculinearShape2D

Computes the buffer of the shape, formed by the set of points located at a distance from the shape that is lower or equal to d.

Specified by:

getBuffer in interface CirculinearShape2D

Parameters:

dist - the maximal distance between a point of the buffer and the shape

Returns:

the buffer of the shape

transform

public PointArray2D transform(CircleInversion2D inv)

Description copied from interface: CirculinearShape2D

Transforms the shape by a circle inversion. The result is still an instance a CirculinearShape2D.

Specified by:

transform in interface CirculinearShape2D

Parameters:

inv - the circle inversion

Returns:

the transformed shape

getDistance

public double getDistance(Point2D p)

Return distance to the closest point of the collection

Specified by:

getDistance in interface Shape2D

getDistance

public double getDistance(double x,
                          double y)

Description copied from interface: Shape2D

get the distance of the shape to the given point, specified by x and y, or the distance of point to the frontier of the shape in the case of a plain (i.e. fillable) shape.

Specified by:

getDistance in interface Shape2D

isBounded

public boolean isBounded()

always return true.

Specified by:

isBounded in interface Shape2D

isEmpty

public boolean isEmpty()

Description copied from interface: Shape2D

Returns true if the shape does not contain any point. This is the case for example for PointSet2D without any point.

Specified by:

isEmpty in interface Shape2D

Returns:

true if the shape does not contain any point.

clip

public PointArray2D clip(Box2D box)

Description copied from interface: PointSet2D

Returns a new point set containing only points located within the box.

Specified by:

clip in interface PointSet2D

Specified by:

clip in interface PointShape2D

Specified by:

clip in interface Shape2D

Parameters:

box - the clipping box

Returns:

the clipped shape

getBoundingBox

public Box2D getBoundingBox()

Description copied from interface: Shape2D

Returns the bounding box of the shape.

Specified by:

getBoundingBox in interface Shape2D

Returns:

the bounding box of the shape.

transform

public PointArray2D transform(AffineTransform2D trans)

Description copied from interface: PointSet2D

Transforms the point set by returning a new point set containing each transformed point.

Specified by:

transform in interface PointSet2D

Specified by:

transform in interface PointShape2D

Specified by:

transform in interface Shape2D

Parameters:

trans - an affine transform

Returns:

the transformed shape

contains

public boolean contains(double x,
                        double y)

Description copied from interface: Shape2D

Checks if the shape contains the planar point defined by (x,y).

Specified by:

contains in interface Shape2D

contains

public boolean contains(Point2D point)

Description copied from interface: Shape2D

Checks if the shape contains the given point.

Specified by:

contains in interface Shape2D

draw

public void draw(Graphics2D g2)

Draws the point set on the specified Graphics2D, using default radius equal to 1.

Specified by:

draw in interface Shape2D

Parameters:

g2 - the graphics to draw the point set

draw

public void draw(Graphics2D g2,
                 double r)

Draws the point set on the specified Graphics2D, by filling a disc with a given radius.

Parameters:

g2 - the graphics to draw the point set

iterator

public Iterator<Point2D> iterator()

Specified by:

iterator in interface Iterable<Point2D>

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

clone

public PointArray2D clone()

Overrides:

clone in class Object