Author: jive
Date: 2009-10-24 23:49:13 -0400 (Sat, 24 Oct 2009)
New Revision: 34226
Modified:
branches/geometry/spike/geometry/src/main/java/org/osgeo/geometry/points/Points.java
Log:
the CRS came back; capture CRS of contained points
Modified: branches/geometry/spike/geometry/src/main/java/org/osgeo/geometry/points/Points.java
===================================================================
--- branches/geometry/spike/geometry/src/main/java/org/osgeo/geometry/points/Points.java 2009-10-25 03:45:08 UTC (rev 34225)
+++ branches/geometry/spike/geometry/src/main/java/org/osgeo/geometry/points/Points.java 2009-10-25 03:49:13 UTC (rev 34226)
@@ -24,9 +24,10 @@
/**
* Abstraction of a sequence of {@link Point} instances.
* <p>
- * The motivation for this interface is to allow more compact and efficient representations than using lists or arrays
- * of {@link Point} objects. This is essential, as geometries are usually build from many points, e.g. a detailed
- * {@link LineString} may consist of tens or hundreds thousands of points.
+ * The motivation for this interface is to allow more compact and efficient representations than
+ * using lists or arrays of {@link Point} objects. This is essential, as geometries are usually
+ * build from many points, e.g. a detailed {@link LineString} may consist of tens or hundreds
+ * thousands of points.
* </p>
*
* @author <a href="mailto:
[hidden email]">Markus Schneider</a>
@@ -37,13 +38,23 @@
public interface Points extends Iterable<Point> {
/**
- * Returns the coordinate dimension, i.e. the dimension of the space that the points are embedded in.
+ * Returns the number of ordinates supplied by each point, this includes both the dimension of
+ * the space that the points are embedded in as defined by the CRS and any measures associated
+ * with the Point.
*
- * @return the coordinate dimension
+ * @return the coordinate dimension; must be equal to or larger then the number of axis defined by the CRS
*/
public int getDimension();
-
+
/**
+ * The CRS used for each Point; this documents the axis order and number of axis that
+ * are considered part of the temporal/spatial definition of the point.
+ *
+ * @return CRS for contained points
+ */
+ public CRS getCRS();
+
+ /**
* Returns the number of represented {@link Point}s.
*
* @return the number of points
@@ -53,13 +64,14 @@
/**
* Returns the {@link Point} at the specified position.
* <p>
- * NOTE: It is generally more expensive to use this method than to access a {@link Point} by iterating over this
- * object, because a new {@link Point} object may have to be created (depending on the implementation).
+ * NOTE: It is generally more expensive to use this method than to access a {@link Point} by
+ * iterating over this object, because a new {@link Point} object may have to be created
+ * (depending on the implementation).
*
* @param i
* @return the point at the specified position
*/
- public Point get( int i );
+ public Point get(int i);
/**
* Returns the first point of the sequence.
@@ -81,7 +93,7 @@
* NOTE: This method should be avoided, as it may involve expensive operations.
* </p>
* <p>
- * This array is returned in the order provided by each Point: p1x,p1y,
+ * This array is returned in the order provided by each Point: p1x,p1y,
*
* @return coordinates as a one-dimensional array
*/
------------------------------------------------------------------------------
Come build with us! The BlackBerry(R) Developer Conference in SF, CA
is the only developer event you need to attend this year. Jumpstart your
developing skills, take BlackBerry mobile applications to market and stay
ahead of the curve. Join us from November 9 - 12, 2009. Register now!
http://p.sf.net/sfu/devconference_______________________________________________
GeoTools-commits mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/geotools-commits
