/*
* The JTS Topology Suite is a collection of Java classes that
* implement the fundamental operations required to validate a given
* geo-spatial data set to a known topological specification.
*
* Copyright (C) 2001 Vivid Solutions
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
* For more information, contact:
*
* Vivid Solutions
* Suite #1A
* 2328 Government Street
* Victoria BC V8T 5G5
* Canada
*
* (250)385-6040
* www.vividsolutions.com
*/
package com.revolsys.geometry.shape.random;
import com.revolsys.geometry.algorithm.locate.IndexedPointInAreaLocator;
import com.revolsys.geometry.algorithm.locate.PointOnGeometryLocator;
import com.revolsys.geometry.model.BoundingBox;
import com.revolsys.geometry.model.Geometry;
import com.revolsys.geometry.model.GeometryFactory;
import com.revolsys.geometry.model.Location;
import com.revolsys.geometry.model.Point;
import com.revolsys.geometry.model.Polygonal;
import com.revolsys.geometry.shape.GeometricShapeBuilder;
/**
* Creates random point sets contained in a
* region defined by either a rectangular or a polygonal extent.
*
* @author mbdavis
*
*/
public class RandomPointsBuilder extends GeometricShapeBuilder {
private PointOnGeometryLocator extentLocator;
protected Geometry maskPoly = null;
/**
* Construct a new shape factory which will create shapes using the default
* {@link GeometryFactory}.
*/
public RandomPointsBuilder() {
super(GeometryFactory.DEFAULT_3D);
}
/**
* Construct a new shape factory which will create shapes using the given
* {@link GeometryFactory}.
*
* @param geomFact the factory to use
*/
public RandomPointsBuilder(final GeometryFactory geomFact) {
super(geomFact);
}
@Override
public Geometry getGeometry() {
final Point[] pts = new Point[this.numPts];
int i = 0;
while (i < this.numPts) {
final Point p = newRandomPoint(getExtent());
if (this.extentLocator != null && !isInExtent(p)) {
continue;
}
pts[i++] = p;
}
return this.geometryFactory.punctual(pts);
}
protected boolean isInExtent(final Point p) {
if (this.extentLocator != null) {
return this.extentLocator.locate(p) != Location.EXTERIOR;
}
return getExtent().covers(p);
}
@Override
protected Point newPoint(final double x, final double y) {
return this.geometryFactory.point(x, y);
}
protected Point newRandomPoint(final BoundingBox env) {
final double x = env.getMinX() + env.getWidth() * Math.random();
final double y = env.getMinY() + env.getHeight() * Math.random();
return newPoint(x, y);
}
/**
* Sets a polygonal mask.
*
* @param mask
* @throws IllegalArgumentException if the mask is not polygonal
*/
public void setExtent(final Geometry mask) {
if (!(mask instanceof Polygonal)) {
throw new IllegalArgumentException("Only polygonal extents are supported");
}
this.maskPoly = mask;
setExtent(mask.getBoundingBox());
this.extentLocator = new IndexedPointInAreaLocator(mask);
}
}